Skip to main content

PyPI CI Codecov Documentation Supported Python versions License

Clients to interact with GetSmarter APIs.

The README.rst file should start with a brief description of the repository, which sets it in the context of other repositories under the edx organization. It should make clear where this fits in to the overall edX codebase.

Overview (please modify)

The README.rst file should then provide an overview of the code in this repository, including the main components and useful entry points for starting to understand the code in more detail.

Documentation

(TODO: Set up documentation)

Development Workflow

One Time Setup

# Clone the repository
git clone git@github.com:edx/getsmarter-api-clients.git
cd getsmarter-api-clients

# Set up a virtualenv using virtualenvwrapper with the same name as the repo and activate it
mkvirtualenv -p python3.8 getsmarter-api-clients

Every time you develop something in this repo

# Activate the virtualenv
workon getsmarter-api-clients

# Grab the latest code
git checkout main
git pull

# Install/update the dev requirements
make requirements

# Run the tests and quality checks (to verify the status before you make any changes)
make validate

# Make a new branch for your changes
git checkout -b <your_github_username>/<short_description>

# Using your favorite editor, edit the code to make your change.
vim …

# Run your new tests
pytest ./path/to/new/tests

# Run all the tests and quality checks
make validate

# Commit all your changes
git commit …
git push

# Open a PR and ask for review.

License

The code in this repository is licensed under the AGPL 3.0 unless otherwise noted.

Please see LICENSE.txt for details.

How To Contribute

Contributions are very welcome. Please read How To Contribute for details. Even though they were written with edx-platform in mind, the guidelines should be followed for all Open edX projects.

The pull request description template should be automatically applied if you are creating a pull request from GitHub. Otherwise you can find it at PULL_REQUEST_TEMPLATE.md.

The issue report template should be automatically applied if you are creating an issue on GitHub as well. Otherwise you can find it at ISSUE_TEMPLATE.md.

Reporting Security Issues

Please do not report security issues in public. Please email security@edx.org.

Getting Help

If you’re having trouble, we have discussion forums at https://discuss.openedx.org where you can connect with others in the community.

Our real-time conversations are on Slack. You can request a Slack invitation, then join our community Slack workspace.

For more information about these options, see the Getting Help page.

Change Log

Unreleased

  • Nothing unreleased

[0.6.3]

  • Logs the allocation payload sent to GEAG within the create_enterprise_allocation method.

  • Ensures the logging of the allocation payload in both create_allocation and create_enterprise_allocation methods only includes specified non-PII fields.

[0.6.2]

  • Logs the allocation payload sent to GEAG within the create_allocation method.

  • Upgrades requirements.

[0.6.1]

  • Adds an enterprise allocation cancellation method

[0.6.0]

  • Adds optional arg to create_enterprise_allocation() to either raise (current/default behavior), or not raise and fall through to returning the response. This will allow callers to do things with the response payload in error conditions.

[0.5.4]

  • Add org_id` as an optional enterprise allocation param

[0.5.3]

  • Return allocation response objects

[0.5.2]

  • Include payload in error message

[0.5.1]

  • Catch a requests.HTTPError, not an urllib.error.HTTPError.

[0.5.0] - 2023-04-12

  • Added new field for data_share_consent in enterprise_allocations

[0.4.0] - 2022-09-12

  • Add enterprise_allocations endpoint functionality to client

[0.1.0] - 2022-08-01

Added

  • First release on PyPI.

Release files for getsmarter-api-clients 0.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for getsmarter-api-clients 0.6.3
File Size Uploaded
getsmarter_api_clients-0.6.3.tar.gz 23.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for getsmarter-api-clients 0.6.3
File Interpreter ABI Platform
getsmarter_api_clients-0.6.3-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 44.3 kB

Release files / getsmarter_api_clients-0.6.3.tar.gz

Download URL getsmarter_api_clients-0.6.3.tar.gz
Size 23.9 kB
Tags Source
SHA-256 checksum
How to use checksums
8e1772ef67fb339ec61053f2874956d6e5eada8eec2ad805dd5a6fcbb359a4f8
BLAKE2b-256 checksum
How to use checksums
94c0f00bb48a29a693c86cc7c4dc6efed1f2c2f4d59f1df2a113f73c5bf3c3f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.22

Release files / getsmarter_api_clients-0.6.3-py2.py3-none-any.whl

Download URL getsmarter_api_clients-0.6.3-py2.py3-none-any.whl
Size 20.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
9df03e69b90cf54dd98e1d3cf65366a319dd11527ff74c0793888d029577641c
BLAKE2b-256 checksum
How to use checksums
ef95d18f57d4e8f06fc9953e1cd8d0e587b814731ced59d927d61f8da67a59bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.9.22

Release history Release notifications | RSS feed

This release

0.6.3 This release

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page