Skip to main content

A collection of Django apps defining data models for managing chemical species, reactions and datasets.

Project description

Django-Valem is a collection of Django apps defining data models for parsing, validation, manipulation and interpretation of chemical reactions, formulas, and quantum states. The django-valem apps package is based around PyValem.

Installation:

The django-valem apps can be installed either from PyPI using pip

python3 -m pip install django-valem

or from the source by running from the project source directory

python3 -m pip install .

Configuration:

The django-valem apps can be added to any Django project by adding the following apps into the INSTALLED_APPS list in the settings.py of the project:

INSTALLED_APPS = [
    ...

    "rp",  # App handling species and their states
    "rxn",  # App handling chemical reactions between species (rp.RP instances)
    "ds",  # App handling datasets attached to rxn.Reaction instances
    "refs",  # App handling references for ds.ReactionDataSet subclasses instances
]

For Developers:

It goes without saying that any development should be done in a clean virtual environment. After cloning or forking the project from its GitHub page, django-valem might be installed into the virtual environment in editable mode with

pip install -e .[dev]

or on zsh:

pip install -e .'[dev]'

The [dev] extra installs (apart from the package dependencies) also several development-related packages, such as black, ipython, or django itself. The tests can then be executed by running (from the project root directory)

python runtests.py

The project does not have requirements.txt by design, all the package dependencies are rather handled by setup.py. The package needs to be installed to run the tests, which grants the testing process another layer of usefulness.

The project code is formatted by black. Always make sure to format your code before submitting a pull request, by running black on all your python files, or black . from the project source directory.

If the rp.models.py, or rxn.models.py are changed, the makemigrations.py script needs to be run to make migrations for the apps, before the apps are pushed to master, or published to PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-valem-0.1.14.tar.gz (18.9 kB view hashes)

Uploaded Source

Built Distribution

django_valem-0.1.14-py3-none-any.whl (16.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page