Skip to main content

Python client for CircleCI API

Project description

pycircleci

PyPI version Build Status

Python client for CircleCI API.

Based on the discontinued circleci.py project.

Features

Installation

$ pip install pycircleci

Usage

Create a personal API token.

Set up the expected env vars:

CIRCLE_TOKEN           # CircleCI API access token
CIRCLE_API_URL         # CircleCI API base url. Defaults to https://circleci.com/api
from pycircleci.api import Api, CIRCLE_TOKEN, CIRCLE_API_URL

circle_client = Api(token=CIRCLE_TOKEN, url=CIRCLE_API_URL)

# get current user info
circle_client.get_user_info()

# get list of projects
results = circle_client.get_projects()

# pretty print results as json
circle_client.ppj(results)

# pretty print the details of the last request/response
circle_client.ppr()

Interactive development console

 make console

This starts a pre-configured python interactive console which gives you access to a client object - an instance of the Api class to play around. From the console type man() to see the help screen.

Contributing

  1. Fork it
  2. Install dev dependencies (pip install -r requirements-dev.txt)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Make sure flake8 and the pytest test suite successfully run locally
  5. Commit your changes (git commit -am 'Add some feature')
  6. Push to the branch (git push origin my-new-feature)
  7. Create new Pull Request

Project details


Download files

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

Source Distribution

pycircleci-0.5.2.tar.gz (14.7 kB view hashes)

Uploaded source

Built Distribution

pycircleci-0.5.2-py3-none-any.whl (14.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page