COMPONENTS AND APPLICATIONS / SOFTWARE BILL OF MATERIALS
--------------------------------------------------------

GrGen.exe: C#/.NET compiler application
- uses FrontendGrGen.exe compiler frontend
- pattern matcher and sequence code generation, utilizing a few of the components mentioned below (esp. sequence parsing)

(G)GrShell: C#/.NET shell application
- command line interpreter, based on a CSharpCC-generated parser for the shell language
- with graph rendering, sequence execution and debugging functionality supplied by several internal libraries and external libraries/programs,
  some are only loaded on-demand/as-needed
- two versions: console application GrShell, Windows Forms GUI console application GGrShell, based on a common C# shell library

Several internal C#/.NET libraries:
- libGr/lgspBackend containing e.g. the runtime environment including pattern matcher re-generation and the sequences interpreter
- the graph viewer and the sequence debugger library and its Windows Forms extension
- a console and OS abstraction library and its Windows Forms extension
- a persistence provider library implementing the persistent graph
- they employ CSharpCC-generated parsers for the sequence language, and constant literals

External libraries/programs:
- the MSAGL library for graph drawing, in its Windows Forms version
- the SQLite database for persistent storage of the graph

FrontendGrGen.exe: compiler frontend (formerly grgen.jar)
- model code, pattern specification and rewrite code generation, plus sequences checking
- ANTLR-generated parsers for the model and the actions language, as well as the sequence language (compiled embedded sequences)

extMSAGLExt.exe: graph viewer application
- graph vizualization based on the internal Windows Forms graph viewer library, which in turn is based on the MSAGL library
- ANTLR-generated parser for VCG file import

yComp.jar: JAVA graph visualization application
- based on yFiles for graph drawing
- utilizing Java ANTLR

The following section goes into detail regarding the exact files, plus the version numbers and package sources.
LICENSE.txt lists the licenses that apply to the components (/files).


USAGE SCENARIOS AND DEPENDENCIES
--------------------------------

Running a generated graph rewrite system from an own application deployed to some user machine
 employing compiled model and actions dlls from API level, sequences execution from API,
needs libConsoleAndOS.dll, libGr.dll, lgspBackend.dll (dlls from LGPL licensed code)
Prerequisite: .NET Framework or mono

Additional graph visualization by MSAGL or sequence debugging needs graphViewerAndSequencesDebugger.dll
and graphViewerAndSequencesDebuggerWindowsForms.dll plus libConsoleAndOSWindowsForms.dll
 they require Microsoft.Msagl.dll, Microsoft.Msagl.Drawing.dll, Microsoft.Msagl.GraphViewerGdi.dll, 
 plus the System.***.dlls you find in the bin folder (with exception of the SQLite one)
Additional database persistence by SQLite needs libGrPersistenceProviderSQLite.dll
 they require System.Data.SQLite.dll, and e_sqlite3.dll for Windows (x64) or libe_sqlite3.so for Linux (x64)
Additional shell script execution/shell functionality needs libGrShell.dll

MSAGL: Imported via nuget package Microsoft.Msagl.GraphViewerGDI 1.1.7
SQLite: Imported via nuget package System.Data.SQLite 2.0.4 and SourceGear.sqlite3 3.53.4

In order to visualize graphs with graphviz, you have to install the corresponding package and make the programs available in the search path.

Developing a graph rewrite system with GrGen.exe (compilation without debugging)
 model and actions specification files are compiled with GrGen to model and actions dlls
This needs the same as "Running a generated graph rewrite system" without additions,
additionally the GrGen compiler frontend FrontendGrGen.exe is required,
it needs Antlr3.Runtime.dll (and utilizes a C# port of the jargs library from https://github.com/purcell/jargs)

Antlr3.Runtime.dll (FrontendGrGen.exe and extMSAGLExt.exe): ANTLR .NET version 3.5.0.2 from https://theantlrguy.atlassian.net/wiki/spaces/ANTLR3/pages/2686980/Antlr3CSharpReleases

Running a generated graph rewrite system from the execution host GrShell.exe
 as an interactive workbench application or a script execution host
needs the same as "Running a generated graph rewrite system" without additions, 
when optional functionality is needed, the according additions are required,
 GGrShell.exe requires libConsoleAndOSWindowsForms.dll in addition
Allowed in academia: additional graph visualization by yComp, needs graphViewerAndSequencesDebugger.dll utilizing yComp.jar,
 which requires yObf.jar, graphmlObf.jar, ysvgObf.jar, batik.jar, antlr-3.1.1.jar (graphViewerAndSequencesDebuggerWindowsForms.dll is not needed then)
Prerequisite: JAVA (RE)
Allowed also outside of academia: additional graph visualization by extMSAGLExt, needs graphViewerAndSequencesDebugger.dll utilizing extMSAGLExt.exe,
 which requires graphViewerAndSequencesDebuggerWindowsForms.dll (for the MSAGLExt user control) and its dependencies plus Antlr3.Runtime.dll

yComp.jar requires antlr-3.1.1.jar (https://www.antlr3.org/download.html, https://pp.ipd.kit.edu/firm/yComp.html).

Developing a graph rewrite system with GrShell or GGrShell
 they automatically employ the GrGen compiler as needed (requires the dependencies of "Developing a graph rewrite system with GrGen.exe")
 (it works like a mini-make, following the includes and checking the file dates)
 (for debugging, the according graph visualization/sequence debugger additions are employed)

----------------

Developing GrGen itself requires the source code from the public git repository at https://github.com/ejaku/grgen
You may also build it locally to gain access to the debug symbols and source level diagnostics in case of crashes,
or in order to be able to use the newest features before an official release.
Then you need further components, as explained in BUILDING_AND_TESTING.txt (sources only).
The most complete source of documentation, the user manual, also contains a chapter on "Understanding and Extending GrGen.NET".

It requires at compile time Antlr3.exe, which is contained, the same source and version information as for the Antlr3.Runtime.dll applies.

It requires the CSharpCC parser generator, which is contained, the CSharpCC 3.2 binary
is likely a home-brew version of MinosseCC built at 2008-03-10 by Moritz Kroll
(described at https://www.codeproject.com/articles/MinosseCC-a-lexer-parser-generator-for-C-#comments-section by Antonello Provenzano,
 you may find it in the internet archive when searching for http://www.codeproject.com/Articles/11632/MinosseCC-a-lexer-parser-generator-for-C).

NUnit and NUnit3TestAdapter used for testing:
Imported via nuget package NUnit 3.12.0 and NUnit3TestAdapter 6.1.0 (plus Microsoft.NET.Test.Sdk 16.5.0)
