fluxdeck 0.2.0__tar.gz

fluxdeck-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gideon Wamalwa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fluxdeck-0.2.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: fluxdeck
+Version: 0.2.0
+Summary: Dynamic terminal state renderer using Rich
+Author-email: Gideon Wamalwa <bond8865@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Dynamic: license-file
+
+# FluxDeck
+
+FluxDeck is a lightweight Python utility for dynamically managing and rendering structured console output without clutter. It acts as a simple in-terminal state dashboard that continuously updates displayed information in real time.
+
+It is built using Python threading and Rich’s live rendering system.
+
+---
+
+## Features
+
+- Dynamic category-based message tracking
+- Live console updates without manual clearing
+- Muting and unmuting of output categories
+- Threaded rendering loop for continuous display updates
+- Lightweight design with minimal dependencies
+
+---
+
+
+### Requirements
+- Python 3.8+
+- rich
+
+Install dependency:
+
+
+
+## Example Usage
+
+This example demonstrates how FluxDeck updates and controls dynamic console output.
+
+```python id="r2"
+from fluxdeck import FluxDeck
+import time
+
+flux = FluxDeck()
+
+# Initial system state
+flux.flux("status", "Initializing system")
+flux.flux("network", "Connected")
+
+time.sleep(2)
+
+# Update state dynamically
+flux.flux("status", "Running")
+flux.mute("network")
+
+time.sleep(2)
+
+# Restore and update a muted category
+flux.unmute("network")
+flux.flux("network", "Restored connection")

fluxdeck-0.2.0/README.md

@@ -0,0 +1,52 @@
+# FluxDeck
+
+FluxDeck is a lightweight Python utility for dynamically managing and rendering structured console output without clutter. It acts as a simple in-terminal state dashboard that continuously updates displayed information in real time.
+
+It is built using Python threading and Rich’s live rendering system.
+
+---
+
+## Features
+
+- Dynamic category-based message tracking
+- Live console updates without manual clearing
+- Muting and unmuting of output categories
+- Threaded rendering loop for continuous display updates
+- Lightweight design with minimal dependencies
+
+---
+
+
+### Requirements
+- Python 3.8+
+- rich
+
+Install dependency:
+
+
+
+## Example Usage
+
+This example demonstrates how FluxDeck updates and controls dynamic console output.
+
+```python id="r2"
+from fluxdeck import FluxDeck
+import time
+
+flux = FluxDeck()
+
+# Initial system state
+flux.flux("status", "Initializing system")
+flux.flux("network", "Connected")
+
+time.sleep(2)
+
+# Update state dynamically
+flux.flux("status", "Running")
+flux.mute("network")
+
+time.sleep(2)
+
+# Restore and update a muted category
+flux.unmute("network")
+flux.flux("network", "Restored connection")

fluxdeck-0.2.0/fluxdeck/core.py

@@ -0,0 +1,73 @@
+
+__version__ = "0.2.0"
+
+from rich.console import Console
+from rich.live import Live
+import asyncio
+import time
+import threading
+
+class FluxDeck():
+  """Dynamically print values to avoid clutter of console"""
+  def __init__(self):
+    self.status_messages = {}
+    self.muted_categories = []
+    self.console = Console()
+    self.display = None
+    self.lock = threading.Lock()
+    flux_thread=threading.Thread(target=self.flux_core)
+    flux_thread.start()
+
+    
+  def flux(self, category, info):
+    """Update the content being displayed"""
+    with self.lock:
+      self.status_messages[category] = info
+      self.format_output()
+    
+  def format_output(self):
+    """Format the content to be displayed"""
+    lines=[]
+    for key,val in self.status_messages.items():
+      if key in self.muted_categories:
+        continue
+      lines.append(f"======={key}=========\n\t\t{val}\n")
+        
+      self.display = "\n".join(lines)
+    
+  def mute(self, category):
+    """Category added here will not appear in displayed data"""
+    with self.lock:
+      self.muted_categories.append(category)
+      self.format_output()
+  
+  def unmute(self, category):
+    """Remove category from muted list"""
+    with self.lock:
+      if category not in self.muted_categories:
+        self.status_messages["error"] = f"'{category}' not in muted categories"
+        self.format_output()
+      else: 
+        self.muted_categories.remove(category)
+        self.format_output()
+    
+  def flux_core(self):
+    """update console"""
+    with Live(console=self.console,refresh_per_second= 4) as live:
+        while True:
+          with self.lock:
+            display = self.display
+            live.update(display)
+          
+        
+        
+        
+if __name__ == "__main__":
+  flux = FluxDeck()
+  flux.flux("connect","success")
+  flux.flux("authorize","failed")
+  flux.unmute("heyoo")
+  
+  
+  
+  

fluxdeck-0.2.0/fluxdeck.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: fluxdeck
+Version: 0.2.0
+Summary: Dynamic terminal state renderer using Rich
+Author-email: Gideon Wamalwa <bond8865@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Dynamic: license-file
+
+# FluxDeck
+
+FluxDeck is a lightweight Python utility for dynamically managing and rendering structured console output without clutter. It acts as a simple in-terminal state dashboard that continuously updates displayed information in real time.
+
+It is built using Python threading and Rich’s live rendering system.
+
+---
+
+## Features
+
+- Dynamic category-based message tracking
+- Live console updates without manual clearing
+- Muting and unmuting of output categories
+- Threaded rendering loop for continuous display updates
+- Lightweight design with minimal dependencies
+
+---
+
+
+### Requirements
+- Python 3.8+
+- rich
+
+Install dependency:
+
+
+
+## Example Usage
+
+This example demonstrates how FluxDeck updates and controls dynamic console output.
+
+```python id="r2"
+from fluxdeck import FluxDeck
+import time
+
+flux = FluxDeck()
+
+# Initial system state
+flux.flux("status", "Initializing system")
+flux.flux("network", "Connected")
+
+time.sleep(2)
+
+# Update state dynamically
+flux.flux("status", "Running")
+flux.mute("network")
+
+time.sleep(2)
+
+# Restore and update a muted category
+flux.unmute("network")
+flux.flux("network", "Restored connection")

fluxdeck-0.2.0/fluxdeck.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+fluxdeck/__init__.py
+fluxdeck/core.py
+fluxdeck.egg-info/PKG-INFO
+fluxdeck.egg-info/SOURCES.txt
+fluxdeck.egg-info/dependency_links.txt
+fluxdeck.egg-info/requires.txt
+fluxdeck.egg-info/top_level.txt

fluxdeck-0.2.0/fluxdeck.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fluxdeck-0.2.0/fluxdeck.egg-info/requires.txt

@@ -0,0 +1 @@
+rich

fluxdeck-0.2.0/fluxdeck.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+fluxdeck

fluxdeck-0.2.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fluxdeck"
+version = "0.2.0"
+description = "Dynamic terminal state renderer using Rich"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "rich"
+]
+
+authors = [
+    { name = "Gideon Wamalwa" ,email="bond8865@gmail.com"}
+]
+
+license = { text = "MIT" }
+
+[tool.setuptools.packages.find]
+where = ["."]

fluxdeck-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+