Developers ========== If you are a developer and use *pyunraw* in your project, you will find here useful information. Getting the code ################ *pyunraw*'s source code is versioned with `bazaar `_, and the main development focus (sometimes referred to as *trunk*), is hosted on `Launchpad `_. To get a working copy of the latest revision of the development branch, just issue the following command in a terminal:: bzr branch lp:pyunraw Dependencies ############ To build *pyunraw* * `gcc` * `python-all-dev` (≥ 3.2) * `liblcms2-dev` (>= 2.2-1) * `libjpeg-dev` (>= 8c) To use *pyunraw* * `python 3` * `liblcms2` * `libjpeg` Building and installing ####################### Open a terminal into the folder and enter:: $ python3 setup.py build Then you will find into `/build/lib...` a file named `_pyunraw.cpython-xym...` where xy is your version of python. In your `python3/dist-packages` folder create a subfolder `pyunraw` and copy into this folder the files `__init__.py, pyunraw.py` and the file `_pyunraw.cpython-xym...` Now, run your python3 interactive interpreter and import pyunraw to see if there's no error. Install from PyPI ################# pyunraw is `available from PyPI `_ Use, with admin rights if necessary, the command:: $ pip3 install pyunraw Documentation ############# The present documentation is generated using `Sphinx `_ from reStructuredText sources found in the doc/ directory. Invoke ``make html`` to (re)build the HTML documentation. The index of the documentation will then be found under doc/_build/html/index.html. Contributing ############ pyunraw is Free Software, meaning that you are encouraged to use it, modify it to suit your needs, contribute back improvements, and redistribute it. If you want to fork it on GitHub, you will find usefull information on how to import the branch from Launchpad to GitHub `here `_. `Bugs `_ are tracked on Launchpad. When reporting a bug, don't forget to include the following information in the report: * version of pyunraw * a minimal script that reliably reproduces the issue * a sample image file with which the bug can reliably be reproduced (or a link to)