Source

ars / docs / maintainers / Procedure to create and upload a release .txt

Full commit

XYZ: the 'version' string kwarg in the call to setup() in setup.py
%date: date in format YYYY.MM.DD


0) clean working directory. The best choice is to shelve all changes.

1) test that the source distribution is created appropriately (in all the archive formats)
	$ python setup.py sdist --formats=gztar,zip

2) update version/release number and commit. Change it in
	ars/__init__.py

3) in branch 'default', merge with 'dev' and tag previous changeset
(e.g. 1084 = 9fa5876718f0) with the output of `ars.get_version()` e.g. '0.5a2'
	$ hg up default
	$ hg merge dev-main
	$ hg tag --rev 1084 "--message=Added tag 0.5a2 for changeset 9fa5876718f0" 0.5a2

4) create and upload source distribution to PyPI
Alternative A
	$ python setup.py sdist --formats=gztar,zip upload

Alternative B
	Go to https://pypi.python.org/pypi?name=ARS&:action=submit_form
	and "PKG-INFO file" > "Choose file" > "Add Package Info" to create a new
	release manually. Then upload both files (gzip and zip) with "File type"
	set to "source".

5) test installation with 'pip'
	$ sudo pip install ARS
	$ python
	>>> import ars

6) $ hg push

7) go to https://sourceforge.net/projects/arsproject/files/ARS/ and create a folder named 'XYZ %date'

8) upload these files to that folder
	ARS-XYZ.tar.gz
	ARS-XYZ.zip

9) set the .zip as the default download for Windows and Mac OSX, and the .gz
	for all the rest.

NOT anymore (download URLs are dynamically created for tags e.g.
	https://bitbucket.org/glarrain/ars/get/0.5a2.tar.gz
10) upload the same files here: https://bitbucket.org/glarrain/ars/downloads

11) Verify documentation builds passed here: https://readthedocs.org/builds/ars-project/