Skip to main content

Collection of small utilities for Django and Django REST framework projects

Project description

django-jutil

Collection of small utilities for Django and Django REST framework projects. Django 3.0 compatible.

[![codecov](https://codecov.io/gh/kajala/django-jutil/branch/master/graph/badge.svg)](https://codecov.io/gh/kajala/django-jutil) [![Build Status](https://travis-ci.org/kajala/django-jutil.svg?branch=master)](https://travis-ci.org/kajala/django-jutil)

Features

  • Simplified admin changes history logging (admin_log)

  • ModelAdmin with length limited history view (ModelAdminBase)

  • Simplified object URL/link generation within admin (admin_obj_link and admin_obj_url)

  • Extended admin log mixin of changed fields (AdminLogEntryMixin)

  • Admin file download mixin with file permission checks (AdminFileDownloadMixin)

  • User authentication helpers (require_auth, AuthUserMixin)

  • Mixin for cached model fields management (CachedFieldsMixin)

  • BaseCommand extension which catches, logs and emails errors (SafeCommand)

  • Command options for simplified handling of date ranges (add_date_range_arguments, parse_date_range_arguments)

  • Various utilities for date ranges generation and iteration (dates.py)

  • Utilities for dict sorting and formatting, choices list label fetching (dict.py)

  • Simplified email sending via SendGrid API (send_email)

  • Various formatting utilities (e.g. XML, timedelta, Decimal)

  • Decimal encoder for encoding JSON objects/dictionaries containing Decimal instances (SimpleDecimalEncoder)

  • Django middleware for exception logging/emailing (LogExceptionMiddleware)

  • Django middleware for language cookie handling (EnsureLanguageCookieMiddleware)

  • Django middleware for user.profile.timezone based timezone activation

  • Utilities or Django Model handling (e.g. clone_model, get_object_or_none)

  • Utilities for parsing booleans and datetime values (using pytz)

  • Simple user field based permission checking for REST APIs (permissions.py)

  • Geo IP / IP info functions using IPStack API (request.py)

  • Download responses (FileSystemFileResponse and CsvFileResponse)

  • Simple SMS sending (send_sms)

  • Mixin for basic test user setup (DefaultTestSetupMixin)

  • Pretty good unit test coverage (tests.py)

  • URL modifying/comparison functions (urls.py)

  • Validators and filters for various types (validators.py)

  • XML Element to/from dict conversions (dict_to_element, xml_to_dict)

  • XML file/content pretty formatting (format_xml, format_xml_bytes, format_xml_file, FormattedXmlResponse)

Install

pip install django-jutil

Static Code Analysis

The library passes both prospector and mypy checking. To install:

pip install prospector pip install mypy

To analyze:

prospector mypy .

Test Code Coverage

  • coverage run manage.py; coverage report

Changes

3.0.0: + Django 3.0.4 compatibility

2.4.14: + Unit test improvements etc.

2.3.2: + Prospector clean & checked when making new release

2.3.1: + Cleanup related to prospector results (https://pypi.org/project/prospector/)

2.2.42: + ElementTree usage cleanup

2.2.38: + Added FormattedXmlResponse

2.2.37: + Added format_xml_bytes

2.2.35: + Some clearing code fixes for Sweden

2.2.31: + Added various sanitizer-functions where simple validation is too strict

2.2.25: + Added fi_ssn_generator (fake/test Finnish social security numbers)

2.2.22: + Some localization improvements

2.2.17: + Added format_xml_file, format_xml

2.2.14: + More unit tests

2.2.12: + Added admin_obj_link and admin_obj_url

2.2.11: + Sweden bank info fixes

2.2.8: + Denmark bank info

2.2.7: + More unit tests

2.2.6: + IBAN validation of more or less all IBAN countries

2.2.5: + Belgium IBAN validator

2.2.3: + ElementTree import cleanup (thanks to https://github.com/kutera)

2.2.0: + Belgium IBAN validation support (thanks to https://github.com/kutera)

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

django-jutil-3.4.4.tar.gz (374.9 kB view hashes)

Uploaded Source

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