Skip to main content

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, Python 3.4, Python 3.5, and Python 3.6.

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.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

googleapis-artman-0.4.7.tar.gz (59.7 kB view details)

Uploaded Source

File details

Details for the file googleapis-artman-0.4.7.tar.gz.

File metadata

File hashes

Hashes for googleapis-artman-0.4.7.tar.gz
Algorithm Hash digest
SHA256 3b1acc5a078d9ce26936525d56adf5174a0216c84b1c665aba34152e9c1df924
MD5 54a4d995f3d92ec21d4c977dc802149e
BLAKE2b-256 b3e49ee9a85e8035050aab08c3f74b085a09dc952053dcdbe7ef21fbf9e11a82

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page