Various Django utility functions
Project description
Boxine - bx_django_utils
Various Django utility functions
Quickstart
pip install bx_django_utils
Existing stuff
Here only a simple list about existing utilities. Please take a look into the sources and tests for deeper informations.
models utilities
approve_workflow
- Base model/admin/form classes to implement a model with draft/approve versions workflowmanipulate.create_or_update()
- Similar to django'screate_or_update()
with benefitstimetracking.TimetrackingBaseModel()
- Base model with "create" and "last update" date time
data types
data_types.gtin
- ModelField, FormField and validators for GTIN/UPC/EAN numbers, more info: data_types/gtin/README.md
test utilities
datetime.MockDatetimeGenerator()
- Mock djangotimezone.now()
with generic time stampshtml_assertion.HtmlAssertionMixin
- Unittest mixin class with usefull assertments around Django test client testsmodel_clean_assert.CleanMock()
- Context manager to track if modelfull_clean()
was calledusers
- Utilities around user/permission setup for teststime.MockTimeMonotonicGenerator()
- Mocktime.monotonic()
with generic time stampsAssertQueries()
- Context manager with different checks of made database queries
performance analysis
dbperf.query_recorder.SQLQueryRecorder
- Context Manager that records SQL queries executed via the Django ORM
humanize
humanize.time.human_timedelta()
- Converts a time duration into a friendly text representation. (X ms
,sec
,minutes
etc.)templatetags.humanize_time.human_duration()
- Verbose time since template tag, e.g.:<span title="Jan. 1, 2000, noon">2.0 seconds</span>
filename.filename2human_name()
- Convert filename to a capitalized namefilename.clean_filename()
- Convert filename to ASCII only via slugifypformat()
- Betterpretty-print-format
usingDjangoJSONEncoder
with fallback topprint.pformat()
view utilities
view_utils.dynamic_menu_urls.DynamicViewMenu()
- Register views to build a simple menu with sections
misc
stacktrace.get_stacktrace()
- Returns a filterable and easy-to-process stacktrace
developing
To start developing e.g.:
~$ git clone https://github.com/boxine/bx_django_utils.git
~$ cd bx_django_utils
~/bx_django_utils$ make
help List all commands
install-poetry install or update poetry
install install via poetry
update Update the dependencies as according to the pyproject.toml file
lint Run code formatters and linter
fix-code-style Fix code formatting
tox-listenvs List all tox test environments
tox Run pytest via tox with all environments
tox-py36 Run pytest via tox with *python v3.6*
tox-py37 Run pytest via tox with *python v3.7*
tox-py38 Run pytest via tox with *python v3.8*
tox-py39 Run pytest via tox with *python v3.9*
pytest Run pytest
pytest-ci Run pytest with CI settings
publish Release new version to PyPi
makemessages Make and compile locales message files
start-dev-server Start Django dev. server with the test project
clean Remove created files from the test project (e.g.: SQlite, static files)
You can start the test project with the Django developing server, e.g.:
~/bx_django_utils$ make start-dev-server
This is a own manage command, that will create migrations files from our test app, migrate, collectstatic and create a super user if no user exists ;)
If you like to start from stretch, just delete related test project files with:
~/bx_django_utils$ make clean
...and start the test server again ;)
License
MIT. Patches welcome!
Links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
bx_django_utils-1.tar.gz
(27.2 kB
view hashes)
Built Distribution
Close
Hashes for bx_django_utils-1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85982fc851d83ad652123ec85c855685b2cc4031613bf9428f09ba6b9d9f8984 |
|
MD5 | fe6ceeb6c15d281d4ce20530489c8595 |
|
BLAKE2b-256 | 0f338960e8571f45af6d57347a020f907f26edffd8a56dc6048792210427d814 |