Skip to main content

Side-to-side documentation generator, a descendant of Pycco and Docco.

Project description

PyPi package
Build Status

Side-to-side documentation generator. Fork of the Pycco, grandfork of the Docco. And an object-oriented one.

See how it works


At the moment the release on the PyPi is being prepared. In the meanwhile, to use the Pyccoon

git clone
cd pyccoon
python install

And you’re done. Pyccoon is compatible with Python 2.6, 2.7, 3.3, 3.4 and PyPy. Latest test results can be seen on the Travis CI project page.


To generate the project documentation

pyccoon -s <source folder> -d <documentation folder>

For additional CLI options, see pyccoon --help

At the moment Pyccoon supports Python, Ruby, Javascript, PHP and C/C++ source files. Other project files will be simply copied to the documentation folder. For additional configuration, create a config file of the kind:

    // Documentation title
    "project_name": "pyccoon v0.1.0 documentation",
    // Skip files matching any of the list of regular expressions
    "skip_files": [".+\\.pyc", "__pycache__", "\\.travis.yml", "\\.git", "\\.DS_Store"],
    // Copy files without processing (useful if you have some binary files)
    "copy_files": ["pyccoon.svg", "pyccoon_icon.svg", ".+\\.html", ".+\\.css", "\\.pyccoon"],
    // MathJax ( support - sometimes we want nice formulas
    "mathjax": false

Development roadmap

  • [x] Initial version
    • [x] Python
    • [x] Ruby
    • [x] JavaScript (incomplete, but will do)
    • [x] C/C++ (incomplete)
    • [x] PHP (incomplete)
  • [x] Better page layout
  • [x] Documentation website
  • [ ] Write test suites and extend supported languages list:
    • [x] Python
    • [ ] Ruby
    • [ ] PHP
    • [ ] JavaScript
    • [ ] C/C++
    • [ ] CoffeScript
    • [ ] Perl
    • [ ] SQL
    • [ ] Scheme
    • [ ] Lua
    • [ ] Erlang
    • [ ] Tcl
    • [ ] Haskell
    • [ ] CSS, LESS, SASS
  • [ ] Fix bugs:
    • [x] Fix --watch option
    • [x] Broken cross-referencing (wikilinks)
    • [x] Fix multiple Python versions compatibility
    • [ ] Replace Python Markdown with Mistune (because we want nice extensions)
      • [ ] Restrict extensions to specific block types
      • [ ] Create LaTeX codeblocks (to avoid unnecessary \begin{equation}...\end{equation} in the docs and restrict MathJax parsing only to specific elements on the page)
    • [ ] Use glob: replace config file regular expressions with more natural wildcards (also support matching against the whole path, not only filename)
    • [ ] Add (actually, fix) line numbers feature (tricky)
    • [ ] Test against multilanguage projects (i.e., what happens if there are index.html and in one folder?)
    • [ ] Link index files instead of renaming ( -> index.html)
  • [ ] Release on PyPi
  • [ ] Additional features:
    • [ ] Object retrieval and cross-linking (“jump to definition” for classes, functions)
    • [ ] Search
    • [ ] Extended docblocks parsing (capturing shortcuts and aliases for cross-linking)
    • [ ] Mixed documents parsing: HTML/JS/CSS, HTML/PHP, etc.
    • [ ] TODO: statements, linting and coverage reports



0.1.0 (2014-09-07)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyccoon, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pyccoon-0.1.0-py2.py3-none-any.whl (41.0 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size pyccoon-0.1.0.tar.gz (52.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page