Skip to main content
Help us improve Python packaging – donate today!

Google API artifact manager

Project Description

Google API Artifact manager (artman) is a set of modules used to automate the creation of software artifacts related to APIS defined using protobuf IDL.

artman is an extensible framework that is responsible for creating all artifacts related to an API including

  • distribution packages in all supported programming languages
  • generic documentation websites
  • language-specific documentation websites (javadoc, readthedocs, etc)

from the protobuf source IDL and additional configuration in YAML files.

Installation

  1. Optional: set up a virtualenv for your Python work. Choose one of the following:

    1. (recommended) virtualenvwrapper so you don’t have to keep track of where your virtualenv is on the filesystem:

      sudo pip install virtualenv virtualenvwrapper
      mkvirtualenv --python=`which python3` artman
      

      To use this virtual environment later:

      workon artman
      
    2. virtualenv in your current directory:

      sudo pip install virtualenv
      virtualenv env
      source env/bin/activate
      
  2. Install artman directly from pip:

    pip install googleapis-artman
    

You may need root privileges if you are not installing inside of a virtualenv. This will make the artman command available on your system.

Prerequisites

  1. Install googleapis
  2. Install toolkit
  3. Install Java
  4. Some languages may have additional dependencies; refer to the Dockerfile in this repository for canonical installation requirements.

Usage

Before you can use artman, you will need a configuration file. You can run configure-artman to create a simple configuration file.

For building a GAPIC (the most common task), the usage looks like:

artman --api pubsub --language python

Artman also takes a --publish argument to decide where to stage the code. Using --publish github will create a pull request on GitHub automatically.

Python Versions

artman is currently tested with Python 2.7 and Python 3.4.

Contributing

Contributions to this library are always welcome and highly encouraged.

See the CONTRIBUTING documentation for more information on how to get started.

Versioning

This library follows Semantic Versioning

It is currently in major version zero (0.y.z), which means that anything may change at any time and the public API should not be considered stable.

Details

For detailed documentation of the modules in artman, please watch DOCUMENTATION.

License

BSD - See LICENSE for more information.

Release history Release notifications

History Node

0.8.0

History Node

0.7.1

History Node

0.7.0

History Node

0.6.0

History Node

0.5.7

History Node

0.5.6

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.20

History Node

0.4.19

History Node

0.4.18

History Node

0.4.17

History Node

0.4.16

History Node

0.4.15

History Node

0.4.14

History Node

0.4.13

History Node

0.4.12

History Node

0.4.11

History Node

0.4.10

History Node

0.4.9

History Node

0.4.8

History Node

0.4.7

History Node

0.4.6

History Node

0.4.5

History Node

0.4.4

History Node

0.4.3

This version
History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.1

History Node

0.3.0

History Node

0.2.1

History Node

0.2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
googleapis-artman-0.4.2.tar.gz (45.3 kB) Copy SHA256 hash SHA256 Source None May 19, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page