devdash-mac 0.1.0__tar.gz

devdash_mac-0.1.0/LICENSE

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

devdash_mac-0.1.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: devdash-mac
+Version: 0.1.0
+Summary: Open-source macOS menubar developer utilities
+Author: DevDash Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/devdash/devdash
+Project-URL: Repository, https://github.com/devdash/devdash
+Project-URL: Issues, https://github.com/devdash/devdash/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rumps>=0.4.0
+Requires-Dist: pyperclip>=1.8.0
+Requires-Dist: PyJWT>=2.8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: croniter>=1.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# DevDash
+
+Open-source macOS menubar developer utilities at your fingertips.
+
+[![PyPI](https://img.shields.io/pypi/v/devdash.svg)](https://pypi.org/project/devdash)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+[GIF PLACEHOLDER - menubar app with tools opening in macOS]
+
+## Why DevDash?
+
+- **Free & Open Source** — MIT licensed, no ads, no tracking, community-driven
+- **Offline First** — All processing happens locally. Nothing is ever sent to external services
+- **Pip Installable** — Single command installation. Works with Python 3.10+
+
+## Quick Start
+
+```bash
+pip install devdash
+devdash
+```
+
+Click the wrench icon (🔧) in your macOS menubar to access all tools.
+
+## Tools
+
+DevDash includes 12 essential developer utilities:
+
+| Tool | What it does |
+|------|-------------|
+| 📝 **JSON Formatter** | Format, validate, and minify JSON |
+| 🔐 **JWT Decoder** | Decode and inspect JSON Web Tokens |
+| 🆔 **UUID / ULID Generator** | Generate UUID v4, v7, or ULID identifiers |
+| 📄 **Base64 Encode/Decode** | Encode text to Base64 or decode back |
+| #️⃣ **Hash Generator** | Generate MD5, SHA256, SHA512 hashes |
+| ⏰ **Timestamp Converter** | Convert between Unix timestamps and readable dates |
+| 🔗 **URL Encode/Decode** | Encode and decode URL-safe strings |
+| 🔍 **Regex Tester** | Test regular expressions with live matches |
+| 🎨 **Color Converter** | Convert between hex, RGB, and HSL colors |
+| 📚 **Lorem Ipsum Generator** | Generate placeholder text and paragraphs |
+| 🔑 **Password Generator** | Create secure random passwords |
+| ⏱️ **Cron Parser** | Parse and explain cron expressions |
+
+## Smart Clipboard
+
+DevDash auto-detects your clipboard content and opens the right tool automatically.
+
+**How it works:**
+1. Copy anything to your clipboard (JSON, UUID, JWT, URL, etc.)
+2. Click "Clipboard: Auto-detect" in the DevDash menu
+3. The matching tool opens with your content pre-filled
+
+Supports auto-detection for: JSON, JWT, UUID, Base64, URL-encoded text, timestamps, hex colors, and cron expressions.
+
+## Configuration
+
+DevDash stores user preferences in `~/.config/devdash/config.yaml`. Edit this file to customize:
+
+```yaml
+# Default hash algorithm: md5, sha256, sha512
+default_hash_algorithm: sha256
+
+# Timestamp format (Python strftime)
+timestamp_format: "%Y-%m-%d %H:%M:%S"
+
+# Password generator length
+password_length: 16
+
+# UUID version: v4, v7
+uuid_version: v4
+
+# Enable clipboard auto-detection
+auto_clipboard_detection: true
+
+# Watch clipboard for changes (experimental)
+clipboard_watcher: false
+```
+
+The config file is created automatically on first run with sensible defaults.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install devdash
+devdash
+```
+
+### From Source
+
+```bash
+git clone https://github.com/devdash/devdash.git
+cd devdash
+pip install -e .
+devdash
+```
+
+For development setup, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## macOS Permissions
+
+DevDash needs clipboard access to work. On first run, macOS will ask for permission:
+
+> "DevDash" would like to access your clipboard.
+
+Click **Allow** to enable clipboard auto-detection. You can revoke this later in System Preferences → Security & Privacy → Accessibility.
+
+## Troubleshooting
+
+**"command not found: devdash"**
+- Ensure Python 3.10+ is installed: `python3 --version`
+- Reinstall: `pip install --upgrade devdash`
+
+**Menubar icon doesn't appear**
+- Restart the app: press Ctrl+C to quit, then run `devdash` again
+- Check that you have a menubar (not in fullscreen)
+
+**Clipboard detection not working**
+- Grant clipboard permission: System Preferences → Security & Privacy → Accessibility
+- Enable in config: `auto_clipboard_detection: true`
+
+## Contributing
+
+Found a bug? Want a new tool? Head to [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
+
+Quick links:
+- [Reporting bugs](CONTRIBUTING.md#reporting-bugs)
+- [Suggesting features](CONTRIBUTING.md#suggesting-features)
+- [Adding a new tool](docs/adding-tools.md)
+- [Architecture overview](docs/architecture.md)
+
+## Built With
+
+- [rumps](https://github.com/jmorey/rumps) — Ridiculously Uncomplicated macOS Python Statusbar applications
+- [pyperclip](https://github.com/asweigart/pyperclip) — Cross-platform clipboard support
+- [PyJWT](https://pyjwt.readthedocs.io/) — JWT encoding and decoding
+- [pyyaml](https://pyyaml.org/) — YAML configuration parsing
+- [croniter](https://github.com/taichino/croniter) — Cron expression parsing
+
+## Security
+
+All data processing happens locally on your machine:
+- Input is never sent to external services
+- Clipboard content is not logged or stored
+- No telemetry or analytics
+
+See [LICENSE](LICENSE) for full details.
+
+## License
+
+MIT License © 2024 DevDash Contributors
+
+See [LICENSE](LICENSE) for details.

devdash_mac-0.1.0/README.md

@@ -0,0 +1,155 @@
+# DevDash
+
+Open-source macOS menubar developer utilities at your fingertips.
+
+[![PyPI](https://img.shields.io/pypi/v/devdash.svg)](https://pypi.org/project/devdash)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+[GIF PLACEHOLDER - menubar app with tools opening in macOS]
+
+## Why DevDash?
+
+- **Free & Open Source** — MIT licensed, no ads, no tracking, community-driven
+- **Offline First** — All processing happens locally. Nothing is ever sent to external services
+- **Pip Installable** — Single command installation. Works with Python 3.10+
+
+## Quick Start
+
+```bash
+pip install devdash
+devdash
+```
+
+Click the wrench icon (🔧) in your macOS menubar to access all tools.
+
+## Tools
+
+DevDash includes 12 essential developer utilities:
+
+| Tool | What it does |
+|------|-------------|
+| 📝 **JSON Formatter** | Format, validate, and minify JSON |
+| 🔐 **JWT Decoder** | Decode and inspect JSON Web Tokens |
+| 🆔 **UUID / ULID Generator** | Generate UUID v4, v7, or ULID identifiers |
+| 📄 **Base64 Encode/Decode** | Encode text to Base64 or decode back |
+| #️⃣ **Hash Generator** | Generate MD5, SHA256, SHA512 hashes |
+| ⏰ **Timestamp Converter** | Convert between Unix timestamps and readable dates |
+| 🔗 **URL Encode/Decode** | Encode and decode URL-safe strings |
+| 🔍 **Regex Tester** | Test regular expressions with live matches |
+| 🎨 **Color Converter** | Convert between hex, RGB, and HSL colors |
+| 📚 **Lorem Ipsum Generator** | Generate placeholder text and paragraphs |
+| 🔑 **Password Generator** | Create secure random passwords |
+| ⏱️ **Cron Parser** | Parse and explain cron expressions |
+
+## Smart Clipboard
+
+DevDash auto-detects your clipboard content and opens the right tool automatically.
+
+**How it works:**
+1. Copy anything to your clipboard (JSON, UUID, JWT, URL, etc.)
+2. Click "Clipboard: Auto-detect" in the DevDash menu
+3. The matching tool opens with your content pre-filled
+
+Supports auto-detection for: JSON, JWT, UUID, Base64, URL-encoded text, timestamps, hex colors, and cron expressions.
+
+## Configuration
+
+DevDash stores user preferences in `~/.config/devdash/config.yaml`. Edit this file to customize:
+
+```yaml
+# Default hash algorithm: md5, sha256, sha512
+default_hash_algorithm: sha256
+
+# Timestamp format (Python strftime)
+timestamp_format: "%Y-%m-%d %H:%M:%S"
+
+# Password generator length
+password_length: 16
+
+# UUID version: v4, v7
+uuid_version: v4
+
+# Enable clipboard auto-detection
+auto_clipboard_detection: true
+
+# Watch clipboard for changes (experimental)
+clipboard_watcher: false
+```
+
+The config file is created automatically on first run with sensible defaults.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install devdash
+devdash
+```
+
+### From Source
+
+```bash
+git clone https://github.com/devdash/devdash.git
+cd devdash
+pip install -e .
+devdash
+```
+
+For development setup, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## macOS Permissions
+
+DevDash needs clipboard access to work. On first run, macOS will ask for permission:
+
+> "DevDash" would like to access your clipboard.
+
+Click **Allow** to enable clipboard auto-detection. You can revoke this later in System Preferences → Security & Privacy → Accessibility.
+
+## Troubleshooting
+
+**"command not found: devdash"**
+- Ensure Python 3.10+ is installed: `python3 --version`
+- Reinstall: `pip install --upgrade devdash`
+
+**Menubar icon doesn't appear**
+- Restart the app: press Ctrl+C to quit, then run `devdash` again
+- Check that you have a menubar (not in fullscreen)
+
+**Clipboard detection not working**
+- Grant clipboard permission: System Preferences → Security & Privacy → Accessibility
+- Enable in config: `auto_clipboard_detection: true`
+
+## Contributing
+
+Found a bug? Want a new tool? Head to [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
+
+Quick links:
+- [Reporting bugs](CONTRIBUTING.md#reporting-bugs)
+- [Suggesting features](CONTRIBUTING.md#suggesting-features)
+- [Adding a new tool](docs/adding-tools.md)
+- [Architecture overview](docs/architecture.md)
+
+## Built With
+
+- [rumps](https://github.com/jmorey/rumps) — Ridiculously Uncomplicated macOS Python Statusbar applications
+- [pyperclip](https://github.com/asweigart/pyperclip) — Cross-platform clipboard support
+- [PyJWT](https://pyjwt.readthedocs.io/) — JWT encoding and decoding
+- [pyyaml](https://pyyaml.org/) — YAML configuration parsing
+- [croniter](https://github.com/taichino/croniter) — Cron expression parsing
+
+## Security
+
+All data processing happens locally on your machine:
+- Input is never sent to external services
+- Clipboard content is not logged or stored
+- No telemetry or analytics
+
+See [LICENSE](LICENSE) for full details.
+
+## License
+
+MIT License © 2024 DevDash Contributors
+
+See [LICENSE](LICENSE) for details.

devdash_mac-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devdash-mac"
+version = "0.1.0"
+description = "Open-source macOS menubar developer utilities"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [{name = "DevDash Contributors"}]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: MacOS X",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "rumps>=0.4.0",
+    "pyperclip>=1.8.0",
+    "PyJWT>=2.8.0",
+    "pyyaml>=6.0",
+    "croniter>=1.3.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov",
+    "ruff",
+    "mypy",
+    "pre-commit",
+    "build",
+    "twine",
+]
+
+[project.scripts]
+devdash = "devdash.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/devdash/devdash"
+Repository = "https://github.com/devdash/devdash"
+Issues = "https://github.com/devdash/devdash/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src/devdash --cov-report=term-missing"

devdash_mac-0.1.0/setup.cfg

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

devdash_mac-0.1.0/src/devdash/__init__.py

@@ -0,0 +1,4 @@
+"""DevDash - Open-source macOS menubar developer utilities."""
+
+__version__ = "0.1.0"
+__app_name__ = "DevDash"

devdash_mac-0.1.0/src/devdash/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m devdash`."""
+
+from devdash.app import main
+
+if __name__ == "__main__":
+    main()

devdash_mac-0.1.0/src/devdash/app.py

@@ -0,0 +1,145 @@
+"""Main DevDash application - macOS menubar app."""
+
+from __future__ import annotations
+
+import rumps
+
+from devdash import __app_name__, __version__, clipboard
+from devdash.config import load_config
+from devdash.plugin_loader import discover_tools
+from devdash.tools.base import DevTool
+from devdash.ui.notifications import notify
+from devdash.ui.windows import show_tool_dialog
+
+# Content type display names for notifications
+_TYPE_NAMES: dict[clipboard.ContentType, str] = {
+    clipboard.ContentType.JSON: "JSON",
+    clipboard.ContentType.JWT: "JWT token",
+    clipboard.ContentType.UUID: "UUID",
+    clipboard.ContentType.BASE64: "Base64",
+    clipboard.ContentType.UNIX_TIMESTAMP: "Unix timestamp",
+    clipboard.ContentType.URL: "URL",
+    clipboard.ContentType.URL_ENCODED: "URL-encoded text",
+    clipboard.ContentType.HEX_COLOR: "HEX color",
+    clipboard.ContentType.CRON: "Cron expression",
+}
+
+
+class DevDashApp(rumps.App):
+    """macOS menubar developer utilities app."""
+
+    def __init__(self) -> None:
+        super().__init__(name=__app_name__, title="\U0001f527", quit_button=None)
+        self._tools: list[DevTool] = discover_tools()
+        self._last_clipboard: str = ""
+        self._build_menu()
+        # Start clipboard watcher if enabled in config
+        config = load_config()
+        if config.get("clipboard_watcher", False):
+            self._start_clipboard_watcher()
+
+    def _build_menu(self) -> None:
+        """Build the menubar dropdown from discovered tools."""
+        menu_items: list[rumps.MenuItem | None] = []
+
+        # Auto-detect clipboard item
+        auto_detect = rumps.MenuItem("Clipboard: Auto-detect", callback=self._on_auto_detect)
+        menu_items.append(auto_detect)
+        menu_items.append(None)  # separator
+
+        # Group tools by category
+        current_category = ""
+        for tool in self._tools:
+            if tool.category != current_category:
+                if current_category:
+                    menu_items.append(None)  # separator between categories
+                current_category = tool.category
+            item = rumps.MenuItem(tool.name, callback=self._make_tool_callback(tool))
+            menu_items.append(item)
+
+        menu_items.append(None)  # separator
+
+        # About and Quit
+        about = rumps.MenuItem(f"About {__app_name__}", callback=self._on_about)
+        quit_item = rumps.MenuItem("Quit", callback=self._on_quit)
+        menu_items.append(about)
+        menu_items.append(quit_item)
+
+        self.menu = menu_items
+
+    def _make_tool_callback(self, tool: DevTool):  # type: ignore[no-untyped-def]
+        """Create a callback closure for a specific tool."""
+
+        def callback(_: rumps.MenuItem) -> None:
+            show_tool_dialog(tool)
+
+        return callback
+
+    def _on_auto_detect(self, _: rumps.MenuItem) -> None:
+        """Read clipboard, detect content type, open matching tool."""
+        content = clipboard.read()
+        if not content.strip():
+            notify("DevDash", "Clipboard is empty")
+            return
+
+        detected = clipboard.detect_type(content)
+        # Find matching tool by keyword
+        keyword_map = {
+            clipboard.ContentType.JSON: "json",
+            clipboard.ContentType.JWT: "jwt",
+            clipboard.ContentType.UUID: "uuid",
+            clipboard.ContentType.BASE64: "base64",
+            clipboard.ContentType.UNIX_TIMESTAMP: "timestamp",
+            clipboard.ContentType.URL: "url",
+            clipboard.ContentType.URL_ENCODED: "url",
+            clipboard.ContentType.HEX_COLOR: "color",
+            clipboard.ContentType.CRON: "cron",
+        }
+        keyword = keyword_map.get(detected)
+        if keyword:
+            for tool in self._tools:
+                if tool.keyword == keyword:
+                    show_tool_dialog(tool, input_text=content)
+                    return
+        notify("DevDash", f"Detected: {detected.name}. No matching tool found.")
+
+    def _on_about(self, _: rumps.MenuItem) -> None:
+        """Show about dialog."""
+        rumps.alert(
+            title=f"About {__app_name__}",
+            message=f"{__app_name__} v{__version__}\n\n"
+            "Open-source macOS menubar developer utilities.\n"
+            "https://github.com/devdash/devdash",
+        )
+
+    def _on_quit(self, _: rumps.MenuItem) -> None:
+        """Quit the app."""
+        rumps.quit_application()
+
+    def _start_clipboard_watcher(self) -> None:
+        """Start background clipboard polling (opt-in, privacy conscious)."""
+
+        @rumps.timer(2)
+        def _watch_clipboard(timer: rumps.Timer) -> None:
+            try:
+                content = clipboard.read()
+                if not content or content == self._last_clipboard:
+                    return
+                self._last_clipboard = content
+                detected = clipboard.detect_type(content)
+                if detected != clipboard.ContentType.PLAIN_TEXT:
+                    type_name = _TYPE_NAMES.get(detected, detected.name)
+                    notify(
+                        "DevDash",
+                        f"Detected {type_name} in your clipboard. Click to process.",
+                    )
+            except Exception:
+                pass  # Never crash the watcher
+
+        _watch_clipboard.start()  # type: ignore[attr-defined]
+
+
+def main() -> None:
+    """Entry point for the application."""
+    app = DevDashApp()
+    app.run()