semvec/pypi-packages huggingface dataset:
django-cms-qe 4.5.2
Django CMS Quick & Easy provides all important modules to run new page withouta lot of coding. Aims to do it very easily and securely.
License: BSD License
Requires Python: >=3.10
Keywords: django, cms

# Django CMS QE

Django CMS Quick & Easy provides all important modules to run new page
without a lot of coding. Aims to do it very easily and securely.

For more information please read [documentation](<https://websites.pages.nic.cz/django-cms-qe>) or [GitLab](https://gitlab.nic.cz/websites/django-cms-qe).

## Development

To prepare your dev environment run this command:

    make prepare-dev  (run with apt get update)
    make prepare-env

Caution! It is allowed only Python >= 3.9 due to typing:

    VENV_PYTHON=/usr/bin/python3.9 make prepare-venv

To prepare the explicit python version into the explicit folder:

    VENV_PATH=/home/username/venv VENV_PYTHON=/usr/bin/python3.9 make prepare-venv
    export VENV_PATH=/home/username/venv

To run tests or lint use this commands:

    make test
    make lint

To run only particular test:

    make test=cms_qe_table/tests/test_utils.py::test_get_model_by_table test

To run example use this command:

    make run-example


To call other Django commands:

    make cmd  (List django commands, same like --help)
    make cmd=dbshell cmd
    make cmd='createsuperuser --username=dave --email=dave@rd.foo' cmd

To find more useful commands, run just `make`.

## Upgrade

To upgrade from version `2.2` to version >= `3.0.0`, you can use the [DjangoCMS upgrade plugins](https://gitlab.nic.cz/utils/djangocms-upgrade-plugins) tool.

## Example in Docker

Download example:

    curl https://gitlab.nic.cz/websites/django-cms-qe/-/archive/master/django-cms-qe.zip?path=example --output example.zip

Unzip and go to the example folder:

    unzip example.zip
    cd django-cms-qe*/example/

Build the site image:

    docker compose build

Run website in docker:

    docker compose up -d

See the website at http://localhost:8000/. Login into http://localhost:8000/admin/ as username ``admin`` with password ``admin``.
To run on a different port, specify the PORT parameter:

    PORT=8008 docker compose up -d

Please wait a moment before browsing the website. It takes a while for all migrations to be completed and data to be loaded.
You can monitor the status of this process in the log:

    docker compose logs -f web

Stop the website:

    docker compose down