Utility Functions
Documentation coming soon.
-
init.debug_dump(filename)
Dumps doctext for all cells in the circuit
-
init.debug_viz(filename)
Creates a dot file. To visualize a dot file you can use a free utility like
dot which comes with the Graphviz package.
Dot is invoked from your system’s command line like so:
$ dot -Tpng filename.dot -o outfile.png
For additional options, type: dot --help
-
init.help_docs()
Opens jupyter notebook documentation
-
init.run_unit_test(filename)
A special function for PyCell plugin. It is a shortcut to run PyCell
defined unit tests.
To run all:
>>> run_unit_test('test_all')
-
traceback_formatter.pprint_tb(etype, value, tb)
Pretty-prints tracebacks.
Example usage:
>>> pprint_tb(*sys.exc_info())
Profiler UI Elements
Coming Soon.
-
class
profiler.ProfilerAssembler(circuit)
Assembles a profiler window.
| Variables: | circuit – The circuit to profile. |
Jupyter Notebooks
Coming Soon.
Docstring Provider
Property decorator for the __doc__ attribute. Useful for when you want
a custom docstring for class instances while still showing a generic docstring
for the class itself.
Source: http://bfroehle.com/2012/11/08/property-for-doc-attribute/
Usage:
>>> class A(object):
... '''Main docstring'''
... def __init__(self, x):
... self.x = x
... @docstring_property(__doc__)
... def __doc__(self):
... return "My value of x is %s." % self.x
>>> A.__doc__
'Main docstring'
>>> a = A(10)
>>> a.__doc__
'My value of x is 10.'
-
class
docstring_property.DocstringProperty(class_doc, fget)
Property for the __doc__ attribute.
Different than property in the following two ways:
- When the attribute is accessed from the main class, it returns the value
of
class_doc, not the property itself. This is necessary so
Sphinx and other documentation tools can access the class docstring.
- Only supports getting the attribute; setting and deleting raise an
AttributeError.