R3596/1dd4f79569c9master
/
README
- text -*-
This is the core API of the pybliographer framework. It provides classes for managing bibliographic databases (storage, query, conversion, formatting,...)
Getting started
Once the package is installed (see below), you can use the following entry points to learn how it works:
- the examples/ directory contains a few simple scripts with comments
- the reference manual is available in HTML format in the doc/ directory.
Installation
This package uses easy_install, and should fetch some dependencies itself (except for the ones listed below).
Requirements
- python >= 2.3
- ElementTree and cElementTree (http://effbot.org/zone/element-index.htm)
- numpy >= 1.0b1 (http://numpy.scipy.org/)
Optional dependencies
- In order to use the bsddb store, you need a recent pybsddb version (>= 4.3.3) (http://pybsddb.sourceforge.net/)
WARNING: the latest python version at that time (2.4.2) has not yet the requested version of pybsddb. - In order to run external queries (to the Web of Science for instance), you need to install Twisted (http://twistedmatrix.com/).
Global installation
Once the required dependencies are installed, you can install this package in the standard place with the following commands in the directory containing this README:
python setup.py build sudo python setup.py install
Developer mode
If you use pybliographer for your own developments and need to modify pybliographer itself, you can run
sudo python setup.py develop
This will ensure that when you import Pyblio, you'll get the version in _your_ working directory. No need to play with your PYTHONPATH anymore.