{"id":15371417,"url":"https://github.com/codingjoe/joeflow","last_synced_at":"2025-04-13T00:49:28.692Z","repository":{"id":33616394,"uuid":"155892593","full_name":"codingjoe/joeflow","owner":"codingjoe","description":" The workflow automation framework for machines with heart","archived":false,"fork":false,"pushed_at":"2025-04-03T06:51:54.000Z","size":399,"stargazers_count":96,"open_issues_count":7,"forks_count":27,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-13T00:48:59.273Z","etag":null,"topics":["automation","automation-framework","django","edges","framework","process","python","workflow","workflow-engine"],"latest_commit_sha":null,"homepage":"https://joeflow.rtfd.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codingjoe.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"codingjoe","tidelift":"pypi/joeflow","custom":"https://www.paypal.me/codingjoe"}},"created_at":"2018-11-02T16:25:19.000Z","updated_at":"2025-04-10T07:44:59.000Z","dependencies_parsed_at":"2024-11-14T16:53:31.810Z","dependency_job_id":"01786ede-4abc-4ea9-8220-73ac5265f0bd","html_url":"https://github.com/codingjoe/joeflow","commit_stats":{"total_commits":139,"total_committers":9,"mean_commits":"15.444444444444445","dds":0.5971223021582734,"last_synced_commit":"760bd2a4b06a01859bca564ab94249be51245771"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingjoe%2Fjoeflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingjoe%2Fjoeflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingjoe%2Fjoeflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingjoe%2Fjoeflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codingjoe","download_url":"https://codeload.github.com/codingjoe/joeflow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650436,"owners_count":21139672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","automation-framework","django","edges","framework","process","python","workflow","workflow-engine"],"created_at":"2024-10-01T13:46:50.283Z","updated_at":"2025-04-13T00:49:28.675Z","avatar_url":"https://github.com/codingjoe.png","language":"Python","readme":"joeflow\n=======\n\n**The lean workflow automation framework for machines with heart.**\n\n.. figure:: docs/img/pexels-photo-1020325.jpeg\n   :alt: a hand drawn robot\n\nJoeflow is a free workflow automation framework designed to bring\nsimplicity to complex workflows. Joeflow written in `Python`_ based on\nthe world famous `Django`_ web framework.\n\nHere is a little sample of what a workflow written in joeflow may look\nlike:\n\n.. code-block:: python\n\n    from django.core.mail import send_mail\n    from jowflow.models import WorkflowState\n    from joeflow import tasks\n    from joeflow.workflows import Workflow\n\n\n    class Shipment(WorkflowState):\n        email = models.EmailField(blank=True)\n        shipping_address = models.TextField()\n        tracking_code = models.TextField()\n\n    class ShippingWorkflow(Shipment, Workflow):\n        checkout = tasks.StartView(fields=[\"shipping_address\", \"email\"])\n\n        ship = tasks.UpdateView(fields=[\"tracking_code\"])\n\n        def has_email(self):\n            if self.email:\n                return [self.send_tracking_code]\n\n        def send_tracking_code(self):\n            send_mail(\n                subject=\"Your tracking code\",\n                message=self.tracking_code,\n                from_email=None,\n                recipient_list=[self.email],\n            )\n\n        def end(self, task):\n            pass\n\n        edges = [\n            (checkout, ship),\n            (ship, has_email),\n            (has_email, send_tracking_code),\n            (has_email, end),\n            (send_tracking_code, end),\n        ]\n\nDesign Principles\n=================\n\nCommon sense is better than convention\n--------------------------------------\n\nJoeflow does not follow any academic modeling notation developed by a\npoor PhD student who actually never worked a day in their life.\nBusinesses are already complex which is why Joeflow is rather simple.\nThere are only two types of tasks – human \u0026 machine – as well as edges\nto connect them. It’s so simple a toddler (or your CEO) could design a\nworkflow.\n\nLean Automation (breaking the rules)\n------------------------------------\n\nThings don’t always go according to plan especially when humans are\ninvolved. Even the best workflow can’t cover all possible edge cases.\nJoeflow embraces that fact. It allows uses to interrupt a workflow at any\ngiven point and modify it’s current state. All while tracking all\nchanges. This allows developers to automate the main cases and users\nhandle manually exceptions. This allows you businesses to ship\nprototypes and MVPs of workflows. Improvements can be shipped in\nmultiple iterations without disrupting the business.\n\nPeople\n------\n\nJoeflow is build with all users in mind. Managers should be able to\ndevelop better workflows. Users should able to interact with the tasks\nevery single day. And developers should be able to rapidly develop and\ntest new features.\n\nFree\n----\n\nJoeflow is open source and collaboratively developed by industry leaders\nin automation and digital innovation.\n\n*Photo by rawpixel.com from Pexels*\n\n.. _Python: https://python.org\n.. _Django: https://www.djangoproject.com/\n","funding_links":["https://github.com/sponsors/codingjoe","https://tidelift.com/funding/github/pypi/joeflow","https://www.paypal.me/codingjoe"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingjoe%2Fjoeflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodingjoe%2Fjoeflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingjoe%2Fjoeflow/lists"}