upstream/ipython Files · docs/sphinxext/configtraits.py

Fix unintentional skipping of module level doctests...

Fix unintentional skipping of module level doctests Importing `skip_doctest` decorator unintentionally marks for skipping a module level doctest. It happens because doctests discovery only checks whether a variable with name `skip_doctest` is presented without checking the type. I have renamed the 'magic' variable name to `__skip_doctest__` to resolve the name clash, and also made the check actually depend on the variable content. The module level doctest in `core/debugger.py` was previously unintentionally skipped and now is disabled because it contains syntax/name errors.

Lumir Balhar - - Load All Authors

File last commit:

r25608:70b7090a


                r26873:17153999

Download file

             configtraits.py
        
                    16 lines
            
             | 414 B
            
                | text/x-python
            
             |
                PythonLexer
            
             / docs / sphinxext / configtraits.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      """Directives and roles for documenting traitlets config options.

      ::

          .. configtrait:: Application.log_datefmt

              Description goes here.

          Cross reference like this: :configtrait:`Application.log_datefmt`.

      """

      def setup(app):

          app.add_object_type('configtrait', 'configtrait', objname='Config option')

          metadata = {'parallel_read_safe': True, 'parallel_write_safe': True}

          return metadata

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				"""Directives and roles for documenting traitlets config options.

				::

				.. configtrait:: Application.log_datefmt

				Description goes here.

				Cross reference like this: :configtrait:`Application.log_datefmt`.
				"""


				def setup(app):
				app.add_object_type('configtrait', 'configtrait', objname='Config option')
				metadata = {'parallel_read_safe': True, 'parallel_write_safe': True}
				return metadata