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

Python vs IPython: recommend %cd, %env over !cd, !export...

Python vs IPython: recommend %cd, %env over !cd, !export The quick overview mentioned `!cd DIR` among examples of shell commands one might use —but that doesn't work as user would hope (can only affect commands in same ! e.g. `!cd /; pwd`). That's not as bad now that `!cd` prints a warning, but IMHO better to provide the right mental model up front. => Replaced that with minimal motivation why `!cd` and `!export` can't work, recommending some %magic alternatives; moved it out of examples to not distract, and right before Magics section.

Lumir Balhar - - Load All Authors

File last commit:

r25608:70b7090a


                r29043:9b6f0ea1

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