repli 0.2.2

Read–Eval–Print Loop Interpreter

🐟 Read–Eval–Print Loop Interpreter (REPLI)

It's a Python package for building command-line terminal applications.

Features:

• Breadcrumbs
• Interface panel
• Pagination

┌──────────────────────────────────────────────────────────────┐
│ [myapp] home                                                 │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│ 1  print hello world                                         │
│ 2  do something                                              │
│ 3  nested page                                               │
│                                                              │
├──────────────────────────────────────────────────────────────┤
│ e  exit application  |  q  quit current page                 │
└──────────────────────────────────────────────────────────────┘
> 

Install

pip install repli

Usage

page_factory = PageFactory()

@page_factory.command(type=NativeFunction, name="1", description="print hello world")
def command_print_hello_world():
    print("hello world")

@page_factory.command(type=Subprocess, name="2", description="do something")
def command_do_something():
    return "echo something else"

nested_page_factory = PageFactory()
page_factory.add_page(page=nested_page_factory.get(name="3", description="nested page"))

page = page_factory.get(name="home", description="home")
interpreter = Interpreter(page=page, name="myapp")
interpreter.loop()

See the example source.

Development

Requirements:

• Poetry

Setup environment:

poetry shell
poetry install

Run example application:

poetry run example

Type check:

poetry run mypy .

Format:

poetry run black ./example ./repli ./tests

Lint:

poetry run flake8

Test:

poetry run pytest

Coverage:

poetry run coverage run -m pytest
poetry run coverage report -m

Export requirements.txt:

poetry export --without-hashes --format=requirements.txt > requirements.txt