django-lang 0.6.3__py3-none-any.whl

django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django32.txt

@@ -0,0 +1,30 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py310-django32.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==3.2.25 \
+    --hash=sha256:7ca38a78654aee72378594d63e51636c04b8e28574f5505dff630895b5472777 \
+    --hash=sha256:a52ea7fcf280b16f7b739cec38fa6d3f8953a5456986944c3ca97e79882b4e38
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+pytz==2026.2 \
+    --hash=sha256:04156e608bee23d3792fd45c94ae47fae1036688e75032eea2e3bf0323d1f126 \
+    --hash=sha256:0e60b47b29f21574376f218fe21abc009894a2321ea16c6754f3cad6eb7cdd6a
+    # via django
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django
+typing-extensions==4.15.0 \
+    --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
+    --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
+    # via asgiref

django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django42.txt

@@ -0,0 +1,26 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py310-django42.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==4.2.30 \
+    --hash=sha256:4d07aaf1c62f9984842b67c2874ebbf7056a17be253860299b93ae1881faad65 \
+    --hash=sha256:4ebc7a434e3819db6cf4b399fb5b3f536310a30e8486f08b66886840be84b37c
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django
+typing-extensions==4.15.0 \
+    --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
+    --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
+    # via asgiref

django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django52.txt

@@ -0,0 +1,26 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py310-django52.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==5.2.15 \
+    --hash=sha256:0eb4a9bb1853a35b0286dbc6d916bd352c8c2687195a7f2d6f80cefd840e4970 \
+    --hash=sha256:5154a9bf84ac01dde011e367f355c07dbb329532e06810dcf3ef2af269e236e7
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django
+typing-extensions==4.15.0 \
+    --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
+    --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
+    # via asgiref

django_lang-0.6.3.data/data/share/django-lang/requirements/py311-django42.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py311-django42.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==4.2.30 \
+    --hash=sha256:4d07aaf1c62f9984842b67c2874ebbf7056a17be253860299b93ae1881faad65 \
+    --hash=sha256:4ebc7a434e3819db6cf4b399fb5b3f536310a30e8486f08b66886840be84b37c
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py311-django52.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py311-django52.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==5.2.15 \
+    --hash=sha256:0eb4a9bb1853a35b0286dbc6d916bd352c8c2687195a7f2d6f80cefd840e4970 \
+    --hash=sha256:5154a9bf84ac01dde011e367f355c07dbb329532e06810dcf3ef2af269e236e7
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py312-django42.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py312-django42.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==4.2.30 \
+    --hash=sha256:4d07aaf1c62f9984842b67c2874ebbf7056a17be253860299b93ae1881faad65 \
+    --hash=sha256:4ebc7a434e3819db6cf4b399fb5b3f536310a30e8486f08b66886840be84b37c
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py312-django52.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py312-django52.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==5.2.15 \
+    --hash=sha256:0eb4a9bb1853a35b0286dbc6d916bd352c8c2687195a7f2d6f80cefd840e4970 \
+    --hash=sha256:5154a9bf84ac01dde011e367f355c07dbb329532e06810dcf3ef2af269e236e7
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py313-django52.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.13
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py313-django52.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==5.2.15 \
+    --hash=sha256:0eb4a9bb1853a35b0286dbc6d916bd352c8c2687195a7f2d6f80cefd840e4970 \
+    --hash=sha256:5154a9bf84ac01dde011e367f355c07dbb329532e06810dcf3ef2af269e236e7
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py314-django52.txt

@@ -0,0 +1,22 @@
+#
+# This file is autogenerated by pip-compile with Python 3.14
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py314-django52.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==5.2.15 \
+    --hash=sha256:0eb4a9bb1853a35b0286dbc6d916bd352c8c2687195a7f2d6f80cefd840e4970 \
+    --hash=sha256:5154a9bf84ac01dde011e367f355c07dbb329532e06810dcf3ef2af269e236e7
+    # via -r requirements/runtime.in
+emoji-country-flag==2.1.0 \
+    --hash=sha256:224b19583210901b950a624ab0b0896cdf0764b36f8bd1463868b15fb8c10f6a \
+    --hash=sha256:3b4df6a9d9961ab7716090689c2e96405baff68e46849ab2704335d904589f2a
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django

django_lang-0.6.3.data/data/share/django-lang/requirements/py39-django42.txt

@@ -0,0 +1,26 @@
+#
+# This file is autogenerated by pip-compile with Python 3.9
+# by the following command:
+#
+#    pip-compile --allow-unsafe --generate-hashes --output-file=requirements/py39-django42.txt requirements/runtime.in
+#
+asgiref==3.11.1 \
+    --hash=sha256:5f184dc43b7e763efe848065441eac62229c9f7b0475f41f80e207a114eda4ce \
+    --hash=sha256:e8667a091e69529631969fd45dc268fa79b99c92c5fcdda727757e52146ec133
+    # via django
+django==4.2.30 \
+    --hash=sha256:4d07aaf1c62f9984842b67c2874ebbf7056a17be253860299b93ae1881faad65 \
+    --hash=sha256:4ebc7a434e3819db6cf4b399fb5b3f536310a30e8486f08b66886840be84b37c
+    # via -r requirements/runtime.in
+emoji-country-flag==1.3.2 \
+    --hash=sha256:42d9fc1a8ec27b3ef2c18a39532dcdbf0527afbc95749be02a3afc1f1b165aa3 \
+    --hash=sha256:6ddcf8f3bc55b2f59b1d7d9dc830e90f9423f555dd37862c4c2e220d42726f73
+    # via -r requirements/runtime.in
+sqlparse==0.5.5 \
+    --hash=sha256:12a08b3bf3eec877c519589833aed092e2444e68240a3577e8e26148acc7b1ba \
+    --hash=sha256:e20d4a9b0b8585fdf63b10d30066c7c94c5d7a7ec47c889a2d83a3caa93ff28e
+    # via django
+typing-extensions==4.15.0 \
+    --hash=sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466 \
+    --hash=sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548
+    # via asgiref

django_lang-0.6.3.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: django-lang
+Version: 0.6.3
+Summary: Django application to provide useful utils and reusable parts of code for multi-languages sites.
+Author-email: DLRSP <dlrsp.dev@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/DLRSP/django-lang
+Project-URL: Documentation, https://github.com/DLRSP/django-lang/
+Project-URL: Repository, https://github.com/DLRSP/django-lang
+Project-URL: Issues, https://github.com/DLRSP/django-lang/issues
+Project-URL: Changelog, https://github.com/DLRSP/django-lang/blob/main/CHANGELOG.rst
+Keywords: django,i18n,multilingual,hreflang,language
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Natural Language :: Italian
+Classifier: Natural Language :: English
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Requires-Dist: emoji-country-flag>=2.1.0; python_version >= "3.10"
+Requires-Dist: emoji-country-flag<2,>=1.3.2; python_version < "3.10"
+Provides-Extra: testing
+Requires-Dist: coverage; extra == "testing"
+Requires-Dist: codecov; extra == "testing"
+Requires-Dist: pytest; extra == "testing"
+Requires-Dist: pytest-django; extra == "testing"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0; extra == "docs"
+Requires-Dist: mkdocs-git-revision-date-plugin>=2.0; extra == "docs"
+Provides-Extra: linting
+Requires-Dist: flake8; extra == "linting"
+Requires-Dist: flake8-pyproject; extra == "linting"
+Requires-Dist: flake8-bugbear; extra == "linting"
+Requires-Dist: flake8-comprehensions; extra == "linting"
+Requires-Dist: flake8-tidy-imports; extra == "linting"
+Requires-Dist: flake8-typing-imports; extra == "linting"
+Requires-Dist: pylint; extra == "linting"
+Dynamic: license-file
+
+# django-lang [![PyPi license](https://img.shields.io/pypi/l/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+
+[![PyPi status](https://img.shields.io/pypi/status/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+[![PyPi version](https://img.shields.io/pypi/v/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+[![PyPi python version](https://img.shields.io/pypi/pyversions/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+[![PyPi downloads](https://img.shields.io/pypi/dm/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+[![PyPi downloads](https://img.shields.io/pypi/dw/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+[![PyPi downloads](https://img.shields.io/pypi/dd/django-lang.svg)](https://pypi.python.org/pypi/django-lang)
+
+## GitHub ![GitHub release](https://img.shields.io/github/tag/DLRSP/django-lang.svg) ![GitHub release](https://img.shields.io/github/release/DLRSP/django-lang.svg)
+
+## Test [![codecov.io](https://codecov.io/github/DLRSP/django-lang/coverage.svg?branch=main)](https://codecov.io/github/DLRSP/django-lang?branch=main) [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/DLRSP/django-lang/main.svg)](https://results.pre-commit.ci/latest/github/DLRSP/django-lang/main) [![gitthub.com](https://github.com/DLRSP/django-lang/actions/workflows/ci.yaml/badge.svg)](https://github.com/DLRSP/django-lang/actions/workflows/ci.yaml)
+
+## Check Demo Project
+* Check the demo repo on [GitHub](https://github.com/DLRSP/example/tree/django-lang)
+
+## Requirements
+-   Python 3.9+ supported.
+-   Django 3.2+ supported.
+
+## Setup
+1. Install from **pip**:
+    ```shell
+    pip install django-lang
+    ```
+2. Modify `settings.py` by adding the app to `INSTALLED_APPS`:
+    ```python
+    INSTALLED_APPS = [
+        # ...
+        "lang",
+        # ...
+    ]
+    ```
+3. Modify `settings.py` by adding the app to `INSTALLED_APPS`:
+    ``` python title="settings.py" hl_lines="12"
+    TEMPLATES = [
+        {
+            "BACKEND": "django.template.backends.django.DjangoTemplates",
+            "DIRS": [os.path.join(PROJECT_DIR, "templates")],
+            "APP_DIRS": True,
+            "OPTIONS": {
+                "context_processors": [
+                    "django.template.context_processors.debug",
+                    "django.template.context_processors.request",
+                    "django.contrib.auth.context_processors.auth",
+                    "django.contrib.messages.context_processors.messages",
+                    "lang.context_processors.from_settings",
+                    "lang.context_processors.seo_i18n",
+                ],
+            },
+        },
+    ]
+    ```
+
+    Optional: ``lang.context_processors.language_switcher_next`` (fills ``redirect_to`` for the packaged language form).
+
+### Optional: ``SetLanguageNextPathMiddleware``
+
+Only needed if you use **translated URL segments** (``gettext_lazy`` under ``i18n_patterns``) and see language switches that POST to ``set_language`` but stay on the wrong prefix. Short how-to: [docs/set_language_middleware.md](docs/set_language_middleware.md).
+
+4. Modify your project's base template `base.html` to include language's switcher styles:
+    ```html
+    <head>
+        ...
+        <link rel="stylesheet" type="text/css" href="{% static 'lang/css/nav-link.css' %}">
+        ...
+    </head>
+    ```
+5. Modify your project's base template `base.html` to include attributes using `translate_url` template's tag:
+    ```html
+    <head>
+        ...
+        <meta name="language" content="{{ LANGUAGE_CODE }}" />
+        {% include "hreflang.html" %}
+        ...
+    </head>
+    ```
+6. Modify your project's nav template `nav.html` to include language's switcher:
+    ```html
+    <nav class="navbar">
+        ...
+        <ul class="nav navbar-nav">
+            {% include "lang/nav-link.html" %}
+        </ul>
+        ...
+    </nav>
+    ```
+
+### Configuration: ``lang.conf`` and ``APP_CONFIG``
+
+Built-in maps live in ``lang.defaults``. At runtime, :mod:`lang.conf` resolves values **lazily**:
+
+1. Top-level Django settings (``LANGUAGE_HREFLANG_MAP``, ``LANGUAGE_WIKIPEDIA_SAMEAS``, ``OG_LOCALE_BY_LANGUAGE``, ``HREFLANG_DEFAULT_LANGUAGE``, ``LANGUAGE_FLAG_MAP``), if set.
+2. Partial dicts under ``settings.APP_CONFIG["lang"]`` merged onto the package defaults (for the three ``LANGUAGE_*`` / ``OG_*`` maps and flag overrides).
+3. Otherwise the content of ``lang.defaults``.
+
+You do **not** need to import ``lang.defaults`` from ``settings.py``. Typical site-only override for ``x-default``::
+
+    APP_CONFIG = {
+        "lang": {
+            "HREFLANG_DEFAULT_LANGUAGE": "it",
+        },
+    }
+
+Or use the usual flat settings (full replacement for the dict keys, or ``HREFLANG_DEFAULT_LANGUAGE`` at top level) if you prefer.
+
+### Optional: language control beside the hamburger on **small viewports**
+
+``nav-link-standalone.css`` shows the extra switcher next to the menu toggle below the ``lg`` breakpoint (~992px) and hides the duplicate inside the collapsed drawer. Optional script ``display-standalone-class.js`` only adds class ``display-standalone`` on ``<html>`` for installed web apps; layout no longer depends on it.
+
+1. In `settings.py`, add the optional context processor so `redirect_to` is filled for `set_language`’s `next` (unless you pass `redirect_to` from each view):
+    ```python
+    "lang.context_processors.language_switcher_next",
+    ```
+2. In the base layout `<head>`, after `nav-link.css`, add:
+    ```html
+    <link rel="stylesheet" href="{% static 'lang/css/nav-link-standalone.css' %}">
+    <script src="{% static 'lang/js/display-standalone-class.js' %}"></script>
+    ```
+3. Next to your mobile menu button, include:
+    ```html
+    {% include "lang/nav-link-standalone.html" %}
+    ```
+
+Packaged templates:
+
+- ``hreflang.html`` (app template root) — ``<link rel="alternate" hreflang="…">`` for the current view.
+- ``lang/nav-link.html`` — language ``<select>`` (optional context: ``lang_switcher_id``, ``lang_switcher_extra_class``).
+- ``lang/nav-link-standalone.html`` — duplicate switcher beside the mobile toggle (small viewports / PWA).
+
+
+## Run Example Project
+
+```shell
+git clone --depth=50 --branch=django-lang https://github.com/DLRSP/example.git DLRSP/example
+cd DLRSP/example
+python manage.py runserver
+```
+
+Now browser the app @ http://127.0.0.1:8000
+
+## References
+
+- [brainstorm.it](https://brainstorm.it/snippets/django-language-switching/) - Language's switching
+- [hakibenita.com](https://hakibenita.com/django-multi-language-site-hreflang) - Url's translation for "hreflang" html's attributes

django_lang-0.6.3.dist-info/RECORD

@@ -0,0 +1,30 @@
+django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django32.txt,sha256=Is5a75mDJwwbiTi_y2Ew0SNFnD_wI_mJv3qOVFlK5-s,1490
+django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django42.txt,sha256=hYkTt5hE91FrZ-LJH0dMUembnnuTEcjbk6POfVU9bf4,1290
+django_lang-0.6.3.data/data/share/django-lang/requirements/py310-django52.txt,sha256=TWCY2bckrkhdP578QYvtZoICIWQVPISOKstdDg2r1ZE,1290
+django_lang-0.6.3.data/data/share/django-lang/requirements/py311-django42.txt,sha256=roRqDD4Bkx1nqaVZ_7Iisy1Htku1VMzPv-DS2LPuYWk,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py311-django52.txt,sha256=RQYIjE0lPtVgurhNzMcoPZf2qDzwhXd7vkTLrn3bqkc,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py312-django42.txt,sha256=dUK-xWhdYCNu3NXSZK_aXFisZREqfxk1P_zM2kCIPek,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py312-django52.txt,sha256=rtKLPk_UEC5dXzTw-SsD4PYgL_QFP7j11dPcfjcGKHU,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py313-django52.txt,sha256=cghaLwOzYis19pbLcDFUwYqw4woVbLXba1Ia64EHZ8g,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py314-django52.txt,sha256=R6gYVOJzUQjehM-TFQtgHdP1lM0F5z4Pokm-EidMuxs,1076
+django_lang-0.6.3.data/data/share/django-lang/requirements/py39-django42.txt,sha256=hli_6tnHOeH5BSDGPnBGF1x6ot4w088o3J-sraCLp7w,1288
+django_lang-0.6.3.dist-info/licenses/LICENSE,sha256=lea6YyyICc5SM-8jvboUSCWiCpPwBrUPJAb8cHxAP5A,1114
+lang/__init__.py,sha256=IIk7gZN3QmKyv2GEWFOd5D3qY04cMPb8Rr-flYq8Mwk,462
+lang/conf.py,sha256=G5teoWe7Vl6fwX3GVWiSWXvcSkvPMWoD1wfeCrff2UA,3054
+lang/context_processors.py,sha256=zefDpet4tXYlnBELC1HCK_VkU7jgbEKDijZOkdUJvL4,2155
+lang/defaults.py,sha256=idhm3btcU-IZBmliby0q3sGY-6qVyQsN01q7FUZ5IG8,1866
+lang/middleware.py,sha256=UP7gdMMwMs9pWjh2ZKqabBsJCz6-ovRt9d-KXngy1kA,2313
+lang/utils.py,sha256=K67OAzyC4WJLz-ZGCbTSRkHNgYelmMZ1uNZEYmuXy-c,978
+lang/static/lang/css/nav-link-standalone.css,sha256=bipwrkyKNgR0_Kv-q7rXyWdzym4JAf1GbcdpZK2w0G4,811
+lang/static/lang/css/nav-link.css,sha256=tFhfGH6FkWZDWUaH6H4VFWwo3afBmkDwX2qKzO1hQcI,426
+lang/static/lang/js/display-standalone-class.js,sha256=TUhv5gpWZJUBQtTzuv12WSym8sKi3zlJVkKKYuq1BVs,643
+lang/templates/hreflang.html,sha256=BdciMglJ2xETeXc92YZl9wvmpzDBAYf7aCIIkgzY16A,373
+lang/templates/lang/nav-link-standalone.html,sha256=wuaGJ3PmT2RaQCnxn6UKJ-CsIHjPuA3G4YojQOYGzjM,307
+lang/templates/lang/nav-link.html,sha256=swHsDd3lOw7yfJfiAyOWCFPqgSt1J2seX281luxnsO8,781
+lang/templatetags/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lang/templatetags/languages_helpers.py,sha256=_zhbFZ5IH7QUum7wXQJeJ9Qw3hn5a20u5CQNVhv6SxA,2242
+lang/templatetags/urls.py,sha256=4bYpWmhBfHKHEAyrAj0wod1YSok1JqS4oIcCJtossYc,2842
+django_lang-0.6.3.dist-info/METADATA,sha256=OvZ6Qhg3x3k6yG61GHzmdxsXrIET3OV1iOuk0SvQOCI,9491
+django_lang-0.6.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+django_lang-0.6.3.dist-info/top_level.txt,sha256=k1z7040BUci34YPBCxIsaMA0DGeL-qBF3vBS1z3Ro28,5
+django_lang-0.6.3.dist-info/RECORD,,

django_lang-0.6.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

django_lang-0.6.3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2010-present DLRSP (https://dlrsp.org) and other contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_lang-0.6.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+lang

lang/__init__.py

@@ -0,0 +1,22 @@
+"""
+See PEP 386 (https://peps.python.org/pep-0386/)
+"""
+
+__version__ = "0.6.3"
+__version_info__ = tuple(
+    int(i) if i.isdigit() else i for i in __version__.split(".")
+)
+__license__ = "MIT"
+__title__ = "lang"
+
+__author__ = "DLRSP"
+__copyright__ = "Copyright 2010-present DLRSP"
+
+# Version synonym
+VERSION = __version_info__
+
+# Header encoding (see RFC5987)
+HTTP_HEADER_ENCODING = "iso-8859-1"
+
+# Default datetime input and output formats
+ISO_8601 = "iso-8601"

lang/conf.py

@@ -0,0 +1,103 @@
+"""
+Resolved configuration for ``lang`` (lazy reads from ``django.conf.settings``).
+
+Priority for each value:
+
+1. Top-level Django setting (e.g. ``LANGUAGE_HREFLANG_MAP``), if set.
+2. Partial override inside ``settings.APP_CONFIG["lang"]`` merged onto
+   :mod:`lang.defaults`.
+3. Package defaults from :mod:`lang.defaults`.
+
+Projects can rely on defaults only (no imports from ``lang.defaults`` in
+``settings.py``) and optionally set::
+
+    APP_CONFIG = {
+        "lang": {
+            "HREFLANG_DEFAULT_LANGUAGE": "it",
+            "LANGUAGE_HREFLANG_MAP": {"en": "en-GB"},
+        },
+    }
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from django.conf import settings
+
+from lang import defaults
+
+
+def _app_config_lang() -> dict[str, Any]:
+    cfg = getattr(settings, "APP_CONFIG", None) or {}
+    lang = cfg.get("lang")
+    return dict(lang) if lang else {}
+
+
+def _merged_lang_dict(
+    setting_name: str,
+    defaults_dict: dict[str, str],
+) -> dict[str, str]:
+    """
+    Full replacement if ``settings.<name>`` is set; else defaults merged with
+    ``APP_CONFIG['lang'][<name>]`` (partial).
+    """
+    explicit = getattr(settings, setting_name, None)
+    if explicit is not None:
+        return dict(explicit)
+    partial = _app_config_lang().get(setting_name)
+    if partial:
+        return {**defaults_dict, **dict(partial)}
+    return dict(defaults_dict)
+
+
+def get_language_hreflang_map() -> dict[str, str]:
+    """Django language code → BCP 47 ``hreflang`` attribute value."""
+    return _merged_lang_dict(
+        "LANGUAGE_HREFLANG_MAP",
+        defaults.LANGUAGE_HREFLANG_MAP,
+    )
+
+
+def get_language_wikipedia_sameas() -> dict[str, str]:
+    """Django language code → Wikipedia URL (e.g. JSON-LD ``sameAs``)."""
+    return _merged_lang_dict(
+        "LANGUAGE_WIKIPEDIA_SAMEAS",
+        defaults.LANGUAGE_WIKIPEDIA_SAMEAS,
+    )
+
+
+def get_og_locale_by_language() -> dict[str, str]:
+    """Django language code → Open Graph locale string."""
+    return _merged_lang_dict(
+        "OG_LOCALE_BY_LANGUAGE",
+        defaults.OG_LOCALE_BY_LANGUAGE,
+    )
+
+
+def get_hreflang_default_language() -> str | None:
+    """
+    Brand default for ``hreflang`` ``x-default`` (non-empty string or ``None``).
+
+    Reads ``HREFLANG_DEFAULT_LANGUAGE`` from top-level settings, then
+    ``APP_CONFIG['lang']['HREFLANG_DEFAULT_LANGUAGE']``.
+    """
+    top = getattr(settings, "HREFLANG_DEFAULT_LANGUAGE", None)
+    if top:
+        return str(top)
+    nested = _app_config_lang().get("HREFLANG_DEFAULT_LANGUAGE")
+    if nested:
+        return str(nested)
+    return None
+
+
+def get_language_flag_map() -> dict[str, str]:
+    """
+    ISO region codes for emoji flags: merge package defaults with
+    ``settings.LANGUAGE_FLAG_MAP`` and ``APP_CONFIG['lang']['LANGUAGE_FLAG_MAP']``.
+    """
+    from lang.utils import DEFAULT_LANGUAGE_FLAG_MAP
+
+    user = getattr(settings, "LANGUAGE_FLAG_MAP", None) or {}
+    user2 = _app_config_lang().get("LANGUAGE_FLAG_MAP") or {}
+    return {**DEFAULT_LANGUAGE_FLAG_MAP, **dict(user), **dict(user2)}

lang/context_processors.py

@@ -0,0 +1,63 @@
+"""
+Context processors for django-lang app
+"""
+
+from typing import Any, Dict
+
+from django.conf import settings
+
+from lang.conf import (
+    get_hreflang_default_language,
+    get_language_wikipedia_sameas,
+    get_og_locale_by_language,
+)
+
+
+def from_settings(request) -> Dict[str, Any]:
+    return {
+        "DEFAULT_LANGUAGE_CODE": getattr(settings, "LANGUAGE_CODE", None),
+    }
+
+
+def language_switcher_next(request) -> Dict[str, Any]:
+    """
+    Optional: set ``redirect_to`` to the current path for packaged language forms
+    (``set_language`` POST field ``next``). Add to ``TEMPLATES`` context_processors
+    when you use ``lang/nav-link.html`` without
+    passing ``redirect_to`` from each view.
+    """
+    if request is None:
+        return {}
+    return {"redirect_to": request.get_full_path()}
+
+
+def seo_i18n(request) -> Dict[str, Any]:
+    """
+    SEO helpers for multilingual templates (list **after**
+    ``lang.context_processors.from_settings`` so it can override
+    ``DEFAULT_LANGUAGE_CODE`` when needed).
+
+    - ``DEFAULT_LANGUAGE_CODE``: set from ``settings.HREFLANG_DEFAULT_LANGUAGE``
+      when it is a non-empty string (drives ``hreflang.html`` ``x-default``).
+      If unset or empty, ``from_settings`` keeps ``LANGUAGE_CODE``.
+    - ``LANGUAGE_WIKIPEDIA_SAMEAS``: optional ``dict`` mapping Django language
+      code → URL (e.g. JSON-LD ``sameAs`` for languages).
+    - ``OG_LOCALE_BY_LANGUAGE``: optional ``dict`` mapping Django language code
+      → Open Graph locale string (e.g. ``it_IT``).
+
+    Configure on ``settings`` (all optional except the first, which is
+    opt-in via defining ``HREFLANG_DEFAULT_LANGUAGE``):
+
+    - ``HREFLANG_DEFAULT_LANGUAGE`` (top-level or ``APP_CONFIG['lang']``)
+    - ``LANGUAGE_WIKIPEDIA_SAMEAS`` / ``OG_LOCALE_BY_LANGUAGE`` (same)
+
+    See :mod:`lang.conf` for merge rules.
+    """
+    ctx: Dict[str, Any] = {
+        "LANGUAGE_WIKIPEDIA_SAMEAS": get_language_wikipedia_sameas(),
+        "OG_LOCALE_BY_LANGUAGE": get_og_locale_by_language(),
+    }
+    href_default = get_hreflang_default_language()
+    if href_default:
+        ctx["DEFAULT_LANGUAGE_CODE"] = href_default
+    return ctx

lang/defaults.py

@@ -0,0 +1,53 @@
+"""
+Built-in defaults for i18n / SEO helpers.
+
+Runtime resolution (settings + optional ``APP_CONFIG``) lives in
+:mod:`lang.conf`; do **not** require projects to import this module from
+``settings.py`` unless they prefer explicit re-exports.
+
+``HREFLANG_DEFAULT_LANGUAGE`` is project-specific; set it via
+``settings.HREFLANG_DEFAULT_LANGUAGE`` or ``APP_CONFIG['lang']`` (see
+:mod:`lang.conf`).
+"""
+
+from __future__ import annotations
+
+# Google-style BCP 47 in <link hreflang="…"> (Django code → attribute value).
+LANGUAGE_HREFLANG_MAP: dict[str, str] = {
+    "zh-hans": "zh-Hans",
+    "zh-hant": "zh-Hant",
+}
+
+# JSON-LD ``sameAs`` (or similar) → Wikipedia articles per language.
+LANGUAGE_WIKIPEDIA_SAMEAS: dict[str, str] = {
+    "it": "https://en.wikipedia.org/wiki/Italian_language",
+    "en": "https://en.wikipedia.org/wiki/English_language",
+    "de": "https://en.wikipedia.org/wiki/German_language",
+    "fr": "https://en.wikipedia.org/wiki/French_language",
+    "es": "https://en.wikipedia.org/wiki/Spanish_language",
+    "pt": "https://en.wikipedia.org/wiki/Portuguese_language",
+    "nl": "https://en.wikipedia.org/wiki/Dutch_language",
+    "pl": "https://en.wikipedia.org/wiki/Polish_language",
+    "ru": "https://en.wikipedia.org/wiki/Russian_language",
+    "zh-hans": "https://en.wikipedia.org/wiki/Chinese_language",
+    "ja": "https://en.wikipedia.org/wiki/Japanese_language",
+    "ko": "https://en.wikipedia.org/wiki/Korean_language",
+    "ar": "https://en.wikipedia.org/wiki/Arabic",
+}
+
+# Open Graph ``og:locale``-style strings (underscore + region).
+OG_LOCALE_BY_LANGUAGE: dict[str, str] = {
+    "it": "it_IT",
+    "en": "en_US",
+    "de": "de_DE",
+    "fr": "fr_FR",
+    "es": "es_ES",
+    "pt": "pt_PT",
+    "nl": "nl_NL",
+    "pl": "pl_PL",
+    "ru": "ru_RU",
+    "zh-hans": "zh_CN",
+    "ja": "ja_JP",
+    "ko": "ko_KR",
+    "ar": "ar_SA",
+}

lang/middleware.py

@@ -0,0 +1,56 @@
+"""
+Optional middleware for Django's ``set_language`` view and gettext_lazy URL paths.
+
+``django.views.i18n.set_language`` calls ``django.urls.translate_url``, which runs
+``resolve()`` while the **active** translation language is still the one chosen by
+``LocaleMiddleware`` for the current request. For POSTs to ``/i18n/setlang/`` there
+is no language prefix in the URL, so the language often comes from the
+``django_language`` cookie (e.g. ``LANGUAGE_CODE`` default ``en``). If the user is
+leaving a page whose path uses a **different** prefix (e.g. ``/it/...``) and
+translated segments from ``gettext_lazy``, ``resolve()`` can fail under the wrong
+active language and the redirect keeps the old prefix — while the cookie updates,
+``LocaleMiddleware`` still prefers the URL prefix, so the UI appears stuck.
+
+This middleware activates the language parsed from the ``next`` URL path (when it
+carries an i18n prefix) **before** ``set_language`` runs, so ``translate_url`` matches
+the same patterns as for a normal request on that path.
+
+Insert **immediately after** ``django.middleware.locale.LocaleMiddleware``::
+
+    MIDDLEWARE = [
+        ...
+        "django.middleware.locale.LocaleMiddleware",
+        "lang.middleware.SetLanguageNextPathMiddleware",
+        ...
+    ]
+"""
+
+from __future__ import annotations
+
+from urllib.parse import urlsplit
+
+from django.utils import translation
+from django.utils.deprecation import MiddlewareMixin
+from django.utils.translation import get_language_from_path
+
+
+class SetLanguageNextPathMiddleware(MiddlewareMixin):
+    """Align active language with the i18n prefix in ``next`` for POST ``set_language``."""
+
+    def process_request(self, request):
+        if request.method != "POST":
+            return None
+        path_info = request.path_info or ""
+        if not path_info.startswith("/i18n/") or "setlang" not in path_info:
+            return None
+        next_url = request.POST.get("next") or request.GET.get("next")
+        if not next_url:
+            return None
+        path = urlsplit(next_url).path or "/"
+        path_lang = get_language_from_path(path)
+        if not path_lang:
+            return None
+        translation.activate(path_lang)
+        if hasattr(request, "LANGUAGE_CODE"):
+            request.LANGUAGE_CODE = path_lang
+        return None

lang/static/lang/css/nav-link-standalone.css

@@ -0,0 +1,27 @@
+/*-----------------------------------------------------------------------------------*/
+/* Mobile / narrow navbar (< lg): language switch beside hamburger; hide duplicate    */
+/* in the collapsed drawer. (display-standalone-class.js is optional; not required.) */
+/*-----------------------------------------------------------------------------------*/
+
+.lang-switcher-standalone {
+    display: none !important;
+}
+
+@media (max-width: 991.98px) {
+    .lang-switcher-standalone {
+        display: flex !important;
+        align-items: center;
+        margin-right: 6px;
+    }
+
+    #language-switcher-standalone select {
+        font-size: 24px;
+        line-height: 1;
+        cursor: pointer;
+        padding: 0 2px 0 0;
+    }
+
+    .navbar-collapse #language-switcher {
+        display: none !important;
+    }
+}

lang/static/lang/css/nav-link.css

@@ -0,0 +1,17 @@
+/* Menu Language (in-drawer + optional standalone bar id language-switcher-standalone) */
+#language-switcher select,
+#language-switcher-standalone select {
+    width: auto;
+    background-color: transparent;
+    font-size: 28px;
+    border: 0px solid;
+
+    /*remove arrow*/
+    -webkit-appearance: none;
+    -moz-appearance: none;
+    text-indent: 1px;
+    text-overflow: '';
+
+    /*remove focus border*/
+    outline: none;
+}

lang/static/lang/js/display-standalone-class.js

@@ -0,0 +1,15 @@
+/**
+ * Adds class ``display-standalone`` on <html> when the page runs in a standalone
+ * display surface (CSS ``display-mode: standalone``) or as an iOS home-screen
+ * web app (``navigator.standalone``). Optional hook for future CSS/JS; navbar
+ * language placement no longer depends on it (see nav-link-standalone.css).
+ */
+(function () {
+    try {
+        var dm = window.matchMedia && window.matchMedia("(display-mode: standalone)");
+        var ios = window.navigator.standalone === true;
+        if ((dm && dm.matches) || ios) {
+            document.documentElement.classList.add("display-standalone");
+        }
+    } catch (e) {}
+})();

lang/templates/hreflang.html

@@ -0,0 +1,8 @@
+{% load i18n urls languages_helpers %}
+
+<!-- hreflang -->
+{% get_available_languages as LANGUAGES %}
+{% for language_code, language_name in LANGUAGES %}
+<link rel="alternate" hreflang="{{ language_code|hreflang_bcp47 }}" href="{% translate_url language_code %}" />
+{% endfor %}
+<link rel="alternate" hreflang="x-default" href="{% translate_url DEFAULT_LANGUAGE_CODE %}" />

lang/templates/lang/nav-link-standalone.html

@@ -0,0 +1,6 @@
+{# Beside the mobile menu toggle when (display-mode: standalone) or iOS web app. #}
+{# Use with nav-link-standalone.css + display-standalone-class.js #}
+{% load i18n %}
+<div class="lang-switcher-standalone">
+    {% include "lang/nav-link.html" with lang_switcher_id="language-switcher-standalone" %}
+</div>

lang/templates/lang/nav-link.html

@@ -0,0 +1,14 @@
+{% load i18n languages_helpers %}
+<div id="{{ lang_switcher_id|default:'language-switcher' }}" class="nav-link{% if lang_switcher_extra_class %} {{ lang_switcher_extra_class }}{% endif %}">
+    <form action="{% url 'set_language' %}" method="post">
+        {% csrf_token %}
+        <input name="next" type="hidden" value="{{ redirect_to }}" />
+        <select name="language" onchange="this.form.submit()" aria-label="{% translate 'Language' %}">
+            {% for language in request|get_language_info_list_ex %}
+                <option value="{{ language.code }}"{% if language.is_current %} selected="selected"{% endif %}>
+                    <span class="flag">{{ language.flag }}</span>
+                </option>
+            {% endfor %}
+        </select>
+    </form>
+</div>

lang/templatetags/languages_helpers.py

@@ -0,0 +1,74 @@
+import flag
+from django import template
+from django.conf import settings
+from django.utils import translation
+
+from lang.utils import build_language_flag_map, get_hreflang_code
+
+register = template.Library()
+
+
+@register.filter
+def hreflang_bcp47(django_language_code: str) -> str:
+    """Map Django language code to hreflang (BCP 47); see :mod:`lang.conf`."""
+    return get_hreflang_code(django_language_code)
+
+
+@register.filter
+def get_language_info_list_ex(request):
+    """
+    Sample result:
+
+        [{'bidi': False,
+        'code': 'en',
+        'flag': '🇬🇧',
+        'is_current': False,
+        'name': 'English',
+        'name_local': 'English',
+        'name_translated': 'Inglese'},
+        {'bidi': False,
+        'code': 'it',
+        'flag': '🇮🇹',
+        'is_current': True,
+        'name': 'Italian',
+        'name_local': 'italiano',
+        'name_translated': 'Italiano'},
+        {'bidi': False,
+        'code': 'es',
+        'flag': '🇪🇸',
+        'is_current': False,
+        'name': 'Spanish',
+        'name_local': 'español',
+        'name_translated': 'Spagnolo'}]
+    """
+    data = []
+
+    # From django.templatetags.i18n.GetLanguageInfoListNode
+    def get_language_info(language):
+        # ``language`` is either a language code string or a sequence
+        # with the language code as its first item
+        if len(language[0]) > 1:
+            return translation.get_language_info(language[0])
+        else:
+            return translation.get_language_info(str(language))
+
+    flag_map = build_language_flag_map()
+
+    # Es: 'es'
+    current_language = translation.get_language()
+
+    # Es: [('en', 'Inglés'), ('it', 'Italiano'), ('es', 'Español')]
+    # languages = [(k, translation.gettext(v)) for k, v in settings.LANGUAGES]
+    for language in settings.LANGUAGES:
+        # Es: {'bidi': False, 'code': 'es', 'name': 'Spanish',
+        #      'name_local': 'español', 'name_translated': 'Español'}
+        info = get_language_info(language)
+
+        code = info["code"]
+        info["is_current"] = code == current_language
+
+        # This requires emoji-country-flag Python package
+        info["flag"] = flag.flag(flag_map.get(code, code))
+        data.append(info)
+
+    return data

lang/templatetags/urls.py

@@ -0,0 +1,83 @@
+import logging
+from typing import Any, Dict, Optional
+from urllib.parse import unquote, urlsplit, urlunsplit
+
+from django import template, urls
+from django.urls import Resolver404, resolve, reverse
+from django.utils.translation import override
+
+register = template.Library()
+
+logger = logging.getLogger(__name__)
+
+
+@register.simple_tag(takes_context=True)
+def translate_url(context: Dict[str, Any], language: Optional[str]) -> str:
+    """
+    Given the context of the current page, try to get its translated version in
+    the `language` (either by i18n_patterns or by translated regex).
+    Return the original URL if no translated version is found.
+
+    Usage:
+        {% translate_url 'en' %}
+    """
+    request = context["request"]
+    iter_key = f"translated_iter_{language}"
+    url_key = f"translated_url_{language}"
+    session = request.session
+
+    # set session's iteration to avoid circular calls
+    try:
+        if session.get(iter_key, 0) > 0:
+            return session[url_key]
+        session[iter_key] = 1
+    except Exception as err:
+        raise Exception(f"Avoid circular execution! [{err}]")
+
+    if url_key in session:
+        logger.debug("session has %s: %s", url_key, session[url_key])
+        return session[url_key]
+    url = request.build_absolute_uri()
+    try:
+        parsed = urlsplit(url)
+        match = resolve(unquote(parsed.path))
+    except Resolver404:
+        pass
+    else:
+        with override(language):
+            try:
+                view = match.func(request, **match.kwargs)
+                if hasattr(view, "url"):
+                    translated_url = urlunsplit(
+                        (
+                            parsed.scheme,
+                            parsed.netloc,
+                            view.url,
+                            parsed.query,
+                            parsed.fragment,
+                        )
+                    )
+                else:
+                    view_url = urlunsplit(
+                        (
+                            parsed.scheme,
+                            parsed.netloc,
+                            reverse(
+                                match.url_name,
+                                args=match.args,
+                                kwargs=match.kwargs,
+                            ),
+                            parsed.query,
+                            parsed.fragment,
+                        )
+                    )
+                    translated_url = urls.translate_url(view_url, language)
+                session[url_key] = translated_url
+                return translated_url
+            except Exception as err:
+                logger.debug(f"Translate url exception: [{err}]")
+                pass
+
+    translated_url = urls.translate_url(url, language)
+    session[url_key] = translated_url
+    return translated_url

lang/utils.py

@@ -0,0 +1,35 @@
+"""
+Shared helpers for language display (hreflang BCP 47, flag region codes).
+
+Resolved values come from :mod:`lang.conf` (settings + ``APP_CONFIG`` + defaults).
+"""
+
+from __future__ import annotations
+
+# Reasonable defaults for common Django language codes (ISO 3166-1 for flag.emoji).
+DEFAULT_LANGUAGE_FLAG_MAP: dict[str, str] = {
+    "ar": "sa",
+    "en": "gb",
+    "ja": "jp",
+    "ko": "kr",
+    "pt": "pt",
+    "ru": "ru",
+    "zh-hans": "cn",
+    "zh-hant": "tw",
+}
+
+
+def get_hreflang_code(django_language_code: str) -> str:
+    """Return the hreflang attribute value for a Django ``LANGUAGE_CODE``."""
+    from lang.conf import get_language_hreflang_map
+
+    return get_language_hreflang_map().get(
+        django_language_code, django_language_code
+    )
+
+
+def build_language_flag_map() -> dict[str, str]:
+    """Merge built-in flag regions with project / ``APP_CONFIG`` overrides."""
+    from lang.conf import get_language_flag_map
+
+    return get_language_flag_map()