Metadata-Version: 2.4
Name: devspace
Version: 0.1.0
Summary: A clean workflow and context orchestrator for minimalist Linux setups.
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# devspace

Core Features to Build1. Context Orchestration (devspace load <project>)When you fire up a project workspace, the Python script reads a .devspace.toml file from your project root and uses wmctrl to:Spin up a designated number of terminal windows arranged exactly how you like them.Automatically activate your project’s specific Python venv in those terminals.Open your project's local documentation or API references in a lightweight X11 browser (like surf or luakit).Launch your background mock databases or docker containers.2. The Persistent "Status Ribbon" (The GUI Element)Instead of a huge dashboard, it generates a tiny, elegant, borderless X11 window using tkinter that docks right into your Fluxbox setup (acting like a secondary panel). It display blocks like:Active Project Context: How long you've been working on the current session.Local Micro-Status: Are your local development ports (e.g., localhost:8000) alive or throwing 500 errors?Scratchpad Dropdown: A clean, markdown-supported text box that drops down via a global hotkey to jot down notes without opening a heavy text editor.3. Ephemeral Quick-RunnerA search-bar style pop-up launcher (similar to Rofi, but built tailored to developers) that indexes only your project-specific actions. Pressing Ctrl + Space brings up a fast, modern input field where you can type project shortcuts (e.g., run tests, deploy staging, tail logs) defined entirely in your Python package config.How to Structure and Build ItSince you are running inside a venv on a minimal Debian installation, keep the library dependencies incredibly lean to preserve that lightning-fast Fluxbox feel.Recommended PyPI Stack:pyyaml or standard tomli (built-in for Python 3.11+ on Debian 12) — For reading configurations. [1] (/goto?url=CAESZgHrOzAVc1CuWOZEerWcsyLbIQ4xAc5OzLZy-x_xhIdkLz9lH-_iKIXDaiOu2dgKvFA_E4ieHUojoxzuFneBUUqoE6oz5a6EPSUOCjO1tHVovktc5q9Q40FFbkfB3ahORHpuT8VZrQ)Textual — If you decide to go the terminal UI route; it looks gorgeous, behaves like a modern GUI, but runs completely inside your terminal emulator.customtkinter — If you choose a GUI route; it upgrades standard Tkinter with gorgeous dark/light mode widgets without requiring heavy Qt or GTK packages.python-xlib or sh — For executing shell bindings safely to arrange window states.Example pyproject.toml layout:toml[build-system]
requires = ["setuptools>=61.0.0"]
build-backend = "setuptools.build_meta"

[project]
name = "devspace"
version = "0.1.0"
description = "A clean workflow and context orchestrator for minimalist Linux setups."
dependencies = [
    "customtkinter>=5.2.0",
    "sh>=2.0.0"
]

[project.scripts]
devspace = "devspace.cli:main"
Use code with caution.Why this will be ImpressiveIt moves away from standard fluff projects and directly solves a universal developer friction point: environment setup and switching fatigue. Showing off a tool that handles window management, local port monitoring, and isolated project execution on a clean, snappy Linux architecture demonstrates a strong grasp of OS-level automation, config parsing, and clean desktop architecture.
