Skip to content

Light, pythonic implementation of Gary Bernhardt's "Functional Core, Imperative Shell" pattern.

Notifications You must be signed in to change notification settings

eykd/nonobvious

Repository files navigation

nonobvious

The first python package to jump across the English Channel!

https://travis-ci.org/eykd/nonobvious.svg?branch=master https://coveralls.io/repos/eykd/nonobvious/badge.png

This package attempts to implement the "functional core, imperative shell" pattern described in Gary Bernhardt's talk on Boundaries, using some ideas found in the Ruby obvious project.

Functional Core, Imperative Shell

The basic idea is that your core domain model implements business logic using functional techniques, with immutable values and copy-on-write. The functional core is wrapped by an imperative shell which drives the core models and interacts across the boundary with the outside world through "primitive" values. The immutable domain models can be easily converted to primitive data structures whose state has no affect on the immutable core.

nonobvious.models and nonobvious.fields provide a declarative modeling language, similar to Django's model objects, but without an ORM. We can easily use validators and adaptors from the valideer project to ensure that the models are always in a valid state and can easily be constructed from standard python data structures.

By making use of concon.frozendict, concon.frozenlist, and concon.frozenset within model adaptors allows us to model complex data structures guaranteed to be correctly formed at all times.

As for the imperative shell, at present, you're on your own!

About

Light, pythonic implementation of Gary Bernhardt's "Functional Core, Imperative Shell" pattern.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages