~vila/byoci/trunk

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
=========================
Packaging HOWTO for byoci
=========================

Preparing
=========

 * Ensure all changes since previous release have been documented in
   NEWS.rst and that the section is for the upcoming release.

 * Set __version__ to (X, Y, Z, 'final', 0) in byoci/__init__.py

 * export VER=X.Y.Z
  
 * Commit and tag the release

   $ bzr commit -m "Release $VER"
   $ bzr tag byoci-$VER

Pushing to launchpad
==================

Push the tagged branch to lp:byoci.


Uploading to PyPi
=================

Create the tarball in the directory above.

$ python3 setup.py sdist -d .. clean

Sign and upload it.

$ python3 -m twine upload --sign ../byoci-$VER.tar.gz

If the project is renamed, it needs to be registered under the new name:

$ python3 setup.py register


Opening next release for dev
============================

 * Set __version__ to (X, Y, Z+1, 'dev', 0) in byoci/__init__.py

 * Create a new entry in NEWS.rst named 'dev' to hint that the version
   number for the next release is decided *when* the release is done, not
   when trunk is opened for the next release.

 * bzr commit -m 'Open X.Y.Z+1 for dev'