wiki:AddOns

Version 9 (modified by mitar, 22 months ago) (diff)

Add-ons

Structure

Add-on is a  Python package. The structure of an add-ons repository is as follows, package name being a name of a directory of the add-on's Python package, often lowercased addonname:

orange-addonname/
    COPYING
    LICENSE
    setup.py
    docs/
        Makefile
        rst/
            conf.py
            index.rst
    _packagename/
        datasets/
        widgets/
            __init__.py
            ...
        __init__.py
        ...
    src/

docs contains reST documentation of the add-on. src possible contains C/C++ source code. datasets any additional datasets add-on might use.

Package name starts with _ to signify it is for internal use only. Add-ons register through setuptools hook into Orange namespace. Use relative imports to access other modules inside the package, if possible.

setup.py, Makefile, and conf.py as prepared in Biolab's add-ons can be used to get a good starting point for a new add-on.