Skip to main content

A Python client for ODLS

Project description

The ODLS client scans local filesystems, looks for changes, and reports them to an ODLS server. The states of files/directories scanned are stored in a local SQLite database.

The odls.client package mainly provides a script indexer that will be available in some bin/ directory after install (the concrete location will depend on the type of install).

The indexer script is configured by commandline options (try indexer --help) and configuration files. All this is explained in more detail in the package documentation (see below).

This Python implementation of the ODLS client is the successor of the C++ implementation used in the years before.

While odls.client itself is pure Python, some extensions (notably the SQLite support) require C extensions.


The full package documentation can be found at:


odls.client is currently tested on Linux only.

  • you need Python >= 2.4

  • you need pysqlite whih in turn might require the SQLite libraries and header files.

  • for full install (including tests etc.) you also need the Python header files and a working C-compiler like gcc.

Installing the Library

Use easy_install to install the library.

Or download the sources and in the root dir of the extracted package do:

$ python install

You might need superuser permissions to do that.

Installing for Development

After downloading and extracting the sources, in the root dir of the downloaded file tree do:

$ python bootstrap/

which will configure the package for your system. Then, run:

$ ./bin/buildout

which will generate all scripts needed for development in the local bin/ directory.

Running Tests

Afterwards you can run the tests by doing:

$ ./bin/test

Creating Docs

odls.client comes with some documentation in the docs/ folder. It can be turned into Sphinx based HTML by running:

$ ./bin/make-docs

The docs then can be found in docs/build/html.

Creating Coverage Reports

We try to keep odls.client at a 100%-test-covered level. You can do the coverage report by issuing on the command line:

$ ./bin/coverage-detect
$ ./bin/coveragereport

This will create HTML docs of the test coverage of each module. You can find the generated HTML pages in the coveragereport subdir.


0.1 (2010-12-21)

Initial implementation.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

odls.client-0.1.tar.gz (50.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page