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



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:


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' entry points (hooks) into Orange namespace. Use relative imports to access other modules inside the package, if possible., Makefile, and as prepared in Biolab's add-ons can be used to get a good starting point for a new add-on.

Entry points (hooks)

The following  entry points are defined and used by Orange:

Entry point to register add-on into Orange namespace.
Entry point to add add-on's widgets to Orange canvas.
Entry point to add add-on's datasets' directory to search path for loading datasets.


    'orange.addons': (
        'foobar = _packagename',
    'orange.widgets': (
        'Foobar = _packagename.widgets',
    '': (
        'packagename = _packagename:datasets',

These entry points will inject add-on under Orange.foobar namespace. So _packagename.baz will be accessible as Orange.foobar.baz.

Widgets will be available under category named Foobar.

And function datasets will be called to retrieve additional search paths.

For example, accordingly to above entry point definition, it could be defined (or just exposed) in _packagename/ as:

import pkg_resources

def datasets():
    yield ('foobar', pkg_resources.resource_filename(__name__, 'datasets'))

This would add datasets in _packagename/datasets/ to the search path, with prefix foobar. So:

data ="")

would load _packagename/datasets/ file.


Add-ons should be distributed through  PyPi. If done so (and keyword orange add-on is used for the package), they will be displayed among available add-ons on Orange webpage.

Care should be taken that add-ons work also as Python eggs. They should be uploaded for Python 2.6 and 2.7 to PyPi (along the add-on's source package) for add-on to be available for install through Orange Canvas.


Installation using pip is recommended and should be supported by an add-on. Other way of installing is simply by putting add-on's Python egg into user's add-ons dir (add-ons subdirectory of Orange homedir).

Recommended release procedure

Initial release

Subsequent releases

When a new release is ready:

  1. increase version in
  2. commit
  3. tag the commit with (hg tag <version string>)
  4. push to Bitbucket
  5. python register
  6. python sdist upload
  7. python2.6 bdist_egg upload
  8. python2.7 bdist_egg upload