aboutsummaryrefslogblamecommitdiffstats
path: root/docs/maintainer-guide.rst
blob: 6428c4dfbfef26741840a62a8040838b5ebbe641 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15














                                                                    
                                          
 
                       








                                                                   
                                        

                                                                
               
 
                         
 
                  
 
                                         



                                                                           
                                               

                                              
.. _release:

==================
 Maintainer guide
==================

This guide contains a playbook for tasks the maintainer will need to
perform.


Initial setup
=============

- Create a PyPI account

- Configure ``~/.pypirc`` with credentials

- ``pip install twine``


How to make a new release of git-deps
=====================================

- Ensure everything is committed and the git working tree is clean.

- Ensure all change have been pushed to the remote branch.

- Run ``tox`` to check everything is OK.

- Decide a new version.  Release candidates should take the form
  ``1.2.3rc4``.

- ``git tag -s $version``

- ``tox -e sdist``

- ``twine dist/git-deps-$version.tar.gz``

- Check the new version appears at `<https://pypi.org/project/git-deps/>`_.

- Test installation via at least one of the documented options, e.g.
  ``pip install git-deps`` within a virtualenv.

- Test / update the Docker-based installation.