move setup.cfg info to setuptools docs, reword

This commit is contained in:
David Lord 2016-06-05 12:59:04 -07:00
parent 33212309a2
commit 14a5a9e554
2 changed files with 19 additions and 18 deletions

View file

@ -87,6 +87,25 @@ your packages to be installed as zip files because some tools do not
support them and they make debugging a lot harder. support them and they make debugging a lot harder.
Tagging Builds
--------------
It is useful to distinguish between release and development builds. Add a
:file:`setup.cfg` file to configure these options.
[egg_info]
tag_build = .dev
tag_date = 1
[aliases]
release = egg_info -RDb ''
Running ``python setup.py sdist`` will create a development package
with ".dev" and the current date appended: ``flaskr-1.0.dev20160314.tar.gz``.
Running ``python setup.py release sdist`` will create a release package
with only the version: ``flaskr-1.0.tar.gz``.
.. _distributing-resources: .. _distributing-resources:
Distributing Resources Distributing Resources

View file

@ -156,24 +156,6 @@ location where it's expected (eg: :file:`/var/www/yourapplication`).
Either way, in our case here we only expect one or two servers and we can Either way, in our case here we only expect one or two servers and we can
upload them ahead of time by hand. upload them ahead of time by hand.
Configuring egg_info
--------------------
If you need to configure your fabric build with tags, you can create a `setup.cfg`
file in the root of your app. An example would be:
[egg_info]
tag_svn_revision = 1
tag_build = .dev
tag_date = 1
[aliases]
release = egg_info -RDb ''
And now when running `python setup.py sdist ...` in your fabric file, it will
pick up on these settings and tag appropriately. And when making a release build
it will ignore these build tags as expected.
First Deployment First Deployment
---------------- ----------------