Run command as REPL-environment (useful for git!).
Project description
repl
====
.. image:: repl-demo.gif
Runs a command in a `REPL <https://en.wikipedia.org/wiki/Read-eval-
print_loop>`_. It comes in very handy when dealing with applications that do
not ship with a REPL, but could benefit greatly from one (such as git_).
Tab completion is available and completes filenames.
Real productivity
-----------------
Set an alias in your shell's start-up file:
alias rg="repl git"
Instead of typing ``git ...``, type ``rg`` once. You'll never go back.
Installation
------------
Requires nothing but Python installed. No extra dependencies, just stdlib. Drop
this right into your ``$PATH``, ``chmod +x`` and you are good to go.
.. _git: https://git-scm.com
Detailed usage
--------------
Running ``repl COMMAND ARG1 ARG2...`` will start the loop. Any line entered
will now be appended to ``COMMAND ARG1 ARG2...`` and executed. The result is
displayed and ``repl`` will wait for the next line to be entered.
Try ``repl --help`` for a list of options.
Exiting
~~~~~~~
To quit the REPL, send an ``EOF`` symbol (usually done with ``Ctrl-d`` on *nix
systems, ``Ctrl-z`` on Windows).
Command substitution
~~~~~~~~~~~~~~~~~~~~
If you run into a command that needs arguments passed somewhere in between
other arguments by passing ``{}`` as the argument. It will be replaced with
``…`` in the prompt.
.. code-block:: sh
$ repl echo Hello, {} - Nice to meet you!
echo Hello, … - Nice to meet you!>> Alice
Hello, Alice - Nice to meet you!
echo Hello, … - Nice to meet you!>> Bob
Hello, Bob - Nice to meet you!
echo Hello, … - Nice to meet you!>>
Credits
-------
Idea stolen from https://github.com/defunkt/repl, which unfortunately is
unmaintained. Originally rewritten because I had issues with stdin/stdout; now
it boasts a few extra features (and does not require ruby)
====
.. image:: repl-demo.gif
Runs a command in a `REPL <https://en.wikipedia.org/wiki/Read-eval-
print_loop>`_. It comes in very handy when dealing with applications that do
not ship with a REPL, but could benefit greatly from one (such as git_).
Tab completion is available and completes filenames.
Real productivity
-----------------
Set an alias in your shell's start-up file:
alias rg="repl git"
Instead of typing ``git ...``, type ``rg`` once. You'll never go back.
Installation
------------
Requires nothing but Python installed. No extra dependencies, just stdlib. Drop
this right into your ``$PATH``, ``chmod +x`` and you are good to go.
.. _git: https://git-scm.com
Detailed usage
--------------
Running ``repl COMMAND ARG1 ARG2...`` will start the loop. Any line entered
will now be appended to ``COMMAND ARG1 ARG2...`` and executed. The result is
displayed and ``repl`` will wait for the next line to be entered.
Try ``repl --help`` for a list of options.
Exiting
~~~~~~~
To quit the REPL, send an ``EOF`` symbol (usually done with ``Ctrl-d`` on *nix
systems, ``Ctrl-z`` on Windows).
Command substitution
~~~~~~~~~~~~~~~~~~~~
If you run into a command that needs arguments passed somewhere in between
other arguments by passing ``{}`` as the argument. It will be replaced with
``…`` in the prompt.
.. code-block:: sh
$ repl echo Hello, {} - Nice to meet you!
echo Hello, … - Nice to meet you!>> Alice
Hello, Alice - Nice to meet you!
echo Hello, … - Nice to meet you!>> Bob
Hello, Bob - Nice to meet you!
echo Hello, … - Nice to meet you!>>
Credits
-------
Idea stolen from https://github.com/defunkt/repl, which unfortunately is
unmaintained. Originally rewritten because I had issues with stdin/stdout; now
it boasts a few extra features (and does not require ruby)
