Metadata-Version: 2.1
Name: simpleline
Version: 1.8.3
Summary: Python text UI framework
Home-page: https://github.com/rhinstaller/python-simpleline
Author: Jiri Konecny
Author-email: jkonecny@redhat.com
Keywords: ui text library glib
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: User Interfaces
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.4
Description-Content-Type: text/markdown
License-File: LICENSE.md

[![Copr build status](https://copr.fedorainfracloud.org/coprs/g/rhinstaller/Anaconda/package/python-simpleline/status_image/last_build.png)](https://copr.fedorainfracloud.org/coprs/g/rhinstaller/Anaconda/package/python-simpleline/)
[![Translation status](https://translate.fedoraproject.org/widgets/python-simpleline/-/master/svg-badge.svg)](https://translate.fedoraproject.org/engage/python-simpleline/?utm_source=widget)

Python Simpleline
=================

This is a text UI framework originally which was a part of the
[Anaconda](https://github.com/rhinstaller/anaconda) installer project.

This UI is simple and easy to use. It is designed to be used with line-based
machines and tools (e.g. serial console) so that every new line is appended
to the bottom of the screen. Printed lines are never rewritten!

How to
======

[Link](https://python-simpleline.readthedocs.io) to the documentation.

Another way to learn how to use this library is to view the
[examples directory](https://github.com/rhinstaller/python-simpleline/tree/master/examples).
Examples can be run without installing Simpleline to the system. You can test
them by running the script `run_example.sh`.

1. `cd examples`
2. `./run_example.sh example_folder_name`

For example:
`./run_example.sh basic`

Dependencies
============

This is a Python3-only project. This code should not be difficult to migrate to
Python2. However, there is no need from the community, so it is only compatible
with Python3 at the moment.
No special libraries are required to use this library. If you want to use glib
event loop instead of the original one you need to install glib and Python3
gobject introspection.

If you want to run tests (`make ci`), you need to install
[Pocketlint](https://github.com/rhinstaller/pocketlint) and glib with gobject
introspection for Python3.

Note
====

Thanks to Martin Sivák for the original Anaconda project. It was really nice
starting place for the new Simpleline's form.
