clidevkit 0.2.0__tar.gz → 0.2.1__tar.gz

{clidevkit-0.2.0 → clidevkit-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clidevkit
-Version: 0.2.0
+Version: 0.2.1
 Summary: A framework for building production-ready CLI apps and Terminal UIs with minimal code.
 Author-email: Vrushabh Sonawane <shivandmau25@gmail.com>
 License: MIT
@@ -273,6 +273,51 @@ theme = Theme()
 theme.primary("blue")
 theme.success("green")
 ```
+### Banner (`clidev/banner.py`)
+
+Render text as large ASCII-art block letters — great for app splash
+screens, section headers, or command output.
+
+```python
+app.banner("HI").show()
+```
+
+Customize the symbol used to draw the letters:
+
+```python
+app.banner("DEPLOYED", symbol="@").show()
+```
+
+Or use it standalone (outside an `App` instance):
+
+```python
+from clidev.banner import Banner
+
+Banner("HELLO", symbol="*").show()
+```
+
+**Supported characters:** `A-Z` (case-insensitive), `0-9`, and basic
+punctuation (`. , ! ? - :`). Unsupported characters render as blank space
+rather than raising an error.
+
+**Constructor options:**
+
+| Argument | Default | Description |
+|---|---|---|
+| `text` | — | Text to render (auto-uppercased) |
+| `symbol` | `"#"` | Character used to draw filled pixels |
+| `spacing` | `1` | Blank columns between letters |
+| `theme` | `None` | If set (e.g. via `app.banner(...)`), colors the banner using the theme's primary color |
+
+`.render()` returns the raw multi-line string (useful if you want to embed
+it inside a `Card`, log it, or write it to a file) — `.show()` prints it
+directly to the console with theme styling applied.
+
+from clidev import App
+
+app = App("My App")
+app.banner("MY APP").show()
+...
 
 ### Logging (`clidev/logger.py`)
 
@@ -381,62 +426,6 @@ field validation, the shell command wrapper, routing/history, the workflow
 engine, conditional navigation, the event dispatcher, theming, the project
 generator, and full `App` integration — 85 tests in total.
 
----
-
-## Project layout
-
-```text
-clidev/
-├── __init__.py
-├── app.py                 # Main application
-├── router.py               # Navigation
-├── pages.py                # Pages
-├── menus.py                 # Menu engine
-├── forms.py                  # Forms
-├── inputs.py                  # Input widgets
-├── validators.py
-│
-├── state.py                   # Global state
-├── storage.py                  # JSON/SQLite/YAML/TOML storage
-├── workflow.py                  # Workflow engine
-├── events.py                     # Event dispatcher
-├── actions.py                     # Conditional navigation
-│
-├── shell.py                        # Execute commands
-├── tasks.py                          # Background tasks
-├── scheduler.py
-│
-├── progress.py
-├── spinner.py
-├── dashboard.py
-├── table.py
-├── tree.py
-├── cards.py
-├── dialogs.py
-├── notifications.py
-├── statusbar.py
-│
-├── themes.py
-├── colors.py
-├── icons.py
-│
-├── logger.py
-├── config.py
-├── plugins.py
-├── utils.py
-├── exceptions.py
-│
-├── generators/
-│   ├── project.py
-│   ├── menu.py
-│   ├── form.py
-│   └── workflow.py
-│
-├── templates/
-├── builtins/                        # Example plugins (GitPlugin, DatabasePlugin)
-└── cli.py                            # "clidev" terminal command
-```
-
 ## Roadmap
 
 - Additional storage backends: PostgreSQL, MongoDB, Redis

{clidevkit-0.2.0 → clidevkit-0.2.1}/README.md

@@ -243,6 +243,51 @@ theme = Theme()
 theme.primary("blue")
 theme.success("green")
 ```
+### Banner (`clidev/banner.py`)
+
+Render text as large ASCII-art block letters — great for app splash
+screens, section headers, or command output.
+
+```python
+app.banner("HI").show()
+```
+
+Customize the symbol used to draw the letters:
+
+```python
+app.banner("DEPLOYED", symbol="@").show()
+```
+
+Or use it standalone (outside an `App` instance):
+
+```python
+from clidev.banner import Banner
+
+Banner("HELLO", symbol="*").show()
+```
+
+**Supported characters:** `A-Z` (case-insensitive), `0-9`, and basic
+punctuation (`. , ! ? - :`). Unsupported characters render as blank space
+rather than raising an error.
+
+**Constructor options:**
+
+| Argument | Default | Description |
+|---|---|---|
+| `text` | — | Text to render (auto-uppercased) |
+| `symbol` | `"#"` | Character used to draw filled pixels |
+| `spacing` | `1` | Blank columns between letters |
+| `theme` | `None` | If set (e.g. via `app.banner(...)`), colors the banner using the theme's primary color |
+
+`.render()` returns the raw multi-line string (useful if you want to embed
+it inside a `Card`, log it, or write it to a file) — `.show()` prints it
+directly to the console with theme styling applied.
+
+from clidev import App
+
+app = App("My App")
+app.banner("MY APP").show()
+...
 
 ### Logging (`clidev/logger.py`)
 
@@ -351,62 +396,6 @@ field validation, the shell command wrapper, routing/history, the workflow
 engine, conditional navigation, the event dispatcher, theming, the project
 generator, and full `App` integration — 85 tests in total.
 
----
-
-## Project layout
-
-```text
-clidev/
-├── __init__.py
-├── app.py                 # Main application
-├── router.py               # Navigation
-├── pages.py                # Pages
-├── menus.py                 # Menu engine
-├── forms.py                  # Forms
-├── inputs.py                  # Input widgets
-├── validators.py
-│
-├── state.py                   # Global state
-├── storage.py                  # JSON/SQLite/YAML/TOML storage
-├── workflow.py                  # Workflow engine
-├── events.py                     # Event dispatcher
-├── actions.py                     # Conditional navigation
-│
-├── shell.py                        # Execute commands
-├── tasks.py                          # Background tasks
-├── scheduler.py
-│
-├── progress.py
-├── spinner.py
-├── dashboard.py
-├── table.py
-├── tree.py
-├── cards.py
-├── dialogs.py
-├── notifications.py
-├── statusbar.py
-│
-├── themes.py
-├── colors.py
-├── icons.py
-│
-├── logger.py
-├── config.py
-├── plugins.py
-├── utils.py
-├── exceptions.py
-│
-├── generators/
-│   ├── project.py
-│   ├── menu.py
-│   ├── form.py
-│   └── workflow.py
-│
-├── templates/
-├── builtins/                        # Example plugins (GitPlugin, DatabasePlugin)
-└── cli.py                            # "clidev" terminal command
-```
-
 ## Roadmap
 
 - Additional storage backends: PostgreSQL, MongoDB, Redis

{clidevkit-0.2.0 → clidevkit-0.2.1}/clidev/banner.py

@@ -40,6 +40,32 @@ _FONT: dict[str, list[str]] = {
     "X": ["#...#", ".#.#.", "..#..", ".#.#.", "#...#"],
     "Y": ["#...#", ".#.#.", "..#..", "..#..", "..#.."],
     "Z": ["#####", "...#.", "..#..", ".#...", "#####"],
+    "a": [".....", ".####", "#...#", "#...#", ".####"],
+    "b": ["#....", "#....", "####.", "#...#", "####."],
+    "c": [".....", ".####", "#....", "#....", ".####"],
+    "d": ["....#", "....#", ".####", "#...#", ".####"],
+    "e": [".....", ".###.", "#####", "#....", ".####"],
+    "f": ["..##.", ".#...", "###..", ".#...", ".#..."],
+    "g": [".....", ".####", "#...#", ".####", "....#"],
+    "h": ["#....", "#....", "####.", "#...#", "#...#"],
+    "i": ["..#..", ".....", "..#..", "..#..", "..#.."],
+    "j": ["...#.", ".....", "...#.", "...#.", "##..."],
+    "k": ["#....", "#..#.", "###..", "#..#.", "#...#"],
+    "l": ["##...", ".#...", ".#...", ".#...", "###.."],
+    "m": [".....", "##.#.", "#.#.#", "#.#.#", "#...#"],
+    "n": [".....", "####.", "#...#", "#...#", "#...#"],
+    "o": [".....", ".###.", "#...#", "#...#", ".###."],
+    "p": [".....", "####.", "#...#", "####.", "#...."],
+    "q": [".....", ".####", "#...#", ".####", "....#"],
+    "r": [".....", "#.##.", "##...", "#....", "#...."],
+    "s": [".....", ".####", "##...", "...##", "####."],
+    "t": [".#...", "###..", ".#...", ".#...", "..##."],
+    "u": [".....", "#...#", "#...#", "#...#", ".####"],
+    "v": [".....", "#...#", "#...#", ".#.#.", "..#.."],
+    "w": [".....", "#...#", "#.#.#", "#.#.#", ".#.#."],
+    "x": [".....", "#...#", ".#.#.", ".#.#.", "#...#"],
+    "y": [".....", "#...#", ".####", "....#", "####."],
+    "z": [".....", "#####", "..##.", ".##..", "#####"],
     "0": [".###.", "#...#", "#...#", "#...#", ".###."],
     "1": ["..#..", ".##..", "..#..", "..#..", ".###."],
     "2": [".###.", "#...#", "..##.", ".#...", "#####"],

{clidevkit-0.2.0 → clidevkit-0.2.1}/clidevkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clidevkit
-Version: 0.2.0
+Version: 0.2.1
 Summary: A framework for building production-ready CLI apps and Terminal UIs with minimal code.
 Author-email: Vrushabh Sonawane <shivandmau25@gmail.com>
 License: MIT
@@ -273,6 +273,51 @@ theme = Theme()
 theme.primary("blue")
 theme.success("green")
 ```
+### Banner (`clidev/banner.py`)
+
+Render text as large ASCII-art block letters — great for app splash
+screens, section headers, or command output.
+
+```python
+app.banner("HI").show()
+```
+
+Customize the symbol used to draw the letters:
+
+```python
+app.banner("DEPLOYED", symbol="@").show()
+```
+
+Or use it standalone (outside an `App` instance):
+
+```python
+from clidev.banner import Banner
+
+Banner("HELLO", symbol="*").show()
+```
+
+**Supported characters:** `A-Z` (case-insensitive), `0-9`, and basic
+punctuation (`. , ! ? - :`). Unsupported characters render as blank space
+rather than raising an error.
+
+**Constructor options:**
+
+| Argument | Default | Description |
+|---|---|---|
+| `text` | — | Text to render (auto-uppercased) |
+| `symbol` | `"#"` | Character used to draw filled pixels |
+| `spacing` | `1` | Blank columns between letters |
+| `theme` | `None` | If set (e.g. via `app.banner(...)`), colors the banner using the theme's primary color |
+
+`.render()` returns the raw multi-line string (useful if you want to embed
+it inside a `Card`, log it, or write it to a file) — `.show()` prints it
+directly to the console with theme styling applied.
+
+from clidev import App
+
+app = App("My App")
+app.banner("MY APP").show()
+...
 
 ### Logging (`clidev/logger.py`)
 
@@ -381,62 +426,6 @@ field validation, the shell command wrapper, routing/history, the workflow
 engine, conditional navigation, the event dispatcher, theming, the project
 generator, and full `App` integration — 85 tests in total.
 
----
-
-## Project layout
-
-```text
-clidev/
-├── __init__.py
-├── app.py                 # Main application
-├── router.py               # Navigation
-├── pages.py                # Pages
-├── menus.py                 # Menu engine
-├── forms.py                  # Forms
-├── inputs.py                  # Input widgets
-├── validators.py
-│
-├── state.py                   # Global state
-├── storage.py                  # JSON/SQLite/YAML/TOML storage
-├── workflow.py                  # Workflow engine
-├── events.py                     # Event dispatcher
-├── actions.py                     # Conditional navigation
-│
-├── shell.py                        # Execute commands
-├── tasks.py                          # Background tasks
-├── scheduler.py
-│
-├── progress.py
-├── spinner.py
-├── dashboard.py
-├── table.py
-├── tree.py
-├── cards.py
-├── dialogs.py
-├── notifications.py
-├── statusbar.py
-│
-├── themes.py
-├── colors.py
-├── icons.py
-│
-├── logger.py
-├── config.py
-├── plugins.py
-├── utils.py
-├── exceptions.py
-│
-├── generators/
-│   ├── project.py
-│   ├── menu.py
-│   ├── form.py
-│   └── workflow.py
-│
-├── templates/
-├── builtins/                        # Example plugins (GitPlugin, DatabasePlugin)
-└── cli.py                            # "clidev" terminal command
-```
-
 ## Roadmap
 
 - Additional storage backends: PostgreSQL, MongoDB, Redis

{clidevkit-0.2.0 → clidevkit-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clidevkit"
-version = "0.2.0"
+version = "0.2.1"
 description = "A framework for building production-ready CLI apps and Terminal UIs with minimal code."
 readme = "README.md"
 requires-python = ">=3.10"