aboutsummaryrefslogtreecommitdiff
blob: feefe47a50cea15f1802c07c62d11309689bba31 (plain)
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
Adding or modifying code:
=========================
- If you add new code, best practice is to write a test for it.
- If you're modifying code that doesn't have a test and you can write a test
  for it, please do.
- Before committing your changes to a python file, please make sure it passes
  pylint with:
pylint --rcfile=pylintrc yourfile.py
- If pylint raises a warning or error that you don't agree with, it's probably
  better to just change your code. If you're sure you have a good reason for
  doing what you're doing, you can add an exception to our pylintrc.

Creating a release:
===================
Note: We are using VERSION="0.3.0" simply as an example.

- Run Gentoolkit's test suite, make sure it passes:
Note: requires dev-python/snakeoil
./setup.py test

- Create a tag for the release
svn copy svn+ssh://<dev>@svn.gentoo.org/var/svnroot/gentoolkit/trunk \
         svn+ssh://<dev>@svn.gentoo.org/var/svnroot/gentoolkit/tags/gentoolkit-0.3.0 \
	 -m "Tagging the <VERSION> release of gentoolkit."
svn update to pull the tag from subversion
cd to the local tags/gentoolkit-0.3.0 directory

- Set the version of the release:
VERSION="0.3.0" ./setup.py set_version

- Create a source distribution (you need to add VERSION here, too):
VERSION="0.3.0" ./setup.py sdist
Transfer dist/gentoolkit-0.3.0.tar.gz to dev.gentoo.org:/space/distfiles-local

- Reset svn version to 'svn' (default):
./setup.py set_version

- Clean up temporary files:
./setup.py clean -a