Python "header" files
Donald 'Paddy' McCarthy
paddy3118 at netscape.net
Wed Jun 9 06:56:30 CEST 2004
beliavsky at aol.com wrote:
> Ideally, one can use someone's C++ code by just looking at the header
> (which should contain comments describing the functions in addition to
> function definitions), without access to the full source code. Can
> analogs of C++ header files be created for Python code?
> Python "header" files could list only the 'def' statements and
> docstrings of Python functions and classes, but that does not tell you
> what the functions return. One could list the return statements as
> well, but there can be several of them in a function, and they often
> show HOW something is calculated, which is "too much information" for
> a header file.
> I wonder how Python projects with multiple programmers can be
> coordinated without giving all programmers access to all of the source
> code. I am currently working on one-man projects, but I am still
> interested in ways of separating interface from implementation.
You could use doctest:
- together with meaningful docstring comments and pydoc:
You might try help() in the interpreter on a few functions or modules
More information about the Python-list