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.
Documentation
The full package documentation can be found at:
Prerequisites
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 setup.py 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/bootstrap.py
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.
CHANGES
0.1 (2010-12-21)
Initial implementation.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file odls.client-0.1.tar.gz
.
File metadata
- Download URL: odls.client-0.1.tar.gz
- Upload date:
- Size: 50.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | bde3165b18258443467586edced4028b9a4fe19476a8701f6e7a333888b54e39 |
|
MD5 | a25b7021afd90e575df2d09820e261b8 |
|
BLAKE2b-256 | 705b481cde36f2ca94f8b86b856c4639692eb3b27f927f5eb02b1a461b91a7f2 |