SQLALchemy JSONField implementation for storing dicts at SQL
Project description
SQLAlchemy_JSONField
SQLALchemy JSONField implementation for storing dicts at SQL independently from JSON type support.
Why?
SqlAlchemy provides JSON field support for several database types (PostgreSQL and MySQL for now) and semi-working dict <-> JSON <-> VARCHAR example, but… In real scenarios we have tests on sqlite, production on MySQL/MariaDB/Percona/PostgreSQL and some of them (modern Oracle MySQL & PostgreSQL) support JSON, some of them (SQLite, Percona & MariaDB) requires data conversion to Text (not VARCHAR).
As addition, we have different levels of Unicode support on database and connector side, so we may be interested to switch JSON encoding between deployments.
Solution:
SQLALchemy JSONField has API with suport for automatic switch between native JSON and JSON encoded data, and encoding to JSON string can be enforced.
Pros:
Free software: Apache license
Open Source: https://github.com/penguinolog/sqlalchemy_jsonfield
Self-documented code: docstrings with types in comments
Uses native JSON, if possible
Support miltiple Python versions:
Python 2.7 Python 3.4 Python 3.5 Python 3.6 PyPy PyPy3
Usage
Direct usage with MariaDB (example extracted from functional tests):
import sqlalchemy_jsonfield
class ExampleTable(Base):
__tablename__ = table_name
id = sqlalchemy.Column(sqlalchemy.Integer, primary_key=True)
row_name = sqlalchemy.Column(
sqlalchemy.Unicode(64),
unique=True,
)
json_record = sqlalchemy.Column(
sqlalchemy_jsonfield.JSONField(
# MariaDB does not support JSON for now
enforce_string=True,
# MariaDB connector requires additional parameters for correct UTF-8
enforce_unicode=False
),
nullable=False
)
Usage on PostgreSQL/Oracle MySQL(modern version)/SQLite(testing) environments allows to set enforce_string=False and use native JSON fields.
Testing
The main test mechanism for the package sqlalchemy_jsonfield is using tox. Test environments available:
pep8 py27 py34 py35 py36 pypy pypy3 pylint docs
CI systems
For code checking several CI systems is used in parallel:
Travis CI: is used for checking: PEP8, pylint, bandit, installation possibility and unit tests. Also it’s publishes coverage on coveralls.
coveralls: is used for coverage display.
Circle CI: is used for functional tests at separate docker infrastructure. This CI used for HUGE tests.
CD system
Travis CI: is used for package delivery on PyPI.
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
Built Distribution
File details
Details for the file SQLAlchemy_JSONField-0.6.1.tar.gz
.
File metadata
- Download URL: SQLAlchemy_JSONField-0.6.1.tar.gz
- Upload date:
- Size: 10.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4bda2934a1e8fdc36c82f8732d9291874b422f4630b0f4a08e4f94cb3ccddaff |
|
MD5 | 5365301fa0449f65cc63e2aa8a937d93 |
|
BLAKE2b-256 | f557c289c0d8fdd2357c833febe4867ced949c1f82cbedb17b932289f5fad1b2 |
File details
Details for the file SQLAlchemy_JSONField-0.6.1-py2.py3-none-any.whl
.
File metadata
- Download URL: SQLAlchemy_JSONField-0.6.1-py2.py3-none-any.whl
- Upload date:
- Size: 7.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9bda0ceaf5a5676fcdf47250437eee28010de1af59186a3dac87753097764839 |
|
MD5 | 779154627f1cf676ff7d10010f3841aa |
|
BLAKE2b-256 | f119e5a0aba6aa3748cbc08258c17632f39fe700618bcb8776ee0ba00469fde3 |