django-pfx 1.2.dev99__tar.gz → 1.2.dev101__tar.gz

{django-pfx-1.2.dev99 → django-pfx-1.2.dev101}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-pfx
-Version: 1.2.dev99
+Version: 1.2.dev101
 Summary: Django PFX is a toolkit to build web APIs dedicated to be used by React progressive web app.
 Author: Hervé Martinet
 Author-email: herve.martinet@gmail.com

{django-pfx-1.2.dev99 → django-pfx-1.2.dev101}/django_pfx.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-pfx
-Version: 1.2.dev99
+Version: 1.2.dev101
 Summary: Django PFX is a toolkit to build web APIs dedicated to be used by React progressive web app.
 Author: Hervé Martinet
 Author-email: herve.martinet@gmail.com

{django-pfx-1.2.dev99 → django-pfx-1.2.dev101}/django_pfx.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ django_pfx.egg-info/top_level.txt
 doc/Makefile
 doc/conf.py
 doc/index.rst
+doc/source/api.views.rst
 doc/source/authentication.md
 doc/source/cookbook.md
 doc/source/decorator.md
@@ -24,7 +25,6 @@ doc/source/getting_started.md
 doc/source/internationalisation.md
 doc/source/model.md
 doc/source/pfx_views.md
-doc/source/pfxcore.views.rst
 doc/source/testing.md
 img/pfx.png
 img/pfx.svg

{django-pfx-1.2.dev99 → django-pfx-1.2.dev101}/doc/conf.py

@@ -16,6 +16,8 @@ import sys
 import django
 from django.conf import settings
 
+from sphinx.ext.autodoc import between
+
 sys.path.insert(0, os.path.abspath('../'))
 settings.configure(
     SECRET_KEY='something to make Django happy',
@@ -26,8 +28,16 @@ settings.configure(
         'pfx.pfxcore'])
 django.setup()
 
-# -- Project information -----------------------------------------------------
 
+def setup(app):
+    # Register a sphinx.ext.autodoc.between listener to ignore everything
+    # between lines that contain --- and """ (yaml from apispec)
+    app.connect('autodoc-process-docstring',
+                between('^.*(---|""")$', exclude=True))
+    return app
+
+
+# -- Project information -----------------------------------------------------
 project = 'Django PFX'
 copyright = '2021, Hervé Martinet, Nicolas Béraneck'
 author = 'Hervé Martinet, Nicolas Béraneck'

{django-pfx-1.2.dev99 → django-pfx-1.2.dev101}/doc/index.rst

@@ -24,12 +24,12 @@ Topics
    source/getting_started
    source/decorator
    source/pfx_views
-   source/pfxcore.views
    source/model
    source/internationalisation
    source/authentication
    source/cookbook
    source/testing
+   source/api.views
 
 Indices and tables
 ==================

django-pfx-1.2.dev99/doc/source/pfxcore.views.rst → django-pfx-1.2.dev101/doc/source/api.views.rst

@@ -1,4 +1,4 @@
-Django PFX views
+API
 =====================
 
 The ``DetailRestViewMixin`` class
@@ -10,6 +10,20 @@ The ``DetailRestViewMixin`` class
 
 .. :inherited-members:
 
+The ``LocaleMiddleware`` class
+*********************************
+.. autoclass:: pfx.pfxcore.middleware.LocaleMiddleware
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+The ``LocaleRestView`` class
+*********************************
+.. autoclass:: pfx.pfxcore.views.LocaleRestView
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 The ``ModelMixin`` class
 *********************************
 .. autoclass:: pfx.pfxcore.views.ModelMixin

django-pfx-1.2.dev101/doc/source/internationalisation.md

@@ -0,0 +1,41 @@
+# Internationalisation
+
+## Translated strings
+
+Use Django's standard way of translating strings (verbose name, choices values, messages, ...).
+PFX will use the translated values according to the requested language.
+
+## Specify available languages
+
+In Django, `USE_I18N` must be `True` to use internationalization. Use `LANGUAGE_CODE` to set default locale.
+
+You can optionally set `USE_L10N` to `True` (see Django documentation).
+
+In Addition, you can set the list of available languages for web services with `LANGUAGES`:
+```
+LANGUAGES = [
+    ('fr', "French"),
+    ('en', "English"),
+]
+```
+
+You can use language only code of language and country.
+
+Service responses will use the first language of `Accept-Language` present in `LANGUAGES`.
+Use `X-Custom-Language` to force the use of a specific language.
+
+## LocaleRestView
+
+The `LocaleRestView` exposes a service on `/locales/languages` which returns the list of
+available languages.
+
+## LocaleMiddleware
+
+To enable internationalization in services, you have to add `'pfx.pfxcore.middleware.LocaleMiddleware'`
+in the `MIDDLEWARE` list.
+
+This middleware will use:
+* `LANGUAGES`, `LANGUAGE_CODE`, `Accept-Language` and `X-Custom-Language` to set the language.
+* `TIME_ZONE` and `X-Custom-Timezone` sot set the timezone.
+
+You can replace it by a custom middleware if you need another specific behavior.

django-pfx-1.2.dev99/doc/source/internationalisation.md

@@ -1,5 +0,0 @@
-# Internationalisation
-
-- parameters
-- LocaleMiddleware
-- LocaleRestView