Skip to main content

API client for

Project description


PyPI PyPI - Python Version

Simple API client for SocialHub's API.



  1. clone the repo
$ git clone
$ cd socialhub
$ python3 -m venv venv
$ source venv/bin/activate
  1. install dependencies and commit-hooks
$ make devsetup
pip install -r requirements.txt -r
Collecting requests==2.23.* (from -r requirements.txt (line 1))
  Using cached
  Running install for pyyaml ... done
  Running install for distlib ... done
  Running install for wrapt ... done
Successfully installed appdirs-1.4.3 aspy.yaml-1.3.0 (...)
pre-commit install --overwrite --install-hooks
pre-commit installed at .git/hooks/pre-commit


We're using py.test. You can run all of the tests on all supported python releases using make test. If you don't have that much time, try make quicktest, which runs py.test directly.

API Requests

The tests make use of vcrpy, which records all requests to the SocialHub APIs into the socialhub/cassette directory. As long as you don't add any, this enables you to run the existing tests without having access to these (private) APIs.

To delete the recorded data and get fresh version, run the following command. Inspect the resuling cassettes for secret leaks.

$ make recordvcr

Releasing a new version

Assuming you have been handed the required credentials, a new version can be released as follows.

  1. adapt the version in, according to semver_.
  2. commit this change as Version 1.2.3
  3. tag the resulting commit as v1.2.3
  4. push the new tag as well as the master branch
  5. update the package on PyPI:
$ make build
$ make upload


This API client is not developed, endorsed or validated by SocialHub or its developer maloon GmbH. The name "SocialHub" is owned by maloon GmbH, not by the authors of this library.

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

socialhub-0.2.1.tar.gz (5.8 kB view hashes)

Uploaded source

Built Distribution

socialhub-0.2.1-py3-none-any.whl (4.4 kB view hashes)

Uploaded py3

Supported by

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