feat: Add manufacture_data django command

test: Fix test configuration

test: improve test coverage

test: case for nonstandard model casing

test: more coverage

docs: Add documentation for manufacture_data

CHANGELOG.rst

@@ -11,6 +11,13 @@ Change Log
 
 .. There should always be an "Unreleased" section for changes pending release.
 
+[5.10.0] - 2023-12-11
+--------------------
+
+Added
+~~~~~
+* manufacture_data management command
+
 [5.9.0] - 2023-11-27
 --------------------
 

README.rst

@@ -23,13 +23,12 @@ This repository includes shared utilities for:
 
 * `Logging Utilities`_: Includes log filters and an encrypted logging helper.
 
-* `Monitoring Utilities`_: Includes Middleware and utilities for enhanced monitoring.
-  At this time, supports NewRelic monitoring.
-
 * `Plugin Infrastructure`_: Enables enhanced Django Plugin capabilities.
 
 * `Security Utilities`_: Includes a middleware to add CSP response headers.
 
+* `Data Generation`_: Management command for generating Django data based on model factories.
+
 .. _Cache Utilities: edx_django_utils/cache/README.rst
 
 .. _Django User and Group Utilities: edx_django_utils/user/README.rst
@@ -44,6 +43,8 @@ This repository includes shared utilities for:
 
 .. _Security Utilities: edx_django_utils/security/README.rst
 
+.. _Data Generation: edx_django_utils/data_generation/README.rst
+
 Documentation
 -------------
 

edx_django_utils/data_generation/README.rst

@@ -0,0 +1,74 @@
+Django Data Generation
+######################
+
+
+Setup
+=====
+Add 'edx_django_utils.data_generation' to `INSTALLED_APPS`
+
+Usage
+=====
+
+(Using https://github.com/openedx/edx-enterprise/blob/master/enterprise/models.py through Devstack as an example)
+
+Generating Basic Model
+----------------------
+Upon invoking the command, supply a model param (--model) that is a complete path to a model that has a corresponding test factory:
+
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomer`
+
+This will generate an enterprise customer record with place holder values according to the test factory
+
+Customizing Model Values
+------------------------
+We can also provide customizations to the record being generated:
+
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomer --name "FRED"`
+
+	'EnterpriseCustomer' fields: {'name': 'FRED'}
+
+We can supply parent model/subfactory customizations as well:
+
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomerCatalog --enterprise_customer__site__name "Fred" --enterprise_catalog_query__title "JOE SHMO" --title "who?"`
+
+	'EnterpriseCustomerCatalog' fields: {'title': 'who?'}
+		'EnterpriseCustomer' fields: {}
+			'Site' fields: {'name': 'Fred'}
+
+		'EnterpriseCatalogQuery' fields: {'title': 'JOE SHMO'}
+
+Note the non subclass customization --title "who?" is applied to the specified model EnterpriseCustomerCatalog
+
+Customizing Foreign Keys
+------------------------
+Say we want to supply an existing record as a FK to our object:
+
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomerUser --enterprise_customer 994599e6-3787-48ba-a2d1-42d1bdf6c46e`
+
+	'EnterpriseCustomerUser' fields: {}
+		'EnterpriseCustomer' PK: 994599e6-3787-48ba-a2d1-42d1bdf6c46e
+
+or we can do something like:
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomerUser --enterprise_customer__site 9 --enterprise_customer__name "joe"`
+
+	'EnterpriseCustomerUser' fields: {}
+		'EnterpriseCustomer' fields: {'name': 'joe'}
+			'Site' PK: 9
+
+Unsupported Cases
+-----------------
+One limitation of this script is that it can only fetch or customize, you cannot customize a specified, existing FK:
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomerUser --enterprise_customer__site__name "fred" --enterprise_customer 994599e6-3787-48ba-a2d1-42d1bdf6c46e`
+
+which would yield a
+`CommandError: This script does not support customizing provided existing objects`
+
+Error Cases
+-----------
+
+If you try and get something that doesn't exist:
+
+`./manage.py lms manufacture_data --model enterprise.models.EnterpriseCustomerUser --enterprise_customer <invalid uuid>`
+
+we'd get:
+`CommandError: Provided FK value: <SOMETHING BAD> does not exist on EnterpriseCustomer`