Skip to main content

A Django app that helps you creating models within a Complex System.

Project description

Django Complex System Models

A Django app that helps you creating models within a Complex System.

License

Software licensed under MPL 2.0 license.

Installation

pip install django-cs-models

Usage

Two parameters have to be set in your settings. Here is an example:

COMPLEX_APP_NAME = 'ecosystem'

COMPLEX_STRUCTURE = {
    'roots': [
        ['Organization', 'Committee', 'Board', 'Cohort'],
    ],
    'nodes': [
        ['ProjectTeam'],
        ['Resource'],
        ['Member'],
    ]
}

Roots are entities that contain nodes (a root cannot contain another root). Nodes are entities contained by and containing other nodes.

You can define roots and nodes at different levels, i.e. their position in the hierarchy. These levels will tell if such entity can be contained by such other entity.

Now in ecosystem app:

from csmodels.models import abstract_model

class Cohort(abstract_model('Cohort')):
    your_model_fields_here = models.SomeField()

    class Meta:
        verbose_name = _('Cohort')
        verbose_name_plural = _('Cohorts')

The cohort model will inherit many to many relationships to project teams, resources and members from the abstract model.

Of course, a change in the complex structure will change the models, therefore migrations will be needed!

First diagram shows the example above.

Example diagram

Second diagram shows how links are created between entity depending on their type (root or node) and their level. Letters (their names) are not important, but numbers (their levels) are.

Abstract diagram

Documentation

https://github.com/Pawamoy/django-cs-models.wiki

Development

To run all the tests: tox

Changelog

0.1.0 (2016-10-06)

  • Alpha release on PyPI.

Download files

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

Source Distribution

django-cs-models-1.0.0.tar.gz (20.7 kB view hashes)

Uploaded Source

Built Distribution

django_cs_models-1.0.0-py2.py3-none-any.whl (6.3 kB view hashes)

Uploaded Python 2 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