openedx-events 0.6.0

What is this project?

Open edX Events from Hooks Extensions Framework (OEP-50).

What is this project?

Overview

This repository implements the necessary tooling and definitions used by the Hooks Extension Framework to manage the events execution and extra tools.

Documentation

(TODO: Set up documentation)

Development Workflow

One Time Setup

# Clone the repository
git clone [e-mail]:edxuNEXT/openedx-events.git
cd openedx-events

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

Every time you develop something in this repo

# Activate the virtualenv
workon openedx-events

# Grab the latest code
git checkout master
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 [e-mail].

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

[0.6.0] - 2021-09-15

Added

• Add custom formatting class for events responses.

• Add a way to use send method instead of send_robust while testing.

Changed

• Remove unnecessary InstantiationError exception.

• Default is send_robust instead of send unless specified otherwise.

[0.5.1] - 2021-08-26

Changed

• Remove TestCase inheritance from OpenEdxTestMixin.

[0.5.0] - 2021-08-24

Added

• Utilities to use while testing in other platforms.

[0.4.1] - 2021-08-18

Changed

• Remove raise_exception assignment in events metadata.

[0.4.0] - 2021-08-18

Added

• Preliminary Open edX events definitions.

[0.3.0] - 2021-08-18

Added

• Add tooling needed to create and trigger events in Open edX platform.

• Add Data Attribute classes used as arguments by Open edX Events.

[0.2.0] - 2021-07-28

Changed

• Update reposirtory purpose.

• Changed max-doc-length from 79 to 120 following community recommendation.

[0.1.3] - 2021-07-01

Changed

• Update setup.cfg with complete bumpversion configuration.

[0.1.2] - 2021-06-29

Changed

• Update documentation with current organization info.

[0.1.1] - 2021-06-29

Added

• Add Django testing configuration.

[0.1.0] - 2021-04-07

Added

• First release on PyPI.