Hi! So very glad you are interested in Frame. Frame system design markdown language for software architects and engineers. It is an easy to learn textual language for defining system specifications that can generate both UML documentation as well as code in 7 langauges.
This project contains the code for building the Frame Language Transpiler - the Framepiler. The Framepiler is written in Rust and transpiles Frame specification documents into 6 programming languages (more to come) and UML documentation.
This release brings a slew of features focused on Rust, Frame's newest language. All of these new capabilites are only implemented in Rust, but will be rolled out to other languages as they gain users and build a community.
- Configurable code generation
- Rust formatting improvements
- Code conforms more closely to rustfmt guidelines.
- Added introspection - codegen to discover the current state
- Added interface call syntax iface() - call the interface from event handlers.
- Rust Transition hook - inject a call to al trait function to log transition data.
The Frame project is just getting started but there are some resources and communities to help. You can now download VSCode and Atom extensions to work with Frame in these popular free development applications.
An online version of the Framepiler is also available and provides examples and links to other resources. You can learn more about the Frame language at frame-lang.org as well as find general resources about programming with automata at Reddit on the r/statemachines subreddit.
Communities exist at Gitter and Discord.
The Framepiler itself has a number of examples baked into it but I also have started a Gitter Frame Examples channel for contributions. The Framepiler supports links to Gists so please create and share!
The Frame Solution Depot is a Github repo and growing body of examples and test specifications. This is useful in conjunction with the VSCode and Atom extensions.
For now please report issues to the Gitter Bug Channel while we get a better system in place. If you have a recommendation please let me know there!
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
- Install Rust.
- Navigate to the framepiler/framec directory.
- Type
cargo build. 3.a You will see a bunch of warnings. Apologies but this is pre-alpha code. - Type
./target/debug/framec ../examples/HelloWorld.frm c_sharp. 4.a You should see a base class for a Frame controller generated to stdout. - If you want to generate a release build:
5.a Type
cargo build --release5.b Type./target/release/framec ../examples/HelloWorld.frm c_sharp - You now have working debug and release Framepilers. Congratulations!
- You can try 6 other languages + Plant UML. Replace the
c_sharpabove with any of these: 7.ajavascript7.bcpp7.cgdscript7.djava_87.eplantuml(try output at PlantUml site) 7.fpython_37.grust(experimental - only partially implemented)
- Install Rust.
- Probably the same as MacOS but guessing you can figure it out if you know Linux and Rust. Still - please send me instructions on Gitter Bug Channel and I will add to next release notes. Thanks!
- Install Rust.
- Help needed. Please send me instructions on Gitter Bug Channel and I will add to next release notes. Thanks!
- Rust - Rust language
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the tags on this repository.
- Mark Truluck - Creator of Frame - LinkedIn
This project is licensed under the MIT License - see the LICENSE.md file for details
- Alan Turning - For inventing automata theory and helping end WWII. See The Imitation Game
- Dr. David Harel - Who invented Statecharts from which came Frame.