mirror of
https://github.com/SectorLabs/django-localized-fields.git
synced 2025-04-24 11:22:54 +03:00
5bb16af6a4
* Support for Django 4 * Change pytest-django version * Change psycopg2 version * Change pytest version * Change tox version * Change pytest-cov version * Update circle ci jobs * Fix ci jobs * Update ci to postgres 12 * Allow Django 5.0 * Bump Django min version to 3.2 * Fix CI to account for >= 3.2 requirement * Fix quote * Remove python 3.12 for now due to distutils removal * Remove Django upper bound * Add back python3.6,3.7 wfs * Downgrade dj-database-url * Fix isnull issue from Django 4
59 lines
3.6 KiB
Markdown
59 lines
3.6 KiB
Markdown
| | | |
|
|
|--------------------|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| :white_check_mark: | **Tests** | [](https://circleci.com/gh/SectorLabs/django-localized-fields/tree/master) |
|
|
| :memo: | **License** | [](http://doge.mit-license.org) |
|
|
| :package: | **PyPi** | [](https://pypi.python.org/pypi/django-localized-fields) |
|
|
| <img src="https://cdn.iconscout.com/icon/free/png-256/django-1-282754.png" width="22px" height="22px" align="center" /> | **Django Versions** | 2.0, 2.1, 2.2, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 5.0 |
|
|
| <img src="http://www.iconarchive.com/download/i73027/cornmanthe3rd/plex/Other-python.ico" width="22px" height="22px" align="center" /> | **Python Versions** | 3.6, 3.7, 3.8, 3.9, 3.10, 3.11 |
|
|
| :book: | **Documentation** | [Read The Docs](https://django-localized-fields.readthedocs.io) |
|
|
| :warning: | **Upgrade** | [Upgrade fom v5.x](https://django-localized-fields.readthedocs.io/en/latest/releases.html#v6-0)
|
|
| :checkered_flag: | **Installation** | [Installation Guide](https://django-localized-fields.readthedocs.io/en/latest/installation.html) |
|
|
|
|
`django-localized-fields` is an implementation of a field class for Django models that allows the field's value to be set in multiple languages. It does this by utilizing the ``hstore`` type (PostgreSQL specific), which is available as `models.HStoreField` since Django 1.10.
|
|
|
|
---
|
|
|
|
:warning: **This README is for v6. See the `v5.x` branch for v5.x.**
|
|
|
|
---
|
|
|
|
## Working with the code
|
|
### Prerequisites
|
|
|
|
* PostgreSQL 12 or newer.
|
|
* Django 2.0 or newer.
|
|
* Python 3.6 or newer.
|
|
|
|
### Getting started
|
|
|
|
1. Clone the repository:
|
|
|
|
λ git clone https://github.com/SectorLabs/django-localized-fields.git
|
|
|
|
2. Create a virtual environment:
|
|
|
|
λ cd django-localized-fields
|
|
λ virtualenv env
|
|
λ source env/bin/activate
|
|
|
|
3. Create a postgres user for use in tests (skip if your default user is a postgres superuser):
|
|
|
|
λ createuser --superuser localized_fields --pwprompt
|
|
λ export DATABASE_URL=postgres://localized_fields:<password>@localhost/localized_fields
|
|
|
|
Hint: if you're using virtualenvwrapper, you might find it beneficial to put
|
|
the ``export`` line in ``$VIRTUAL_ENV/bin/postactivate`` so that it's always
|
|
available when using this virtualenv.
|
|
|
|
4. Install the development/test dependencies:
|
|
|
|
λ pip install ".[test]" ".[analysis]"
|
|
|
|
5. Run the tests:
|
|
|
|
λ tox
|
|
|
|
7. Auto-format code, sort imports and auto-fix linting errors:
|
|
|
|
λ python setup.py fix
|