Merge a1cdc8d into 060139f

.github/workflows/test.yml

@@ -72,8 +72,8 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install pip-tools
-        pip-compile examples/requirements/${{ matrix.requirements }}.in
-        pip install -r examples/requirements/${{ matrix.requirements }}.txt
+        pip-compile examples/requirements/${{ matrix.requirements }}_and_flask.in
+        pip install -r examples/requirements/${{ matrix.requirements }}_and_flask.txt
         pip-compile examples/requirements/test.in
         pip install -r examples/requirements/test.txt
     - name: Run Tests

.gitignore

@@ -45,6 +45,6 @@ profiler.py.prof
 /examples/static/
 /examples/django_example/project/db.sqlite3
 /examples/django_example/project/static/
-/examples/sqlalchemy_example/
+/examples/sqlalchemy_example/admin/sample_db.sqlite
 
 var/

CHANGELOG.rst

@@ -15,6 +15,12 @@ are used for versioning (schema follows below):
   0.3.4 to 0.4).
 - All backwards incompatible changes are mentioned in this document.
 
+0.3.2
+-----
+2021-07-12
+
+- Add basic SQLAlchemy support.
+
 0.3.1
 -----
 2021-07-01

README.rst

@@ -47,6 +47,8 @@ Prerequisites
 - Core package requires Python 3.6, 3.7, 3.8 or 3.9.
 - Django integration package (``valuta.contrib.django_integration``) requires
   Django 2.2, 3.0, 3.1 or 3.2.
+- SQLAlchemy integration package (``valuta.contrib.sqlalchemy_integration``)
+  has been tested with SQLAlchemy 1.4.x.
 
 Documentation
 =============
@@ -688,6 +690,11 @@ Sample template tags renderer
         "template_tag_price_display_in_currency_units.html", {"instance": instance}
     )
 
+SQLAlchemy integration
+----------------------
+Similarly to Django integration package, the SQLAlchemy integration package is
+a simple ``CurrencyType`` representing the ISO-4217 codes of the currencies.
+
 Supported currencies
 ====================
 Currencies marked with `(*)` are custom (added manually). The rest is obtained

examples/django_example/README.rst

@@ -0,0 +1,4 @@
+=====================================
+Django example project for ``valuta``
+=====================================
+*Used to demonstrate admin features a well as for testing.*

examples/requirements/dev.txt

@@ -1,8 +1,8 @@
 #
-# This file is autogenerated by pip-compile with python 3.6
+# This file is autogenerated by pip-compile
 # To update, run:
 #
-#    pip-compile examples/requirements/dev.in
+#    pip-compile dev.in
 #
 appdirs==1.4.4
     # via virtualenv
@@ -11,7 +11,7 @@ asgiref==3.3.4
 attrs==21.2.0
     # via pytest
 babel==2.9.1
-    # via -r examples/requirements/common.in
+    # via -r common.in
 bleach==3.3.0
     # via readme-renderer
 certifi==2021.5.30
@@ -26,25 +26,25 @@ colorama==0.4.4
     # via twine
 coverage[toml]==5.5
     # via
-    #   -r examples/requirements/test.in
+    #   -r test.in
     #   pytest-cov
 cryptography==3.4.7
     # via secretstorage
 distlib==0.3.2
     # via virtualenv
+django-debug-toolbar==3.2.1
+    # via -r django_3_2.in
 django==3.2.4
     # via
-    #   -r examples/requirements/django_3_2.in
+    #   -r django_3_2.in
     #   django-debug-toolbar
-django-debug-toolbar==3.2.1
-    # via -r examples/requirements/django_3_2.in
 docutils==0.17.1
     # via readme-renderer
 factory_boy==2.11.1
-    # via -r examples/requirements/test.in
+    # via -r test.in
 faker==8.1.4
     # via
-    #   -r examples/requirements/test.in
+    #   -r test.in
     #   factory-boy
 filelock==3.0.12
     # via
@@ -80,7 +80,7 @@ packaging==20.9
 pep517==0.10.0
     # via pip-tools
 pip-tools==6.1.0
-    # via -r examples/requirements/deployment.in
+    # via -r deployment.in
 pkginfo==1.7.0
     # via twine
 pluggy==0.13.1
@@ -89,7 +89,7 @@ pluggy==0.13.1
     #   tox
 py==1.10.0
     # via
-    #   -r examples/requirements/test.in
+    #   -r test.in
     #   pytest
     #   tox
 pycparser==2.20
@@ -98,21 +98,21 @@ pygments==2.9.0
     # via readme-renderer
 pyparsing==2.4.7
     # via packaging
+pytest-cov==2.12.0
+    # via -r test.in
+pytest-django==4.3.0
+    # via -r test.in
+pytest-ordering==0.6
+    # via -r test.in
+pytest-pythonpath==0.7.3
+    # via -r test.in
 pytest==6.2.4
     # via
-    #   -r examples/requirements/test.in
+    #   -r test.in
     #   pytest-cov
     #   pytest-django
     #   pytest-ordering
     #   pytest-pythonpath
-pytest-cov==2.12.0
-    # via -r examples/requirements/test.in
-pytest-django==4.3.0
-    # via -r examples/requirements/test.in
-pytest-ordering==0.6
-    # via -r examples/requirements/test.in
-pytest-pythonpath==0.7.3
-    # via -r examples/requirements/test.in
 python-dateutil==2.8.1
     # via faker
 pytz==2021.1
@@ -121,12 +121,12 @@ pytz==2021.1
     #   django
 readme-renderer==29.0
     # via twine
+requests-toolbelt==0.9.1
+    # via twine
 requests==2.25.1
     # via
     #   requests-toolbelt
     #   twine
-requests-toolbelt==0.9.1
-    # via twine
 rfc3986==1.5.0
     # via twine
 secretstorage==3.3.1
@@ -151,11 +151,11 @@ toml==0.10.2
     #   pytest
     #   tox
 tox==3.23.1
-    # via -r examples/requirements/test.in
+    # via -r test.in
 tqdm==4.61.1
     # via twine
 twine==3.4.1
-    # via -r examples/requirements/deployment.in
+    # via -r deployment.in
 typing-extensions==3.10.0.0
     # via
     #   asgiref

examples/requirements/django_2_2_and_flask.in

@@ -0,0 +1,6 @@
+-r common.in
+-r test.in
+-r flask.in
+
+Django>=2.2,<3.0
+django-debug-toolbar>=3.2,<3.3

examples/requirements/django_2_2_and_flask.txt

@@ -0,0 +1,154 @@
+#
+# This file is autogenerated by pip-compile
+# To update, run:
+#
+#    pip-compile django_2_2_and_flask.in
+#
+appdirs==1.4.4
+    # via virtualenv
+attrs==21.2.0
+    # via pytest
+babel==2.9.1
+    # via
+    #   -r common.in
+    #   flask-babelex
+click==8.0.1
+    # via flask
+coverage[toml]==5.5
+    # via
+    #   -r test.in
+    #   pytest-cov
+dataclasses==0.8
+    # via werkzeug
+distlib==0.3.2
+    # via virtualenv
+django-debug-toolbar==3.2.1
+    # via -r django_2_2_and_flask.in
+django==2.2.24
+    # via
+    #   -r django_2_2_and_flask.in
+    #   django-debug-toolbar
+factory_boy==2.11.1
+    # via -r test.in
+faker==8.1.4
+    # via
+    #   -r test.in
+    #   factory-boy
+filelock==3.0.12
+    # via
+    #   tox
+    #   virtualenv
+flask-admin==1.5.8
+    # via -r flask.in
+flask-babelex==0.9.4
+    # via -r flask.in
+flask-sqlalchemy==2.5.1
+    # via -r flask.in
+flask-testing==0.8.1
+    # via -r flask.in
+flask==2.0.1
+    # via
+    #   -r flask.in
+    #   flask-admin
+    #   flask-babelex
+    #   flask-sqlalchemy
+    #   flask-testing
+greenlet==1.1.0
+    # via sqlalchemy
+importlib-metadata==4.6.1
+    # via
+    #   click
+    #   pluggy
+    #   pytest
+    #   sqlalchemy
+    #   tox
+    #   virtualenv
+importlib-resources==5.2.0
+    # via virtualenv
+iniconfig==1.1.1
+    # via pytest
+itsdangerous==2.0.1
+    # via flask
+jinja2==3.0.1
+    # via
+    #   flask
+    #   flask-babelex
+markupsafe==2.0.1
+    # via
+    #   jinja2
+    #   wtforms
+packaging==21.0
+    # via
+    #   pytest
+    #   tox
+pluggy==0.13.1
+    # via
+    #   pytest
+    #   tox
+py==1.10.0
+    # via
+    #   -r test.in
+    #   pytest
+    #   tox
+pyparsing==2.4.7
+    # via packaging
+pytest-cov==2.12.0
+    # via -r test.in
+pytest-django==4.3.0
+    # via -r test.in
+pytest-ordering==0.6
+    # via -r test.in
+pytest-pythonpath==0.7.3
+    # via -r test.in
+pytest==6.2.4
+    # via
+    #   -r test.in
+    #   pytest-cov
+    #   pytest-django
+    #   pytest-ordering
+    #   pytest-pythonpath
+python-dateutil==2.8.1
+    # via faker
+pytz==2021.1
+    # via
+    #   babel
+    #   django
+six==1.16.0
+    # via
+    #   python-dateutil
+    #   sqlalchemy-utils
+    #   tox
+    #   virtualenv
+speaklater==1.3
+    # via flask-babelex
+sqlalchemy-utils==0.37.8
+    # via -r flask.in
+sqlalchemy==1.4.20
+    # via
+    #   flask-sqlalchemy
+    #   sqlalchemy-utils
+sqlparse==0.4.1
+    # via
+    #   django
+    #   django-debug-toolbar
+text-unidecode==1.3
+    # via faker
+toml==0.10.2
+    # via
+    #   coverage
+    #   pytest
+    #   tox
+tox==3.23.1
+    # via -r test.in
+typing-extensions==3.10.0.0
+    # via importlib-metadata
+virtualenv==20.4.7
+    # via tox
+werkzeug==2.0.1
+    # via flask
+wtforms==2.3.3
+    # via flask-admin
+zipp==3.5.0
+    # via
+    #   importlib-metadata
+    #   importlib-resources

examples/requirements/django_3_0_and_flask.in

@@ -0,0 +1,6 @@
+-r common.in
+-r test.in
+-r flask.in
+
+Django>=3.0,<3.1
+django-debug-toolbar>=2.1