README.dev

   1 Adding or modifying code:
   2 =========================
   3 - If you add new code, best practice is to write a test for it.
   4 - If you're modifying code that doesn't have a test and you can write a test
   5   for it, please do.
   6 - Before committing your changes to a python file, please make sure it passes
   7   pylint with:
   8 pylint --rcfile=pylintrc yourfile.py
   9 - If pylint raises a warning or error that you don't agree with, it's probably
  10   better to just change your code. If you're sure you have a good reason for
  11   doing what you're doing, you can add an exception to our pylintrc.
  12
  13 Creating a release:
  14 ===================
  15 Note: We are using VERSION="0.3.0" simply as an example.
  16
  17 - Run Gentoolkit's test suite, make sure it passes:
  18 Note: requires dev-python/snakeoil
  19
  20 ./setup.py test
  21
  22 - Create a source distribution (you need to add VERSION here):
  23 VERSION="0.3.0" ./setup.py sdist
  24 Transfer dist/gentoolkit-0.3.0.tar.gz to dev.gentoo.org:/space/distfiles-local
  25
  26 - Clean up temporary files:
  27 ./setup.py clean -a
  28 git status
  29 rm or mv any untracked files/directories
  30
  31 - Create a tag for the release
  32 git tag gentoolkit-0.3.0
  33 git push origin gentoolkit-0.3.0