python license函数_bx-py-utils-各种Python/Django实用程序函数-Jens Diemer Quickstart Existing stuff developing ...

作者:Jens Diemer

### 作者邮箱:jens.diemer@boxine.de

### 首页:

### 文档:None

### 下载链接

# Boxine - bx_py_utils

Various Python / Django utility functions

Quickstart

pip install bx_py_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 workflow

manipulate.create_or_update() - Similar to django's create_or_update() with benefits

timetracking.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 django timezone.now() with generic time stamps

datetime.parse_dt() - Handy datetime.strptime() convert

html_assertion.HtmlAssertionMixin - Unittest mixin class with usefull assertments around Django test client tests

model_clean_assert.CleanMock() - Context manager to track if model full_clean() was called

users - Utilities around user/permission setup for tests

time.MockTimeMonotonicGenerator() - Mock time.monotonic() with generic time stamps

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.: 2.0 seconds

filename.filename2human_name() - Convert filename to a capitalized name

filename.clean_filename() - Convert filename to ASCII only via slugify

misc

dict_utils.dict_get() - nested dict get()

dict_utils.pluck() - Extract values from a dict, if they are present

error_handling.print_exc_plus() - Print traceback information with a listing of all the local variables in each frame

stacktrace.get_stacktrace() - Returns a filterable and easy-to-process stacktrace

developing

To start developing e.g.:

~$ git clone https://github.com/boxine/bx_py_utils.git

~$ cd bx_py_utils

~/bx_py_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_py_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_py_utils$ make clean

...and start the test server again ;)

License

MIT. Patches welcome!

Links

https://pypi.org/project/bx-py-utils/

Copy from pypi.org