nexus-tui 0.1.0__tar.gz

nexus_tui-0.1.0/.gitignore

@@ -0,0 +1,55 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment & Environments
+.venv/
+venv/
+ENV/
+.env
+.env.*
+
+# Development Tools & Caches
+.python-version
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+.tox/
+.nox/
+
+# Coverage
+.coverage
+htmlcov/
+.coverage.*
+
+# IDEs & Editors
+.vscode/
+.idea/
+*.swp
+.DS_Store
+Thumbs.db
+
+# Project Specific
+nexus.egg-info/
+nexus/tools.local.toml
+tools.local.toml
+*.local.toml

nexus_tui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jdluu
+
+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.

nexus_tui-0.1.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: nexus-tui
+Version: 0.1.0
+Summary: A modular TUI for managing development workflows
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: textual>=0.86.0
+Description-Content-Type: text/markdown
+
+# Nexus
+
+Nexus is a terminal interface designed for creating efficient development workflows. It serves as a centralized dashboard for launching command line utilities and managing projects across various operating systems.
+
+## Prerequisites
+
+*   Python 3.12 or newer.
+*   The `uv` package manager.
+*   A modern terminal emulator such as Windows Terminal, ghostty, or iTerm2.
+
+## Installation
+
+Install Nexus globally using the `uv` tool manager:
+
+```bash
+# Always latest stable
+uv tool install nexus-tui
+```
+
+### Upgrade
+
+To update to the latest version:
+```bash
+uv tool upgrade nexus-tui
+```
+
+### Local Development
+
+```bash
+git clone https://github.com/jdluu/Nexus
+cd Nexus
+uv tool install --editable .
+```
+
+## Cross Platform Support
+
+Nexus supports Linux, MacOS, and Windows.
+
+*   **Linux**: Fully supported on standard terminals.
+*   **MacOS**: Fully supported.
+*   **Windows**: Recommended to use PowerShell 7 or Git Bash within Windows Terminal.
+
+## Configuration
+
+Nexus utilizes the standard configuration paths for your operating system.
+
+*   **Linux**: `~/.config/nexus/tools.toml`
+*   **MacOS**: `~/Library/Application Support/Nexus/tools.toml`
+*   **Windows**: `%LOCALAPPDATA%\Nexus\tools.toml`
+
+### Project Directory
+
+To define the workspace where Nexus looks for projects, add the `project_root` key to your configuration file.
+
+```toml
+# Example configuration
+project_root = "~/Development"
+```
+
+### Tool Definitions
+
+Tools are defined in the configuration file using the `[[tool]]` table.
+
+```toml
+[[tool]]
+label = "Neovim"
+category = "DEV"
+description = "Text editor"
+command = "nvim"
+requires_project = true
+```
+
+*   **label**: The display name.
+*   **category**: The grouping identifier (for example DEV, UTIL).
+*   **description**: A short explanation of the function.
+*   **command**: The executable command line instruction.
+*   **requires_project**: Indicates if the tool needs a working directory.
+
+### Keybindings
+
+Custom keybindings can be defined in the `[keybindings]` section.
+
+```toml
+[keybindings]
+quit = "alt+q"
+toggle_favorite = "ctrl+f"
+```
+
+## Usage
+
+Launch the application using the following command:
+
+```bash
+nexus
+```
+
+### Features
+
+*   **Smart Search**: Filter projects using fuzzy matching logic.
+*   **Persistence**: Automatically tracks recent projects and favorites.
+*   **Favorites**: Pin frequently used tools for quick access.
+
+### Controls
+
+*   **Arrow Keys**: Navigate through lists.
+*   **Enter**: Confirm selection or launch tool.
+*   **F**: Toggle the favorite status of a tool.
+*   **Type**: Instantly filter lists by text.
+*   **Esc**: Return to the previous screen.
+*   **Q**: Exit the application.
+
+## Development
+
+To configure the development environment:
+
+1.  Synchronize dependencies:
+    ```bash
+    uv sync
+    ```
+
+2.  Run the application locally:
+    ```bash
+    uv run nexus
+    ```
+
+3.  Execute the comprehensive test suite:
+    ```bash
+    uv run pytest --cov=nexus
+    ```
+
+4.  Perform static analysis and type checking:
+    ```bash
+    uv run ruff check .
+    uv run mypy .
+    ```

nexus_tui-0.1.0/README.md

@@ -0,0 +1,135 @@
+# Nexus
+
+Nexus is a terminal interface designed for creating efficient development workflows. It serves as a centralized dashboard for launching command line utilities and managing projects across various operating systems.
+
+## Prerequisites
+
+*   Python 3.12 or newer.
+*   The `uv` package manager.
+*   A modern terminal emulator such as Windows Terminal, ghostty, or iTerm2.
+
+## Installation
+
+Install Nexus globally using the `uv` tool manager:
+
+```bash
+# Always latest stable
+uv tool install nexus-tui
+```
+
+### Upgrade
+
+To update to the latest version:
+```bash
+uv tool upgrade nexus-tui
+```
+
+### Local Development
+
+```bash
+git clone https://github.com/jdluu/Nexus
+cd Nexus
+uv tool install --editable .
+```
+
+## Cross Platform Support
+
+Nexus supports Linux, MacOS, and Windows.
+
+*   **Linux**: Fully supported on standard terminals.
+*   **MacOS**: Fully supported.
+*   **Windows**: Recommended to use PowerShell 7 or Git Bash within Windows Terminal.
+
+## Configuration
+
+Nexus utilizes the standard configuration paths for your operating system.
+
+*   **Linux**: `~/.config/nexus/tools.toml`
+*   **MacOS**: `~/Library/Application Support/Nexus/tools.toml`
+*   **Windows**: `%LOCALAPPDATA%\Nexus\tools.toml`
+
+### Project Directory
+
+To define the workspace where Nexus looks for projects, add the `project_root` key to your configuration file.
+
+```toml
+# Example configuration
+project_root = "~/Development"
+```
+
+### Tool Definitions
+
+Tools are defined in the configuration file using the `[[tool]]` table.
+
+```toml
+[[tool]]
+label = "Neovim"
+category = "DEV"
+description = "Text editor"
+command = "nvim"
+requires_project = true
+```
+
+*   **label**: The display name.
+*   **category**: The grouping identifier (for example DEV, UTIL).
+*   **description**: A short explanation of the function.
+*   **command**: The executable command line instruction.
+*   **requires_project**: Indicates if the tool needs a working directory.
+
+### Keybindings
+
+Custom keybindings can be defined in the `[keybindings]` section.
+
+```toml
+[keybindings]
+quit = "alt+q"
+toggle_favorite = "ctrl+f"
+```
+
+## Usage
+
+Launch the application using the following command:
+
+```bash
+nexus
+```
+
+### Features
+
+*   **Smart Search**: Filter projects using fuzzy matching logic.
+*   **Persistence**: Automatically tracks recent projects and favorites.
+*   **Favorites**: Pin frequently used tools for quick access.
+
+### Controls
+
+*   **Arrow Keys**: Navigate through lists.
+*   **Enter**: Confirm selection or launch tool.
+*   **F**: Toggle the favorite status of a tool.
+*   **Type**: Instantly filter lists by text.
+*   **Esc**: Return to the previous screen.
+*   **Q**: Exit the application.
+
+## Development
+
+To configure the development environment:
+
+1.  Synchronize dependencies:
+    ```bash
+    uv sync
+    ```
+
+2.  Run the application locally:
+    ```bash
+    uv run nexus
+    ```
+
+3.  Execute the comprehensive test suite:
+    ```bash
+    uv run pytest --cov=nexus
+    ```
+
+4.  Perform static analysis and type checking:
+    ```bash
+    uv run ruff check .
+    uv run mypy .
+    ```

nexus_tui-0.1.0/nexus/tools.toml

@@ -0,0 +1,28 @@
+# Default Configuration
+# You can override this by creating a `tools.local.toml` in this directory
+# or `~/.config/nexus/tools.toml` (Linux), `~/Library/Application Support/Nexus/tools.toml` (Mac),
+# or `%LOCALAPPDATA%\Nexus\tools.toml` (Windows).
+
+# To set your project root (where Nexus looks for projects):
+# project_root = "~/Projects" # Tilde is expanded to User Home
+
+[[tool]]
+label = "Neovim"
+category = "DEV"
+description = "Hyperextensible text editor"
+command = "nvim"
+requires_project = true
+
+[[tool]]
+label = "Lazygit"
+category = "DEV"
+description = "Git TUI interface"
+command = "lazygit"
+requires_project = true
+
+[[tool]]
+label = "Htop"
+category = "UTIL"
+description = "Process viewer"
+command = "htop"
+requires_project = false

nexus_tui-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "nexus-tui"
+version = "0.1.0"
+description = "A modular TUI for managing development workflows"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "pydantic>=2.12.5",
+    "textual>=0.86.0",
+]
+
+[project.scripts]
+nexus = "nexus.app:main"
+
+[tool.nexus]
+priority_terminals = ["kitty", "ghostty", "gnome-terminal", "xterm", "wezterm", "alacritty"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["nexus"]
+
+[tool.hatch.build.targets.sdist]
+include = ["nexus/tools.toml"]
+
+[dependency-groups]
+dev = [
+    "ruff>=0.14.13",
+    "pytest>=8.0.0",
+    "mypy>=1.0.0",
+    "structlog>=24.1.0",
+    "pytest-asyncio>=1.3.0",
+    "types-toml>=0.10.8",
+    "pytest-cov>=4.1.0",
+    "thefuzz>=0.20.0",
+    "platformdirs>=4.0.0",
+]
+
+[tool.mypy]
+strict = true
+ignore_missing_imports = true
+
+[tool.coverage.run]
+source = ["nexus"]
+omit = ["tests/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if self.debug:",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+]