Skip to main content

SDK for Commercetools

Project description

This is an unofficial Python SDK for the Commercetools platform. It only supports Python 3.6+ and uses type annotation for an improved development experience.

The API is generated using the commercetools api RAML file and uses marshmallow for the serialization and deserialization.

Installation

pip install commercetools

Example

from commercetools.platform import Client

client = Client(
    client_id="<your-client-id>",
    client_secret="<your-client-secret>",
    scope=["<scopes>"],
    url="https://api.sphere.io",
    token_url="https://auth.sphere.io",
)

product = (
    client
    .with_project_key("<your-project-key>")
    .products()
    .with_id("00633d11-c5bb-434e-b132-73f7e130b4e3")
    .get())
print(product)

The client can also be configured by setting the following environment variables:

export CTP_CLIENT_SECRET="<client secret>"
export CTP_CLIENT_ID="<client id>"
export CTP_AUTH_URL="https://auth.sphere.io"
export CTP_API_URL="https://api.sphere.io"
export CTP_SCOPES="<comma seperated list of scopes>"

And then constructing a client without arguments:

from commercetools.platform import Client

client = Client()

product = (
    client
    .with_project_key("<your-project-key>")
    .products()
    .with_id("00633d11-c5bb-434e-b132-73f7e130b4e3")
    .get())

print(product)

Releasing

To release this package first (pip) install bump2version and update the CHANGES file. Then update the version (either major/minor/patch depending on the change)

bumpversion --tag <major,minor,patch>

bumpversion is naive because it string replaces, so do a sanity check it didn’t accidentally update a Pypi dependency. If not, push the code:

git push --follow-tags

We use GitHub actions so make sure the build succeeds and then go to the tags tab (https://github.com/labd/commercetools-python-sdk/tags).

Click the dots to trigger a release action. Copy the changelog items in the release description and enter the release version. This will upload the release to PyPi.

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

commercetools-14.0.0b2.tar.gz (370.2 kB view details)

Uploaded Source

Built Distribution

commercetools-14.0.0b2-py3-none-any.whl (747.4 kB view details)

Uploaded Python 3

File details

Details for the file commercetools-14.0.0b2.tar.gz.

File metadata

  • Download URL: commercetools-14.0.0b2.tar.gz
  • Upload date:
  • Size: 370.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.9.1

File hashes

Hashes for commercetools-14.0.0b2.tar.gz
Algorithm Hash digest
SHA256 17a1415253957abe50a665384dde481024d3eb0290fc092344df8393a88ca417
MD5 18674f7317cd5789353e0a6fe0c8f051
BLAKE2b-256 a5c54b8045beb006ac7d73e790e5a9ec1a2bf0fbc28e5dc4f2ad7e905fad75c4

See more details on using hashes here.

File details

Details for the file commercetools-14.0.0b2-py3-none-any.whl.

File metadata

  • Download URL: commercetools-14.0.0b2-py3-none-any.whl
  • Upload date:
  • Size: 747.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.9.1

File hashes

Hashes for commercetools-14.0.0b2-py3-none-any.whl
Algorithm Hash digest
SHA256 01a7932a4459b2b40c736f70a518fd72391ec87cb79ae3cddcaab6001e706030
MD5 d78ff468abccd3c808ef5f23636c738b
BLAKE2b-256 cf1cf558b993e4cbda0907ee338a8fec2e907ebb5f64fe4de5c23666674de5fe

See more details on using hashes here.

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