Browse Source

move setup.cfg info to setuptools docs, reword

pull/1850/merge
David Lord 9 years ago
parent
commit
14a5a9e554
  1. 19
      docs/patterns/distribute.rst
  2. 18
      docs/patterns/fabric.rst

19
docs/patterns/distribute.rst

@ -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

18
docs/patterns/fabric.rst

@ -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
---------------- ----------------

Loading…
Cancel
Save