59 breaking releases

0.142.0 Sep 28, 2023
0.140.0 Sep 28, 2023
0.103.0 Jul 31, 2023
0.95.0 Mar 12, 2023
0.1.0 Jan 29, 2018

#351 in Programming languages


Used in flowide

MIT license

450KB
10K SLoC

flowc

flowc is the "compiler and linker" for flows and flow libraries, although it is not very similar to what you might be familiar with as a compiler or linker.

It is part of the overall flow project (README.md).

It loads flow definition files, and builds the flow hierarchy reading from referenced flows/functions and library references, and builds the flow in memory.

Then it connects all functions via data flows through the hierarchy and removes most of the flow structure leaving a "network of functions" which it then optimizes (removing unused functions and connections).

It checks that types match and required connections exist.

It also checks for some illegal or cases that would prove problematic at runtime (specific types of "loops" or contention for a connection)

Lastly it generates a manifest describing the flow, which can be executed by flowr.

It then may (depending on the command line options used) invoke flowr (using cargo to ensure it is up to date and built).

It is structured as a library with a thin CLI wrapper around it that offers command line arguments and then uses the library to compile and optionally run the compiled flow.

flowrclib

This library contains most of the compilation and linking logic for flowc.

features

These are the conditionally compiled features of the flowc crate:

  • default - The "debugger" feature is enabled by default
  • debugger - feature to add the debugger

Dependencies

~27–40MB
~676K SLoC