Metadata-Version: 2.1
Name: Simple_Process_REPL
Version: 2.0.4
Summary: An extensible application framework with REPL for creating processes with side effects.
Home-page: https://github.com/EricGebhart/Simple_Process_REPL
Author: Eric Gebhart
Author-email: e.a.gebhart@gmail.com
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown

# Simple Process REPL

A YAML datastore, a config file, a namespace manager, and an interpreter walk 
into a bar...

This has been changing a lot, the wiki is a bit chaotic.
Important concepts are: 
 * datastore/appstate in the _as_ namepace
 * The _With_ stack.
 * The _results_ stack.

 Short-cuts: 
  * [Read the Wiki](https://github.com/EricGebhart/Simple_Process_REPL/wiki)
  * Read all the help for all the namespaces.
  
## Installation

    pip install Simple_Process_REPL
    
You will also need to install dialog and zbar for the qrcode and barcode library.
If you desire particle.io functionalities you will also need to install the
particle.io cli.

on Arch Linux

    sudo pacman -S dialog

or on Apple

    brew install dialog

For Zbar follow the instructions [here.](https://pypi.org/project/pyzbar/)

For particle.io functionalities follow the instructions 
[here.](https://docs.particle.io/tutorials/developer-tools/cli/#installing)

## Start the REPL

To start the REPL;

    SPR -r

    
### What is it?

Many things.

In a way, SPR feels like python did in 1995. It was the glue that was
easy to use to put things together with. 

SPR is a fun to use tool to create applications which do processes.
It's simple enough to be transparent and easy, and smart
enough to be a pleasure. Anything serious and there is always python
right there.

SPR can be used to interactively create and run 
a process as if it is an application. Possibly with nothing but a configuration
file.

SPR is actually a very simple interpreter with an interactive REPL. 

The code is data, and the data is code.
Function parameters are automatically bound if they are needed and can be found.

SPR code is really simple. SPR only knows YAML, words, strings and numbers.
If you give it a list, it will try to look up what you gave it and 
execute it.  So you can make lists and give them names, and make lists of lists,
all of which turns into a process which will try to do it's thing, and if any
step fails, the whole process fails. All with nice error handling, logging,
dialogs, configuration, integrated help, self introspection, a REPL, along 
with various methods of execution.


## To sum up.

This is a really simple interpreter, 
think of it as a simple glue layer on top of python.

It's got some really handy extensions for making processes, and extensions
are easy to make from a bit of spr or python code. It will even create an
extension project template for you. That's one of it's many commands.

All with nice configuration and yaml datastore management, logging,
and error handling. It runs like an application once it has a process,
and it can repeat it interactively, reporting failures.
And it has a REPL. So you can play with it interactively, building things.

There's a big yaml datastore Tree and
whatever python functions you might want to use in your
SPR functions. 

Failures are expected. The REPL makes it easy.

## The parts.
  * The Interpreter/Repl
  * Namespaces
  * appstate/ _as_ ie. the datastore.
  * a with stack
  * Automatic parameter binding.
  * results stacks.
  * yaml datastore data structure, configuration, state, etc...
  * SPR/Python extensions that are built in.
  * Any python module you care to import.







