python · colesbury · Aug 1, 2024 · Aug 1, 2024 · Sep 2, 2024 · picnixz
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
@@ -587,6 +587,9 @@ always available.
      * - .. attribute:: flags.warn_default_encoding
        - :option:`-X warn_default_encoding <-X>`

+      * - .. attribute:: flags.gil
+        - :option:`-X gil <-X>`
+
   .. versionchanged:: 3.2
      Added ``quiet`` attribute for the new :option:`-q` flag.

@@ -613,6 +616,9 @@ always available.
   .. versionchanged:: 3.11
      Added the ``int_max_str_digits`` attribute.

+   .. versionchanged:: 3.13
+      Added the ``gil`` attribute.
+

 .. data:: float_info


diff --git a/Lib/test/test_sys.py b/Lib/test/test_sys.py
@@ -803,11 +803,17 @@ def test_sys_flags(self):
                 "dont_write_bytecode", "no_user_site", "no_site",
                 "ignore_environment", "verbose", "bytes_warning", "quiet",
                 "hash_randomization", "isolated", "dev_mode", "utf8_mode",
-                 "warn_default_encoding", "safe_path", "int_max_str_digits")
+                 "warn_default_encoding", "safe_path", "int_max_str_digits",
+                 "gil")
+        attr_types = {
+            "dev_mode": bool,
+            "safe_path": bool,
+            "gil": (int, type(None)),
+        }
        for attr in attrs:
            self.assertTrue(hasattr(sys.flags, attr), attr)
-            attr_type = bool if attr in ("dev_mode", "safe_path") else int
-            self.assertEqual(type(getattr(sys.flags, attr)), attr_type, attr)
+            expected_type = attr_types.get(attr, int)
+            self.assertIsInstance(getattr(sys.flags, attr), expected_type, attr)
        self.assertTrue(repr(sys.flags))
        self.assertEqual(len(sys.flags), len(attrs))


diff --git a/Misc/NEWS.d/next/Core_and_Builtins/2024-08-01-18-35-54.gh-issue-122575.JTvKx9.rst b/Misc/NEWS.d/next/Core_and_Builtins/2024-08-01-18-35-54.gh-issue-122575.JTvKx9.rst
@@ -0,0 +1,2 @@
+Include :attr:`sys.flags.gil` as part of the sequence when :data:`sys.flags`
+is treated as a tuple.
@@ -3124,7 +3124,7 @@ static PyStructSequence_Desc flags_desc = {
    "sys.flags",        /* name */
    flags__doc__,       /* doc */
    flags_fields,       /* fields */
-    18
+    Py_ARRAY_LENGTH(flags_fields) - 1
 };

 static int
-Original file line number
+Diff line change
@@ -587,6 +587,9 @@ always available.
           * - .. attribute:: flags.warn_default_encoding
             - :option:`-X warn_default_encoding <-X>`
+          * - .. attribute:: flags.gil
         Comment thread


        

        
      

        
          


  
    
        
        
  
    
      
          
      

      
            picnixz
  

      

      

      


        Aug 2, 2024



      
    

  

  
    
      
          
    
  


        
            
  
      
              Copy link

  
              
  
      
                Copy Markdown

  
        
      
    

    
        

  
  Member


        

    
  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      You should explain that the gil takes values 0, 1, or 2 and possibly explain the corresponding values (or a link to them) (and also say that None means the free-threaded build (if I'm not wrong)).
    
  
  



    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
              
  
    
    
      
        
            
    All reactions
  


          
          
        
      
    


      



    
        
  
    
      
          
      

      
            ericsnowcurrently
  

      

      

      


        Aug 9, 2024



      
    

  

  
    
      
          
    
  


        
            
  
      
              Copy link

  
              
  
      
                Copy Markdown

  
        
      
    

    
        

  
  Member


        

    
  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      This isn't the right place for that, is it?
    
  
  



    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
              
  
    
    
      
        
            
    All reactions
  


          
          
        
      
    


      



    
        
  
    
      
          
      

      
            picnixz
  

      

      

      


        Aug 10, 2024



      
    

  

  
    
      
          
    
  


        
            
  
      
              Copy link

  
              
  
      
                Copy Markdown

  
        
      
    

    
        

  
  Member


        

    
  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      Oh actually I don't really know where it would be the right place... I just wanted to point it out since a new variable is being documented (I don't know whether there already exists another place so feel free to ignore this comment!)
    
  
  



    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
              
  
    
    
      
        
            
    All reactions
+            - :option:`-X gil <-X>`
        .. versionchanged:: 3.2
           Added ``quiet`` attribute for the new :option:`-q` flag.
@@ -613,6 +616,9 @@ always available.
        .. versionchanged:: 3.11
           Added the ``int_max_str_digits`` attribute.
+       .. versionchanged:: 3.13
+          Added the ``gil`` attribute.
     .. data:: float_info
-          Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		Include :attr:`sys.flags.gil` as part of the sequence when :data:`sys.flags`
		is treated as a tuple.