Creating Source Releases¶
Quantities is distributed as a source release for Linux and OS-X. To create a source release, just do:
python setup.py register python setup.py sdist --formats=zip,gztar upload --sign
This will create the tgz source file and upload it to the Python Package Index. Uploading to PyPi requires a .pypirc file in your home directory, something like:
[server-login] username: <username> password: <password>
You can create a source distribution without uploading by doing:
python setup.py sdist
This creates a source distribution in the dist/ directory.
Creating Windows Installers¶
We distribute binary installers for the windows platform. In order to build the windows installer, open a DOS window, cd into the quantities source directory and run:
python setup.py build python setup.py bdist_msi
This creates the executable windows installer in the dist/ directory.
Building Quantities documentation¶
When publishing a new release, the Quantities doumentation needs to be generated and published as well. Sphinx, LaTeX (preferably TeX-Live), and dvipng are required to build the documentation. Once these are installed, do:
cd doc make html
which will produce the html output and save it in build/sphinx/html. Then run:
make latex cd build/latex make all-pdf cp Quantities.pdf ../html
which will generate a pdf file in the latex directory. Finally, upload the html content to the http://packages.python.org/quantities/ webserver. To do so:
cd build/html zip -r quantities *
and then visit the Quantities project page at the Python Package Index to upload the zip archive.