edx-django-utils 3.9.0

EdX utilities for Django Application development.

EdX utilities for Django Application development.

Note that some utilities may warrant their own repository. A judgement call needs to be made as to whether code properly belongs here or not. Please review with the Architecture Team if you have any questions.

Overview

This repository includes shared utilities for:

• Cache Utilities: Includes a RequestCache and a TieredCache.

• Monitoring Utilities: Includes Middleware and utilities for enhanced monitoring. At this time, supports NewRelic monitoring.

• Plugin Infrastructure: Enables enhanced Django Plugin capabilities.

Documentation

The full documentation is in the docs directory.

TODO: Publish to https://edx-django-utils.readthedocs.org.

Design Pattern followed by packages

All tools in edx_django_utils should expose their public api in their __init__.py files. This entails adding to __init__.py all functions/classes/constants/objects that are intended to be used by users of library.

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 [e-mail].

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

Unreleased

[3.9.0] - 2020-10-21

Updated

• Exposed existing get_code_owner_from_module via the public api.

• Fixed get_code_owner_from_module to not require a call to is_code_owner_mappings_configured beforehand.

• Set the existing code_owner_path_module custom attribute, even for cases where the transaction name was used, rather than the view module.

• Refactor code owner setting processing.

[3.8.0] - 2020-08-31

Updated

• Renamed “custom metric” to “custom attribute” throughout the monitoring library. This decision can be read about in the ADR 0002-custom-monitoring-language.rst. The following have been deprecated:

  • set_custom_metric (use set_custom_attribute)

  • set_custom_metrics_for_course_key (use set_custom_attributes_for_course_key)

  • MonitoringCustomMetricsMiddleware (use CachedCustomMonitoringMiddleware)

  • CachedCustomMonitoringMiddleware.accumulate_metric (use CachedCustomMonitoringMiddleware.accumulate_attribute)

    • This wasn’t meant to be used publicly, but was deprecated just in case.

  • CodeOwnerMetricMiddleware (use CodeOwnerMonitoringMiddleware)

[3.7.4] - 2020-08-29

• Fix to custom monitoring accumulate to actually accumulate rather than overwrite.

[3.7.3] - 2020-08-12

Updated

• Upgrade psutil to latest version

[3.7.2] - 2020-08-10

Updated

• Added missing classes to plugins public api. See plugins.__init__.py for latest api.

• Updated plugin method names to be more descriptive. See plugins.__init__.py for latest.

Note

Although these changes are backwards incompatible, they are being added as a bug fix because plugins code release (3.7.0) is not yet in use.

[3.7.1] - 2020-08-10

Updated

• Exposing all public functions in edx_django_utils/plugins directory in its __init__.py file.

  • this was done to keep inline with standard/pattern used in other packages in edx_django_utils

[3.7.0] - 2020-08-10

Added

• Adding Plugin infrastructure

  • Allows IDAs to use plugins

[3.6.0] - 2020-08-04

Added

• Improved documentation for CodeOwnerMetricMiddleware, including a how_tos/add_code_owner_custom_metric_to_an_ida.rst for adding it to a new IDA.

• Added ignore_transaction monitoring utility to ignore transactions we don’t want tracked.

Updated

• Moved transaction-related monitoring code into it’s own file. Still exposed through __init__.py so it’s a non-breaking change.

[3.5.0] - 2020-07-22

Updated

• Added a catch-all capability to CodeOwnerMetricMiddleware when CODE_OWNER_MAPPINGS includes a ‘*’ as a team’s module. The catch-all is used only if there is no other match.

[3.4.0] - 2020-07-20

Added

• Added get_current_transaction for monitoring that returns a transaction object with a name property.

Updated

• Updated CodeOwnerMetricMiddleware to use NewRelic’s current transaction for cases where resolve() doesn’t work to determine the code_owner, like for Middleware.

[3.3.0] - 2020-07-16

Added

• CodeOwnerMetricMiddleware was moved here (from edx-platform) in order to be able to take advantage of the code_owner metric in other IDAs. For details on this decision, see the ADR for monitoring code owner. See the docstring for more details on usage.

[3.2.3] - 2020-05-30

• Removed ceninusepy3 usage.

[3.2.2] - 2020-05-04

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

[3.2.1] - 2020-04-17

Changed

• imported get_cache_key in cache/__init__.py.

[3.2.0] - 2020-04-09

Added

• Added get_cache_key utility.

[2.0.1] - 2019-10-09

Changed

• Fixed: Updated function tracing to accomodate changes in New Relic’s 5.x Agent.

[2.0.0] - 2019-07-07

Changed

• Converted Middleware (from old style MIDDLEWARE_CLASSES to MIDDLEWARE).

• Removed support for Django versions < 1.11

[1.0.1] - 2018-09-07

Changed

• Fixed: RequestCache now properly uses thread.local.

• Fixed: CachedResponse.__repr__ now handles unicode.

[1.0.0] - 2018-08-28

Added

• Add data dict property to better match legacy RequestCache interface.

Changed

• Change is_hit/is_miss to is_found.

[0.5.1] - 2018-08-17

Changed

• Fixed bug in TieredCacheMiddleware dependency declaration.

[0.5.0] - 2018-08-16

Changed

• Restored Python 3 support.

• Refactor/clean-up, including Middleware dependency checking.

• Docs updates and other cookiecutter updates.

[0.4.1] - 2018-08-10

Changed

• Split out TieredCacheMiddleware from RequestCacheMiddleware.

[0.4.0] - 2018-08-10

Changed

• Rename CacheUtilsMiddleware to RequestCacheMiddleware.

[0.3.0] - 2018-08-02

Removed

• Temporarily dropped Python 3 support to land this.

[0.2.0] - 2018-08-01

Added

• Added cache and monitoring utilities.

[0.1.0] - 2018-07-23

Added

• First release on PyPI.