add source code.

Author: externref

.gitignore

@@ -0,0 +1,5 @@
+*cache*
+dist/
+*sqlite
+*db
+*egg-info

README.md

@@ -1,2 +1,34 @@
-# aoi
-SQLITE3 cli based on python sqlite3 module.
+# 🍥 aoi
+A simple python based sqlite3 CLI.
+
+---
+
+## Usage 
+```sh
+$python -m aoi [-c "path to connect"]
+```
+using the -c/--connect option will connect the application to the provided db file path.
+
+If no option is provided, `:memory:` ( in memory database ) will be used.
+
+## Additional Features
+
+Apart from normal sqlite quries you can run the following commands within the CLI:
+
+`:h/:help`: Get help for commands.
+
+`:q/:quit`: Exit the CLI.
+
+`:r/:recent [amount=5]`: Show last [amount=5] queries.
+
+---
+## Requirements
+* Python (3.8 or later)
+
+Installing aoi in your environment using pip, poetry or any favourable package manager
+```sh
+# pip
+$python -m pip install git+https://github.com/sarthhh/aoi.git
+# poetry
+$poetry add git+https://github.com/sarthhh/aoi.git
+```

aoi/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.5"

aoi/__main__.py

@@ -0,0 +1,3 @@
+from aoi.base import main
+
+main()

aoi/_misc.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import typing
+
+import colorama
+
+if typing.TYPE_CHECKING:
+    from aoi.base import Session
+
+
+UNDEFINED = object()
+EMOJI = "\U0001f365"
+
+cmds: dict[str, str] = {
+    ":q | :quit": "Stops the cli session.",
+    ":h | :help": "Shows this help message.",
+    ":r | :recent": "List recently used commands.",
+}
+
+
+def error_print(msg: str) -> None:
+    print(colorama.Fore.LIGHTMAGENTA_EX, msg, colorama.Style.RESET_ALL, sep="")
+
+
+def process_commands(data: str, session: Session) -> typing.Any:
+    if data in (":q", ":quit"):
+        session.stop()
+    elif data in (":h", ":help"):
+        [
+            print(
+                colorama.Style.BRIGHT,
+                colorama.Fore.GREEN,
+                f"[{cmd}]",
+                colorama.Style.RESET_ALL,
+                ": ",
+                colorama.Fore.CYAN,
+                info,
+                colorama.Style.RESET_ALL,
+                sep="",
+                end="\n",
+            )
+            for cmd, info in cmds.items()
+        ]
+    elif data.startswith(":recent"):
+        if data[7:] and data[7:].strip().isnumeric():
+            print("\n".join(session.recent_queries[-int(data[7:]) :]))
+        else:
+            print("\n".join(session.recent_queries[-5:]))
+
+    elif data.startswith(":r"):
+        if data[3:] and data[3:].strip().isnumeric():
+            print("\n".join(session.recent_queries[-int(data[3:]) :]))
+        else:
+            print("\n".join(session.recent_queries[-5:]))
+
+    else:
+        error_print(f"No command named {data} found, use :h to get a list of all commands")

aoi/base.py

@@ -0,0 +1,100 @@
+import argparse
+import sys
+
+import colorama
+
+from aoi._misc import process_commands
+from aoi.sqlite import connect, run_sql
+
+parser = argparse.ArgumentParser("aoi", usage="aoi *[options]", description="SQLITE3 in CLI.", add_help=True)
+
+parser.add_argument("-c", "--connect", help="The sqlite file to connect.")
+parser.add_argument("-v", "--version", help="Check version of the application.", action="store_true")
+
+
+class Args(argparse.Namespace):
+    connect: str | None
+    version: str | None
+
+
+class Session:
+    recent_queries: list[str] = []
+    running: bool
+
+    def __init__(self, file: str) -> None:
+        self.file = file
+
+        connect(file)
+
+    def start(self) -> None:
+        self.running = True
+        print(
+            colorama.Fore.BLUE,
+            colorama.Style.BRIGHT,
+            "Welcome to ",
+            colorama.Fore.CYAN,
+            "\U0001f365 aoi",
+            colorama.Fore.BLUE,
+            "!",
+            colorama.Style.RESET_ALL,
+            f" [connected to: \033[1;33m{self.file}\033[0m]",
+            sep="",
+            end="\n",
+        )
+        print(
+            colorama.Fore.LIGHTBLUE_EX,
+            "type :h for list of inbuilt commands.",
+            colorama.Style.RESET_ALL,
+            sep="",
+        )
+
+        while self.running is True:
+            data = input("> ")
+            if data.startswith(":"):
+                process_commands(data, self)
+                continue
+            while not data.strip().endswith(";"):
+                data += f" {input('- ')}"
+
+            run_sql(data, self)
+        raise KeyboardInterrupt
+
+    def stop(self) -> None:
+        self.running = False
+
+
+def main() -> None:
+    args: Args = parser.parse_args()
+    file = args.connect or ":memory:"
+    if args.version and args.connect is None:
+        print(
+            colorama.Fore.BLUE,
+            colorama.Style.BRIGHT,
+            "aoi\U0001f365  version: ",
+            colorama.Fore.GREEN,
+            colorama.Style.NORMAL,
+            "0.1.0\n",
+            colorama.Fore.BLUE,
+            colorama.Style.BRIGHT,
+            "Python version: ",
+            colorama.Style.NORMAL,
+            colorama.Fore.GREEN,
+            sys.version,
+            colorama.Style.RESET_ALL,
+            sep="",
+        )
+        return
+    try:
+        (session := Session(file)).start()
+    except KeyboardInterrupt:
+        print(
+            "\n" if session.running else "",
+            colorama.Fore.BLUE,
+            colorama.Style.BRIGHT,
+            "Thank you for using ",
+            colorama.Fore.CYAN,
+            "\U0001f365 aoi",
+            colorama.Fore.BLUE,
+            "!",
+            sep="",
+        )

aoi/sqlite.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+import sqlite3
+import typing
+
+import colorama
+
+from aoi._misc import UNDEFINED, error_print
+
+if typing.TYPE_CHECKING:
+    from aoi.base import Session
+
+
+connection: sqlite3.Connection = UNDEFINED
+
+
+def connect(path: str) -> None:
+    global connection
+    try:
+        connection = sqlite3.connect(path)
+    except sqlite3.OperationalError:
+        print(error_print(f"[Operational Error:] Unable to connect to the path: {path}"))
+        raise KeyboardInterrupt
+
+
+def _success() -> None:
+    print(colorama.Style.BRIGHT, colorama.Fore.GREEN, "Executed successfully.", colorama.Style.RESET_ALL, sep="")
+
+
+def run_sql(query: str, session: Session) -> typing.Any:
+    session.recent_queries.append(query)
+    try:
+        cursor = connection.execute(query)
+        print(data) if (data := cursor.fetchall()) else _success()
+    except sqlite3.OperationalError as e:
+        error_print(f"[Operationl Error:] {e.args[0]}")