Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.


This package is in a really early state!!! Some options do simply not work yet and Windows support is yet completely untested.


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.

Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
odls.client-0.1.tar.gz (50.2 kB) Copy SHA256 Checksum SHA256 Source Dec 21, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting