Latest 0.0.18
Homepage https://github.com/mathiasquintero/Pushie
License MIT
Platforms ios 8.0
Authors

alt text

Push Down Automaton Creation in Swift. The easy way.

Pushie allows you to create Push down automata quickly and easily, for quick and simple Parsing of your own defined languages. Designed to be easy to read and understand

Documentation

You can see the automatically generated Documentation here:
Documentation

Usage

First install the Pod

pod 'Pushie'

Creating your Automaton

To create you Automaton you will have to:

  1. Create the different States in your Machine.
  2. Specify the transitions between the states.
  3. Create an Automaton Object from your initial State.

In this case we will be writing an Automaton that accepts the Language that has n 0’s followed by n 1’s and will return the respective n as a result.

Creating the States

To create a state simply instantiate it. Remember to use the generics to specify what your product will be.

let stateOne = State<Int>()
let stateTwo = State<Int>()

If a state is a final state just do:

let stateThree = State<Int>(finite: true)

Transitions

Now we want to let the machine figure out where to go next. For that we define transitions.
We start by calling the when() function in a State with what we expect to be in the Stack.

Now we can add more information to this.
Mainly what characters it should listen for, what stack operation it should do and to what state it should go.

For example:

stateOne.when("Z").goTo(stateThree)

Means that we can make an epsilon transition from state 1 to state 3 if the last item in the stack is Z.

stateOne.when("A").on("0").goTo(stateTwo).pop()

Will create a transition from state 1 to state 2 if the last item in the Stack is A and it reads a "1". After doing so it will pop the last item from the Stack.

Further, Pushie is storing a result for your calculation. Meaning you can give it a function that will transform the current result. It should take a the a String and your result and return the new Result. So for our example we will be storing the number of 0’s

stateOne.when("Z").on("0").push("A").transform() { $1 + 1 }
stateOne.when("A").on("0").push("A").transform() { $1 + 1 }

Lastly we can finish up the states for our example:

stateTwo.when("A").on("1").pop()
stateTwo.when("Z").goTo(stateThree)

So we have just created all the transitions in the following picture:

alt text

Now it’s time to start it:

let automaton = Pushie(start: 0, state: stateOne)
automaton.stack.push("C")

automaton.handle("0011") // Optional(2)
automaton.handle("00011") // nil

Creating Context Free Grammars

Creating automata is pretty tedious. That’s why Pushie allows you to define Context Free grammars just as easily and translate them into automata.
We will now be working with the same example as before.

For that you simply have to define your Variables:

let A = Grammar<Int>()

Now you have to create the productions. In this case we want A to be translated into either an Empty string or a 0 and a 1 with another A in the middle:

A.to("0").and(A).to("1").transform() { $1 + 1 }
A.to("")

And now create a grammar starting from A:

let grammar = Grammar(startVariable: A)

And now just like before you can call the handle function with both the starting value of the accumulator and the input:

grammar.handle(0, input: "0011") // Optional(2)
grammar.handle(2, input: "0011") // Optional(4)
grammar.handle(0, input: "00011") // nil

Best of luck with Pushie!

Built with ♥

Latest podspec

{
    "name": "Pushie",
    "version": "0.0.18",
    "summary": "Pushie is a small framework for Writing Push Down Automata fast and easy",
    "description": "Pushie is a small framework for Writing Push Down Automata fast and easy. It allows you to parse words in the language you specify and even compute a full result from it usin generics.",
    "homepage": "https://github.com/mathiasquintero/Pushie",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Mathias Quintero": "[email protected]"
    },
    "source": {
        "git": "https://github.com/mathiasquintero/Pushie.git",
        "tag": "0.0.18"
    },
    "social_media_url": "https://twitter.com/sifrinoimperial",
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "Pushie/Classes/**/*"
}

Pin It on Pinterest

Share This