Metadata-Version: 2.4
Name: doitlive
Version: 5.2.0
Summary: Because sometimes you need to do it live.
Keywords: doitlive,cli,live,coding,presentations,shell
Author-email: Steven Loria <sloria1@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Environment :: Console
License-File: LICENSE
Requires-Dist: click>=8.0,<9
Requires-Dist: click-completion>=0.3.1
Requires-Dist: click-didyoumean>=0.0.3
Requires-Dist: doitlive[tests] ; extra == "dev"
Requires-Dist: tox ; extra == "dev"
Requires-Dist: pre-commit>=3.6,<5.0 ; extra == "dev"
Requires-Dist: sphinx==8.2.1 ; extra == "docs"
Requires-Dist: sphinx-issues==5.0.1 ; extra == "docs"
Requires-Dist: pytest ; extra == "tests"
Requires-Dist: IPython>=8 ; extra == "tests"
Project-URL: Issues, https://github.com/sloria/doitlive/issues
Project-URL: Source, https://github.com/sloria/doitlive/
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: tests

========
doitlive
========

|homebrew| |build-status| |pypi|


.. |homebrew| image:: https://badgen.net/homebrew/v/doitlive
  :alt: homebrew badge
  :target: https://github.com/Homebrew/homebrew-core/blob/master/Formula/d/doitlive.rb
.. |build-status| image:: https://github.com/sloria/doitlive/actions/workflows/build-release.yml/badge.svg
  :alt: build status
  :target: https://github.com/sloria/doitlive/actions/workflows/build-release.yml
.. |pypi| image:: https://badgen.net/pypi/v/doitlive
  :alt: pypi badge
  :target: https://pypi.org/project/doitlive/

`doitlive` is a tool for live presentations in the terminal. It reads a file of shell commands and replays the commands in a fake terminal session as you type random characters.

.. image:: https://user-images.githubusercontent.com/2379650/31386572-2e2b9d14-ad95-11e7-9be5-fcc5ed09f0e8.gif
    :alt: Demo
    :target: http://doitlive.readthedocs.io


Get it now
----------

macOS with `Homebrew <http://brew.sh/>`_:
*****************************************

.. code-block:: console

    $ brew update
    $ brew install doitlive

With pip:
*********

.. code-block:: console

    $ pip install doitlive

Quickstart
----------

1. Create a file called ``session.sh``. Fill it with bash commands.
2. Run ``doitlive play session.sh``.

.. code-block:: console

    $ doitlive play session.sh


3. Type like a madman.


More at https://doitlive.readthedocs.io
---------------------------------------

Project Links
-------------

- Docs: https://doitlive.readthedocs.io/
- Changelog: https://doitlive.readthedocs.io/en/latest/changelog.html
- PyPI: https://pypi.python.org/pypi/doitlive
- Issues: https://github.com/sloria/doitlive/issues

Kudos
-----

- Idea came from Jordi Gutiérrez Hermoso's `"Revsets" talk <https://www.youtube.com/watch?list=PLLj6w0Thbv02lEXIDVO46kotA_tv_8_us&feature=player_detailpage&v=NSLvERZQSok#t=978>`_  at PyCon 2014.
- Armin Ronacher's `click <http://click.pocoo.org/>`_ library  made this quick to implement.
- Themes inspired by Sorin Ionescu's `prezto <https://github.com/sorin-ionescu/prezto>`_ zsh themes.
- Hat tip to related projects `HackerTyper <http://hackertyper.com/>`_ and `PlayerPiano <http://i.wearpants.org/blog/playerpiano-amaze-your-friends/>`_


License
-------

MIT licensed. See the bundled `LICENSE <https://github.com/sloria/doitlive/blob/master/LICENSE>`_ file for more details.

