upstream/ipython Files · IPython/utils/sentinel.py

add a little detail to custom repr method docs (#13945)...

add a little detail to custom repr method docs (#13945) These docs are a bit sparse, so I added a couple details that might help implementers: - explicitly state the return type, rather than only via example - give some examples of PNG, HTML - note that formatters shouldn't be sensitive to other formats related to https://github.com/Textualize/rich/pull/2806 which didn't follow the spec, in part I think because the docs weren't explicit enough about exactly what a formatter should do.

Min RK - - Load All Authors

File last commit:

r21078:2098e1d4


                r28126:29190f63

Download file

             sentinel.py
        
                    17 lines
            
             | 421 B
            
                | text/x-python
            
             |
                PythonLexer
            
             / IPython / utils / sentinel.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      """Sentinel class for constants with useful reprs"""

      # Copyright (c) IPython Development Team.

      # Distributed under the terms of the Modified BSD License.

      class Sentinel(object):

          def __init__(self, name, module, docstring=None):

              self.name = name

              self.module = module

              if docstring:

                  self.__doc__ = docstring

          def __repr__(self):

              return str(self.module)+'.'+self.name

	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

				"""Sentinel class for constants with useful reprs"""

				# Copyright (c) IPython Development Team.
				# Distributed under the terms of the Modified BSD License.

				class Sentinel(object):

				def __init__(self, name, module, docstring=None):
				self.name = name
				self.module = module
				if docstring:
				self.__doc__ = docstring


				def __repr__(self):
				return str(self.module)+'.'+self.name