gocept.zestreleaser.customupload 2.0

Plug-in for zest.releaser to allow uploading the created egg via SCP to configurable destinations.

Copyright (c) 2010-2015 gocept gmbh & co. kg

All Rights Reserved.

This software is subject to the provisions of the Zope Public License, Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution. THIS SOFTWARE IS PROVIDED “AS IS” AND ANY AND ALL EXPRESS OR IMPLIED WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Custom egg upload

This package provides a plugin for zest.releaser that offers to upload the released egg via SCP, SFTP or HTTP(S) PUT (WebDAV) to a custom location (instead of or in addition to PyPI).

To use, add a section to your ~/.pypirc like the following:

[gocept.zestreleaser.customupload]
gocept = scp://download.gocept.com//var/www/packages
gocept.special = http://dav.gocept.com/special
gocept.sftp = sftp://[e-mail]/home/repo/eggs

If the name of the package being released starts with one of the keys in that section (longest match wins, case insensitive), you will be prompted whether to upload the egg (that was created by zest.releaser by checking out the tag) to the given server.

Options for HTTP(S) PUT (WebDAV)

HTTP(S) PUT (WebDAV) is implemented using curl to add options to curl, e. g. to disable certificate checks, add the options in front of the URL like this:

[gocept.zestreleaser.customupload]
gocept.special = --insecure https://dav.gocept.com/special

Uploading Documentation

In addition to uploading the egg, the plugin also offers to upload generated documentation.

To use this functionality, create a ~/.zestreleaserrc that contains something like the following:

[gocept.zestreleaser.customupload.doc]
gocept = docs.gocept.com:/var/www/doc

If the name of the package being released starts with one of the keys in that section, the plugin will run ./bin/doc to generate the documentation and then prompt to upload the contents of ./build/doc. The upload destination is assembled from the configured prefix, the package name and version. In the example, the upload location would be /var/www/doc/gocept.foo/1.3.

Development

The source code is available in the Mercurial repository at https://bitbucket.org/gocept/gocept.zestreleaser.customupload

Please report any bugs you find at https://bitbucket.org/gocept/gocept.zestreleaser.customupload/issues

Changelog

2.0 (2015-11-18)

• Move repos to https://bitbucket.org/gocept/gocept.zestreleaser.customupload

• Make tests compatible to zest.releaser >= 3.51.

• Claim Python 3.3 to 3.5 and PyPy support, thus requiring zest.releaser >= 5.0.

• Drop Python 2.5 support.

1.4 (2012-07-31)

• If the destination URL contains username and password, do not display the password on the console when asking for upload.

• Allow options in HTTP(S) PUT (WebDAV) upload.

• Added some trove classifiers to indicate suported Python versions.

1.3 (2012-05-15)

• Allow uploading via SFTP (patch by Godefroid Chapelle <[e-mail]>).

1.2.1 (2012-05-07)

• Fixed documentation of SCP upload configuration.

1.2 (2012-01-20)

• Add second plugin point that builds and uploads documentation

1.1.0 (2011-11-18)

• Allow uploading via HTTP PUT (WebDAV) [CZ].

1.0.3 (2011-11-11)

• Make matching package names case insensitive [bug reported by [e-mail]].

1.0.2 (2010-07-22)

• Upload everything from the dist/ directory, so it works for any egg format, .zip, .tar.gz, .egg, or else [suggestion by [e-mail]].

1.0.1 (2010-07-22)

• Added a MANIFEST.in so that the created egg actually works.

1.0 (2010-07-22)

• first release [WS].