Skip to main content

Run command as REPL-environment

Project description

https://travis-ci.com/imomaliev/ptrepl.svg?branch=master https://badge.fury.io/py/ptrepl.svg

About

Make REPL out of any bash command

  • has bash completion

  • has vi mode

  • has PS1 parsing(experimental)

  • stores history in $XDG_DATA_HOME/ptrepl/history

  • bash like history expansion

  • list history

  • command mode

  • aliases

Installation

Requires python>=3.6, click, prompt_toolkit>=2.0.7, pygments

pip install ptrepl

Usage

Basic Usage

$ ptrepl --help
Usage: ptrepl [OPTIONS] COMMAND

Options:
--prompt TEXT  Override prompt
--help         Show this message and exit.
$ ptrepl git
$ git >
# to call "git status"
$ git > status
# if you need execute some other bash command see system mode below

Custom prompt command

$ ptrepl git --prompt g
$ g >

Multiword command

$ ptrepl "echo prefix"
$ echo prefix > 1
echo prefix 1

Config

Place settings file in :bash:$XDG_CONFIG_HOME/ptrepl/config.json

{
    "settings": {
        "PARSE_PS1": true,
        "EDITING_MODE": "vi",
        "READLINE_COMPLETION": true,
        "LOCAL_SHADA": true
    },
    "alias": {
        "git st": "git status"
    }
}

Available settings

  • EXIT_COMMAND - change exit command

  • EDITING_MODE - choose mode vi/emacs

  • SHOW_MODE_IN_PROMPT - show editing mode string in prompt

  • EMACS_MODE_STRING - set emacs mode prompt string

  • VI_INS_MODE_STRING - set vi insert mode prompt string

  • VI_CMD_MODE_STRING - set vi command mode prompt string

  • READLINE_COMPLETION: use readline like completion instead of dropdown one

  • PARSE_PS1 {experimental} - will try to adgust ptrepl’s prompt according to your PS1 setting

  • LOCAL_SHADA - store shada(history) in LOCAL_SHADA_PATH

  • LOCAL_SHADA_PATH - path to local shada

Default settings

{
    "EXIT_COMMAND": "exit",
    "EDITING_MODE": "emacs",
    "SHOW_MODE_IN_PROMPT": false,
    "EMACS_MODE_STRING": "@",
    "VI_INS_MODE_STRING": "(ins)",
    "VI_CMD_MODE_STRING": "(cmd)",
    "READLINE_COMPLETION": false,
    "PARSE_PS1": false,
    "LOCAL_SHADA": false,
    "LOCAL_SHADA_PATH": "$DIRENV_DIR/ptrepl/",
}

Features

Parsing PS1(requires PARSE_PS1 set to true)

Here is how my bash prompt(PS1) looks like by default

{ptrepl} ~/Development/Python/ptrepl [master] |19:18:36 07-Feb-18|
+  ptrepl git
{ptrepl} ~/Development/Python/ptrepl [master] |19:20:15 07-Feb-18|
+ git 

Completion

$ ptrepl git
$ git > sta (press TAB)
# result
$ git > sta
        status
        stage
        stash

Readline like completion(requires READLINE_COMPLETION set to true)

$ ptrepl git
$ git > sta (press TAB)
# result
$ git > sta
stage  stash  status

System mode

$ ptrepl git
$ git > (press Escape + !)
# result
# you could enter your shell commands here
Shell command: ls

Command mode

$ ptrepl git
$ git > (press Escape + :)
# result
# you could enter your command mode commands here
# to list history
Command mode: history

Bash like history expansion

$ ptrepl git
$ git > status
# repeat last command
$ git > !!
# repeat 10th command
$ git > !10
# repeat 10th command from bottom of history stack
$ git > !-10

Bash like aliases

$ ptrepl git
$ git > (press Escape + :)
# you could enter your command mode commands here
# to list alias
Command mode: alias
alias "git st"="git status"
$ git > st

Similar projects

Written in Ruby

https://github.com/defunkt/repl

Written in Bash

https://github.com/joh6nn/shrepl

https://github.com/mchav/with

Written in Python

https://github.com/mbr/repl

https://github.com/renanivo/with

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ptrepl-0.9.1.tar.gz (19.8 kB view hashes)

Uploaded Source

Built Distribution

ptrepl-0.9.1-py3-none-any.whl (22.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page