citiususc / jflap-lib

An improved version of JFLAP 7.0 to be used as a library as well as a command line tool.

jflap-lib

Jflap-lib is an improved version of JFLAP 7.0 to be used as a library and a command line tool, specially useful for building auto-grading tools.

What is JFLAP?

JFLAP is an extremely useful software for teaching and learning about formal languages. According to jflap.org, "JFLAP is software for experimenting with formal languages topics including nondeterministic finite automata, nondeterministic pushdown automata, multi-tape Turing machines, several types of grammars, parsing, and L-systems". JFLAP is mantained by Susan H. Rodger et al. from the Department of Computer Science at Duke University.

What is jflap-lib?

This project is a minor modification of the original JFLAP 7.0 to replace the usage of System.out and System.err by a logger facade (slf4j) plus some code to enhance the current API and to provide command line tools.

Modules

• jflaplib-core: full JFLAP 7.0 code adapted to be used as a library
• jflaplib-cli: command line tool

Installation

This project relies on jitpack.io instead of maven central to deliver artifacts. If you use maven, just add the following snippet to your pom.xml file to use the jitpack repository:

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

Finally, include jflap-lib as a dependency:

<dependency>
    <groupId>com.github.citiususc</groupId>
    <artifactId>jflap-lib</artifactId>
    <version>1.3</version>
</dependency>

You can also download the compiled jars from the release page or from jitpack.io.

Example

It is very easy to use JFLAP programatically. Here is an example of how to load a jff automaton and test it with an input:

// Load an automaton jff file
FiniteStateAutomaton automaton = (FiniteStateAutomaton)new XMLCodec().decode(new File("example.jff"), null);
// Load a simulator to test the automaton
AutomatonSimulator sim = SimulatorFactory.getSimulator(automaton);
if (sim == null) throw new RuntimeException("Cannot load an automaton simulator for " + automaton.getClass());
// Test the automaton with an input
System.out.println(sim.simulateInput("10010"));

Command line tool

The module jflaplib-cli provides a command line tool with basic functionality. A bundle jar can be generated by running mvn clean package or it can be downloaded from the release page. Here are some examples:

Runs the provided automaton on the input 10110

$ java -jar jflaplib-cli-1.3-bundle.jar run /tmp/file.jff 10110

Checks if the two FSA accept the same language

$ java -jar jflaplib-cli-1.3-bundle.jar equivalent /tmp/file1.jff /tmp/file2.jff

Converts a FSA to its equivalent regular expression

$ java -jar jflaplib-cli-1.3-bundle.jar regular /tmp/file1.jff

JFLAP 7.0 License

This project contains the original JFLAP 7.0 source code with some modifications to make it suitable for using it as a library. Here is a copy of the original JFLAP 7.0 License:

JFLAP 7.0 LICENSE

Susan H. Rodger
Computer Science Department
Duke University
August 27, 2009

Duke University students contributing to JFLAP source include: Thomas Finley,
Ryan Cavalcante, Stephen Reading, Bart Bressler, Jinghui Lim, Chris Morgan,
Kyung Min (Jason) Lee, Jonathan Su and Henry Qin.

Copyright (c) 2002-2009
All rights reserved.


I)  You are allowed distribute unmodified copies of JFLAP under the following two conditions:
    1) You must include a copy of this license text.
    2) You cannot charge a fee for any product that includes any part of JFLAP, in source or binary form.


II) You are allowed to distribute modified copies of JFLAP under the following conditions:
    1) You must include a copy of this license text.
    2) You cannot charge a fee for any product that includes any part of your modified JFLAP, in source or binary form.
    3) If you made the changes yourself, you must clearly describe how to contact you.
       When the maintainer asks you (in any way) for a copy of the modified JFLAP you distributed, you
       must make your changes, including source code, available to the maintainer without fee.  
       The maintainer reserves the right to include your changes in the official version of JFLAP. 
       The current maintainer is Susan Rodger <[e-mail]>. If this changes, it will be announced at www.jflap.org.
       

The name of the author may not be used to
endorse or promote products derived from this software without
specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Project License

This project (except jflaplib-core module which contains the original code plus some modifications of JFLAP 7.0) is released under MIT License:

The MIT License

Copyright (c) 2015 Centro de Investigación en Tecnoloxías da Información (CiTIUS), 
University of Santiago de Compostela (USC).

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.