Repository files navigation

![License GPL 3][badge-license]

JGraLab is a Java graph library implementing so-called TGraphs: typed,attributed, ordered, and directed graphs. Beyond the plain data structure, thelibrary contains an extensive algorithm library, the graph query languageGReQL, the transformation API GReTL, and tons of utilities.

The following assumes that you create (or use) a workspace folderjgsrc for JGraLaband your JGraLab applications. Name and location of that workspace can be arbitrarilychosen.

When you plan to use Eclipse as IDE, the easiest is to put thejgralab folder intoyour Eclipse workspace folder.

The Ant build scripts require that your applications are locatedin sibling folders next tojgralab.

jgsrc/               # your jgralab workspace+-> jgralab/         # this project, i.e., jgralab itself+-> mygraphproject   # your app has to sit next to jgralab

To buildjgralab you need to haveApache Ant.Buildjgralab.

$ cd jgsrc/jgralab/$ ant

Thejgralab folder contains an Eclipse.project and.classpath file, so that youcan import it in Eclipse as existing project. This import step is necessary also whenyou initially decided to put JGraLab into the Eclipse workspace sinceEclipse does not automatically scan its workspace for new projects.

JGRaLab's Ant build generates many source files. Each time you runant, you haveto refresh the project in Eclipse, so that the changes get reflected in the IDE.

The current and past JGraLab releases are pushed tothe JGraLab Clojars site sothat you can fetch them easily as project dependency via theMaven orLeiningen buildand project management systems.

You can download nightly builds from oursnapshots page. Thesource jars contain the compiled class files and the source files. As such,they are preferrable to the binary-only builds when you intend to developapplications using JGraLab, because then you get nicer code completion, e.g.,the real names of method parameters instead of justarg0.

You can find the API documentation for the current JGraLab master branch at ourAPI Docs Page. Thisdocumentation is regenerated every night.

Every night, we run all our test cases against the current master branch andmeasure our coverage usingAtlassian Clover. Theresults are accessible at ourCoverage Report Page.

We've started writing a tutorial in theJGraLab Wiki. It's not yetcomplete, but we'll keep working on extending it.

Join us on the official JGraLab IRC Channel(channel#jgralab onirc.freenode.net). If you don't have or don't want toinstall an IRC client, you can alsochat directly in your browser.

• GReTL: an extensible, operational, graph-based transformation language,Jürgen Ebert and Tassilo Horn, In: Software and Systems Modeling, 2012,http://dx.doi.org/10.1007/s10270-012-0250-3
• The GReTL Transformation Language, Tassilo Horn and Jürgen Ebert, In:Theory and Practice of Model Transformations - 4th InternationalConference, ICMT 2011,http://dx.doi.org/10.1007/978-3-642-21732-6_11
• Solving the TTC 2011 Compiler Optimization Case with GReTL, Tassilo Horn,TTC 2011,http://arxiv.org/abs/1111.4745v1
• Solving the TTC 2011 Reengineering Case with GReTL, Tassilo Horn, TTC2011,http://arxiv.org/abs/1111.4747
• Saying Hello World with GReTL - A Solution to the TTC 2011 InstructiveCase, Tassilo Horn, TTC 2011,http://arxiv.org/abs/1111.4762
• Reverse Engineering Using Graph Queries, Jürgen Ebert and DanielBildhauer, In: Schürr, Andy; Lewerentz, Claus; Engels, Gregor; Schäfer,Wilhelm; Westfechtel, Bernhard: Graph Transformations and Model DrivenEngineering, 2010,http://uni-koblenz.de/~ist/documents/Ebert2010REU.pdf

Copyright (C) 2006-2014 The JGraLab Teamist@uni-koblenz.de

Distributed under theGeneral Public License, Version 3 withthe following additional grant:

Additional permission under GNU GPL version 3 section 7If you modify this Program, or any covered work, by linking or combining itwith Eclipse (or a modified version of that program or an Eclipse plugin),containing parts covered by the terms of the Eclipse Public License (EPL),the licensors of this Program grant you additional permission to convey theresulting work.  Corresponding Source for a non-source form of such acombination shall include the source code for the parts of JGraLab used aswell as that of the covered work.

![License GPL 3][badge-license][badge-license]:https://img.shields.io/badge/license-GPL_3-green.svg