This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Available commands

Login

Uploading a click package requires the developer to submit an oauth signed request. For this, click-toolbelt needs to first obtain an oauth token. In order to do so, the user can run the following (note: be sure to prepend the command with a space so that your command history doesn’t save the sensitive command).

$   click-toolbelt login <email> <password> [otp]

On successful execution this command will store the oauth credentials in $HOME/.config/click-toolbelt/click.cfg and will use it during the upload step.

Upload

Once the user is successfully logged in, he can then upload the click package. In order to do so, the user can run

$ click-toolbelt upload <binary_file> [--metadata <metadata_file>]

For this command to be successful, certain criteria must be met:

  • user must be logged in already (see Login)
  • the binary file must be a valid click package
  • user owns the application for which he’s uploading the click package (if the application already exists)

The metadata_file parameter should refer to a file containing a json document. If this file is provided, it will be used to extract extra information not provided in the click package’s manifest.

When uploading the initial package, the following fields might be extracted from the metadata_file:

  • tagline: A one line summary for the app
  • department: The app’s category name (see Department)
  • channel: The upload target channel name (see Channel). If omitted, ‘stable’ is assumed.
  • support_url: A URL users can go to for support for this application. Allows http(s): and mailto: schemes
  • license: The license under which the app will be released (see License)
  • icon_256 (or icon): The path to a local file to be uploaded as the icon for the application; the icon must be 256x256 px in size
  • name: Application name (overrides what’s defined in the click package manifest)
  • description: Application description (overrides what’s defined in the click package manifest)
  • changelog: A description of the changes included since the last upload
  • screenshots: A list of paths to local files to be uploaded as screenshots for the application
  • blacklist_ids: A list of country codes to prevent the application from being distributed to (see Country)
  • whitelist_ids: A list of country codes to limit the application being distributed to (see Country)
  • auto_publish: Automatically submit for review
  • reviewer_notes: Notes for reviewers to use when reviewing the app’s submission

For a new version upload, the metadata_file file will only be scanned for the following fields:

  • channel: The upload target channel name (see Channel). If omitted, ‘stable’ is assumed.
  • changelog: A description of the changes included since the last upload

Info

The info command will return metadata about the current available API. To retrieve this data, the user can run the following command:

$ click-toolbelt info

This will show all available information about the API. Alternative, the user can retrieve only a subset of the data.

Get the current API version

$ click-toolbelt info version

Get the list of valid license values

$ click-toolbelt info license

Get the list of valid countries

$ click-toolbelt info country

Get the list of valid channels

$ click-toolbelt info channel

Get the list of valid departments

$ click-toolbelt info department

Data values

Department

Valid values can be obtained via the info command (or it’s equivalent api call).

Examples

  • “Accessories”
  • “Games”
  • “Card Games”

License

Valid values can be obtained via the info command (or it’s equivalent api call).

Examples

  • “Proprietary”
  • “GNU GPL v3”
  • “BSD License (Simplified)”

Country

Valid values can be obtained via the info command (or it’s equivalent api call).

Examples

  • “AR” (Argentina)
  • “BR” (Brazil)
  • “GB” (United Kingdom)
  • “US” (United States)
  • “UY” (Uruguay)

Channel

Valid values can be obtained via the info command (or it’s equivalent api call).

Examples

  • “stable”
  • “proposed”
  • “alpha”
Release History

Release History

0.5.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.4.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
click_toolbelt-0.5.1-py2.py3-none-any.whl (108.7 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jan 8, 2016
click-toolbelt-0.5.1.tar.gz (32.2 kB) Copy SHA256 Checksum SHA256 Source Jan 8, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting