Popular recipes tagged "docstring" but not "gzip"

Inherit method docstrings without breaking decorators or violating DRY (Python)

2013-07-01T02:29:40-07:00

Python recipe 578587 by nikratio (decorator, decorators, docstring, inheritance). Revision 2.

There are several recipes for inheriting method docstrings. However, most of them either violate DRY (and have you repeat the ancestor class name in the method decorator that sets the docstring), or do break decorators that try to access the docstring (because the docstring is only assigned after class creation). This recipe avoids both problems.

Note: This recipe uses the mro method from http://code.activestate.com/recipes/577748-calculate-the-mro-of-a-class/

Inherit Method Docstrings Using Only Function Decorators (Python)

2011-06-26T02:28:55-07:00

Python recipe 577746 by Eric Snow (decorator, decorators, docstring). Revision 3.

This recipe provides a descriptor and a decorator. The decorator will be used on any method in your class to indicate that you want that method to inherit its docstring.

This is useful when you are using abstract bases classes and want a method to have the same docstring as the abstract method it implements.

This recipe uses recipe #577745, the deferred_binder module.

Using Metaclasses and Class Decorators to Inherit Function Docstrings (Python)

2011-06-11T00:59:35-07:00

Python recipe 577743 by Eric Snow (decorator, decorators, docstring, inheritance, metaclass, metaclasses). Revision 4.

You'll find three different approaches to copying the method's docstring to the overriding method on a child class.

The function decorator approach is limited by the fact that you have to know the class when you call the decorator, so it can't be used inside a class body. However, recipe #577746 provides a function decorator that does not have this limitation.

Docstring inheritance decorator (Python)

2009-07-28T13:42:32-07:00

Python recipe 576862 by Shai Berger (decorator, descriptor, docstring, inheritance, metaprogramming).

In many cases, a subclass overrides a method in a parent class, just to change its implementation; in such cases, it would be nice to preserve the overridden method's docstring. The decorator below can be used to achieve this without explicit reference to the parent class. It does this by replacing the function with a descriptor, which accesses the parent class when the method is accessed as an attribute.

Docstring inheritance class decorator (Python)

2011-11-23T20:12:03-08:00

Python recipe 577102 by Alec Thomas (class, decorator, docstring, inheritance). Revision 2.

Inherits method docstrings from parent classes.

Viewing embedded pictures within docstrings (Python)

2008-10-15T01:27:26-07:00

Python recipe 576538 by Andre Roberge (docstring, embedded_image, viewer).

Python docstrings are textual information about objects. They can be displayed via help(obj). However, they can not contain images. This recipe allows the inclusion of images (encoded in base 64 in the Python file) inside docstrings in a transparent way. The images are indicated as "docpicture = file_name.ext" inside the docstring, and the encoded data is in variable "file_name" inside the same module.