Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dgk/django-business-logic

Visual DSL framework for django
https://github.com/dgk/django-business-logic

blockly business-logic business-rules business-rules-engine django django-admin django-framework dsl execution-engine mobx no-code no-code-framework python rapid-development rapid-development-framework visual-programming zero-code zero-coding

Last synced: 28 days ago
JSON representation

Visual DSL framework for django

Awesome Lists containing this project

README 

        
.. image:: https://img.shields.io/github/actions/workflow/status/dgk/django-business-logic/unittests.yml

   :target: https://github.com/dgk/django-business-logic/actions/workflows/unittests.yml

   :alt: github-build



.. image:: https://img.shields.io/codecov/c/github/dgk/django-business-logic.svg

   :target: https://codecov.io/gh/dgk/django-business-logic

   :alt: codecov



.. image:: https://img.shields.io/codeclimate/maintainability/dgk/django-business-logic.svg

   :target: https://codeclimate.com/github/dgk/django-business-logic

   :alt: codeclimate



.. image:: https://readthedocs.org/projects/django-business-logic/badge/?version=latest

   :target: https://django-business-logic.readthedocs.org/

   :alt: readthedocs



.. image:: https://img.shields.io/pypi/l/django-business-logic.svg

   :target: https://django-business-logic.readthedocs.io/en/latest/license.html

   :alt: MIT license



.. image:: https://app.fossa.com/api/projects/git%2Bgithub.com%2Fdgk%2Fdjango-business-logic.svg?type=shield&issueType=license

   :target: https://app.fossa.com/projects/git%2Bgithub.com%2Fdgk%2Fdjango-business-logic?ref=badge_shield

   :alt: FOSSA Status



.. image:: https://img.shields.io/pypi/pyversions/django-business-logic.svg

   :target: https://pypi.org/project/django-business-logic/

   :alt: python versions



.. image:: https://img.shields.io/pypi/djversions/django-business-logic.svg

   :target: https://pypi.org/project/django-business-logic/

   :alt: django versions



.. image:: https://img.shields.io/pypi/v/django-business-logic.svg

   :target: https://pypi.org/project/django-business-logic/

   :alt: pypi versions



.. image:: https://img.shields.io/pypi/status/django-business-logic.svg

   :target: https://pypi.org/project/django-business-logic/

   :alt: pypi versions status



Preface

#######



Processes change more often than technic. Domain Rules are situational and may

differ from customer to customer. With diverse code and frequent changes, the code

becomes complicated, then the probability of errors increases. One of the

optimal strategies to avoid this situation is to isolate client logic at the

data level.

When this is the case, programmers need only to watch the correct interpretation

of the rules, but not each of the rules separately. This reduces the amount of

code base needed and reduces the possibility of introducing errors.  Another

question is the form of the description of these rules takes. A visual graphical

representation is optimal for users – this helps to avoid confusion with a variety

of conditions, and helps users understand what is written without any effort.

Many web applications need to use Domain Specific Languages (DSL) during their

lifecycle.  Any type of project, from hobby-level to enterprise, may have this

requirement. There are many ways to carry out this task, such as doing your own

development using internal resources or contractors (you know the cost in both

cases), buying a turnkey solution, (really?) or an adapted solution. In all

cases, you will also need to be a coach for all DSL users.



Stop now and focus your attention here.

The `Blockly `_ visual

programming library was released in 2012, and since 2014 it has been developed

with the support of Google. `Code.org `_, a related project

that uses Blockly in its main subsystems, has had hundreds of millions of users

of different ages in its `Hour of Code `_ project.

These users started as young as elementary school, and very quickly learned how

to program using the amazing Blockly library.

Even top universities teach block-based coding (e.g.,

`Berkeley `_, `Harvard `_).

But Blockly is not just a trainer or a toy. It is suitable for serious tasks:

form processing, workflows, reporting, email marketing, bots, tests, surveys,

quizzes and many other purposes.



The django-business-logic library tries to utilise the block programming

approach to delegate programming tasks to non-programmers by implementing a

framework for creating and working with Visual Domain Specific Languages.



The library comes with:



* pretty easy integration: minor changes in INSTALLED_APPS and root urlconf

* support of many types of built-in django model fields: all numeric, boolean, string, foreign keys

* logical division into interface/program/version: firstly define an "interface" object which is just a named set of django models and its fields; after you can create one or more named "programs" which implements the given interface and than release any number of the program's "versions"

* easy invocation injecting of visually edited code: a few strings in your code, at any place - a view controller, signal handler, asynchronous task, no matter the monolith or microservice

* dropdown controls with custom model object list; you need only register your custom models in the standard django admin interface

* ability to easily integrate and make accessible to the visual editor two types of python functions: imported (from python built-in, third-party or your own module) and editable through django admin

* easy to understand Blockly-based log viewer with the ability to inspect intermediate values



Do not forget that this library is not designed with professional developers in

mind, so the interface may look ugly and awkward in a professional developer’s

eyes. Try to disengage from this feeling. Think like a human who gets panicked

when seeing (our lovely) code with obscure brackets, odd commas, strange

arrows, and so on.

We, the development part of the team, can help our teammates from other

departments to do more.

Let’s bring the spirit of our successful sprints and fun development rooms to

colleagues from management, marketing, sales, logistics and many others.



Library home

############

https://github.com/dgk/django-business-logic/



Documentation

#############



https://django-business-logic.readthedocs.io/en/latest/



Support us

##########



Any feedback and github stars would be greatly appreciated.



If you are familiar with react/mobx and want to help to build django-business-logic library

(`next generation frontend code is here `_), please contact me [email protected].



License

#######



MIT license