Skip to content
/ pakken Public

Model-driven code-generation for everything. CONCEPT

License

Notifications You must be signed in to change notification settings

kegesch/pakken

Repository files navigation

Pakken

Github Build Status FOSSA Status Hits-of-Code dependency status Gitter

Pakken is a tool for software development. It aims to provide support to model and design the software with minimal coding effort known as "low code". Meaning you design the model of the software and it can generate a basic boilerplate and implementation of the model. For instance it generates the boilerplate for a graphql backend and also generates components in React that automatically are in sync with the backend.

The DSL

Yay, another DSL! But this is one is straight forward.

Namespace

This defines the namespace / scope where the Entitys are living.

example.namespace.org {
    # here should be the Entitys
}

Entity

An Entity can be a Structure an Enum or a Scalar(but those are inbuilt). Structures can be declared like this:

ExampleEntity : MyParent {
    attribute1: Entity [2,5], # Array of Entities with underbound 2 and upperbound 5
    attribute2: OtherEntity,
    operation1(param1: Entity): ResultingEntity
}

Multiplicity of an Attribute

The multiplicity of attributes is optional. If no one is declared the parser assumes it as multiplicity 1. Other options are:

  • [<int>] means an array of the size of <int>
  • [<int1>, <int2>] means an array with under bound <int1> and upper bound <int2
  • ? means optional -> 0 or 1 ()

Building

Clone the repository and run cargo build -p cli. The binary can be found in ./target.

Executing

Initiliazing a project

Run cli new <projectname>. This creates a folder projectname with following files:

  • .pakken.ron: This is the project file, containing project settings etc.
  • projectname.pkn: This is the model file for Pakken. This file describes the model with the DSL.

Generating code for a target

Run cli gen <targetname>. This will generate the file structure described by the target along with the generated code. It will also create a generator file <targetname>.pgen containing settings for the generation process.

Roadmap

  • Develop a DSL that suits the needs
  • Build a Parser for that DSL
  • Start to develop a CLI for the tool
  • Basic implementation of a workflow (MVP)
    • Design architecture for the different targets
    • Implement one example target
    • Think about glueing different targets together
  • Evaluate this concept and change accordingly
  • Refactor code base according to the new plan
  • Write documentation
  • Implement new targets

Possible Targets

A target is a language / framework / platform which the code should be generated to.

  • Databases
    • SQL
  • Endpoints
    • Rest
    • GraphQL
  • Client Frameworks
    • React
    • Angular
    • Vue.js
  • Languages
    • JavaScript
    • TypeScript
    • Java
    • C#
    • Rust

Related Work

There are already some projects that aim at code generation to boost the efficiency of developing apps.

  • Yeoman helps you to scaffold your project structure based on already designed generators.
  • NinjaCodeGen seems outdated and was just designed for Angular.
  • Conjure generates you a backend api based on a description of that and can also generate types/code for that api in specific languages/frameworks.
  • Prisma handles your database and generates language abstraction based on a graphql model.
  • Ecore promises a lot of modelling tools. But in reality it is really hard to work with it which is the reason I started building Pakken

Do differentiate Pakken from those it has following goals.

Goals

  • Domain Driven Development
  • Code Generation
    • Implemented code for the domain based on best practices in that language / framework
    • Tests (as far as possible)
  • Seamless inter operation between all generated code

Contributing

Although contributing is very welcome. At the moment this project is not yet planned. If you are interested about this project / low-code or code-generation in general, feel free to submit an issue with your wishes or expectations.

License

FOSSA Status

About

Model-driven code-generation for everything. CONCEPT

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages