aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJakob Stendahl <jakob.stendahl@outlook.com>2019-08-15 15:07:24 +0200
committerJakob Stendahl <jakob.stendahl@outlook.com>2019-08-15 15:07:24 +0200
commit4a6e117c9425b4b7ec0875b654c20ea92d3d7ce0 (patch)
tree078f52f42b70649c73e4d8b1a9ed2a54708be103 /README.md
downloadTermIO-python-package-4a6e117c9425b4b7ec0875b654c20ea92d3d7ce0.tar.gz
TermIO-python-package-4a6e117c9425b4b7ec0875b654c20ea92d3d7ce0.zip
:sparkles: Initial commit
Diffstat (limited to 'README.md')
-rw-r--r--README.md85
1 files changed, 85 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bd3f051
--- /dev/null
+++ b/README.md
@@ -0,0 +1,85 @@
+# TermIO
+Simple library that makes it easier to manipulate the terminal using escape
+sequences.
+
+It does not work in all terminal and terminal-emulators. But i have generally
+had good with bash.
+
+```
+import TermIO
+```
+
+## var `TermIO.rows`
+Rows in the terminal. Not updating as of now...
+
+## var `TermIO.columns`
+Number of columns in the terminal. Not updating either...
+
+## func `TermIO.Cursor.SetPos(col, row, flush=True)`
+Set cursor to a spesific column and row in the terminal.
+```
+col : The column number to put the cursor.
+row : The row number to put the cursor.
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Cursor.Left(n, flush=True)`
+Move the cursor `n` characters to the left.
+```
+n : number
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Cursor.Right(n, flush=True)`
+Move the cursor `n` characters to the right.
+```
+n : number
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Cursor.Up(n, flush=True)`
+Move the cursor `n` characters up.
+```
+n : number
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Cursor.Down(n, flush=True)`
+Move the cursor `n` characters to the down.
+```
+n : number
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Screen.Clear(flush=True)`
+Clear the screen.
+```
+flush : Wether or not to flush the codes printed (Default is true).
+```
+
+## func `TermIO.Screen.Flush()`
+Flushes printed content to screen.
+
+## func `TermIO.Screen.Decorate(fg=None, bg=None, dec=None, flush=True)`
+Clear the screen
+```
+fg : Number between 0 and 255. No logical color math... [None]
+bg : Number between 0 and 255. No logical color math... [None]
+dec : Either a string or a list of strings. [None]
+ The three possible decorations is
+ reversed, underline, bold
+ eg:
+ TermIO.Screen.Decorate(dec="reversed")
+ or
+ TermIO.Screen.Decorate(dec=["bold", "reversed"])
+flush : Wether or not to flush the codes printed. [True]
+```
+
+If you want to print `ESC[0M`, to remove all decorations. Just call this function with `fg=bg=dec=None`.
+
+## func `TermIO.Screen.Write(outStr, flush=True)`
+Writes a string to stdout.
+```
+outStr : string to be printed
+flush : Wether or not to flush the codes printed (Default is true).
+```