Skip to main content

Library and utilities for feature toggles

Project description

PyPI Travis Codecov Documentation Supported Python versions License

Library and utilities for feature toggles. This repo is intended to house a utility for enhanced feature toggle management in Django apps used throughout the edX ecosystem. Currenty, it only contains some scripts for reporting on the status of feature toggles. See the scripts README for more information.

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 Open edX code in general.

PR description template should be automatically applied if you are sending PR from github interface; otherwise you can find it it at PULL_REQUEST_TEMPLATE.md

Issue report template should be automatically applied if you are sending it from github UI 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

Have a question about this repository, or about Open edX in general? Please refer to this list of resources if you need any assistance.

Change Log

[1.2.0] - 2020-11-05

  • Start the deprecation process of the waffle namespace classes:

    • Introduce LegacyWaffleFlag, LegacyWaffleSwitch for use with namespaces.

    • Begin deprecation/refactoring of namespacing code, including deprecation monitoring and warnings.

    • Note: WaffleFlag and WaffleSwitch still use namespaces as well (for now).

    • Introduce the toggles.__future__ module for applications that need to be forward-compatible right away.

[1.1.1] - 2020-10-27

  • Fix cache-checking in WaffleSwitchNamespace

[1.1.0] - 2020-10-23

  • Backport override_waffle_switch test utility function from edx-platform

[1.0.0] - 2020-10-13

  • Fix missing module_name argument in SettingDictToggle constructor.

  • Extract waffle classes from edx-platform and move them here following ADR #2, #3, #4. This does not introduce backward-incompatible changes, yet.

  • Fix pinned requirements and incorrect root url that overrode edx-platform’s.

[0.3.0] - 2020-09-23

First release to PyPI (2020-10-02)

  • Implement SettingToggle and SettingDictToggle.

[0.2.2] - 2020-09-11

  • Document the writing of feature toggles annotations.

[0.2.1] - 2020-08-03

  • Add ADR for the purpose of this repository.

  • Add ADR for implementing a Toggle State endpoint.

  • Add toggles report with CSV output using new CsvRenderer.

  • Add CourseWaffleFlag and course override data to toggle report.

  • Add output for waffle flag course overrides to data gatherer

  • Add additional options to scripts/feature_toggle_report_generator

    • filter toggle types and envs, add github_url, and change name of ida in report

  • Modified scripts/feature_toggle_report_generator to work based on envs

  • Removed confluence integration

  • Moved HtmlRenderer to its own file

  • Add ADR for new SettingToggle. (see 0003-django-setting-toggles.rst)

[0.2.0] - 2020-05-27

  • Removed caniusepython3.

[0.2.0] - 2020-05-05

  • Added support for python 3.8 and dropped support Django versions older than 2.2

[0.1.0] - 2019-04-08

  • Initial version

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

edx-toggles-1.2.0.tar.gz (27.3 kB view hashes)

Uploaded Source

Built Distribution

edx_toggles-1.2.0-py2.py3-none-any.whl (31.2 kB view hashes)

Uploaded Python 2 Python 3

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