Skip to main content

State Transition System for Django

Project description

# State Transition System (STS) for Django

[State Transition Systems][1] have less constraints than Finite State
Automata, and can be molded into various use cases.

The core components include:

- State
- Event
- Transition
- System

**Events** cause a **transition** from some **state** (or none if this is the
first transition) to a new state for a given **system**.

The API supports defining _immediate_ transitions and _long-running_
transitions. Now, for a riveting example..

```python
system = System(name='Example 1')
system.save()

# Immediate transition.. event => state
system.transition('Open Door', 'Door Opened')

# 'Long-running' transitions.. event happens
system.start_transition('Close Door Slowly')

# Time passes..
time.sleep(2)

# The resulting state..
system.end_transition('Door Closed')
```

`System`s can also be associated directly to an object using Django's
ContentType framework.

```python
door = Door.objects.get(name='Door #1')
system = System(content_object=door)
# ...
```

This enables bringing in django-sts to an existing model to begin tracking
states of objects.

If even comes with an abstract `STSModel` that augments a model with the above
methods for seamless integration (it does not add any model fields):

```python
class Door(STSModel):
name = models.CharField(max_length=20)

door = Door()
door.save()
door.transition('Close Door', 'Door Closed')
```

The library leaves it up to the application to implement the constraints of a
finite state automata/machine.

[1]: http://en.wikipedia.org/wiki/State_transition_system

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-sts-0.1.tar.gz (4.9 kB view details)

Uploaded Source

File details

Details for the file django-sts-0.1.tar.gz.

File metadata

  • Download URL: django-sts-0.1.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-sts-0.1.tar.gz
Algorithm Hash digest
SHA256 b2360b9ac516dd1f0a425fa1eab8e27720579301c84084b63306d3fc657c2ed9
MD5 14e9527afd87d5d580a546085a7455a9
BLAKE2b-256 45ca63327a0d89bd83bb43cfcae228e76b9979df8f2544fa5f9b34fe92c07dea

See more details on using hashes here.

Supported by

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