devdash-mac 0.1.0__py3-none-any.whl

devdash/tools/uuid_tool.py

@@ -0,0 +1,119 @@
+"""UUID v4/v7 and ULID generator."""
+
+import re
+import secrets
+import sys
+import time
+import uuid
+
+from devdash.tools.base import DevTool
+
+_UUID_PATTERN = re.compile(
+    r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", re.IGNORECASE
+)
+
+# ULID encoding alphabet (Crockford's Base32)
+_ULID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"
+
+
+def _generate_uuid_v7() -> str:
+    """Generate UUID v7 (timestamp-based)."""
+    if sys.version_info >= (3, 12):
+        # Not available in stdlib until hypothetical future; use manual
+        pass
+    # Manual UUID v7 implementation
+    timestamp_ms = int(time.time() * 1000)
+    rand_bytes = secrets.token_bytes(10)
+
+    # Build 16 bytes: 6 bytes timestamp + 2 bytes ver/rand + 8 bytes rand
+    ts_bytes = timestamp_ms.to_bytes(6, "big")
+    uuid_bytes = bytearray(16)
+    uuid_bytes[0:6] = ts_bytes
+    uuid_bytes[6:16] = rand_bytes
+
+    # Set version (0111 = 7) in bits 48-51
+    uuid_bytes[6] = (uuid_bytes[6] & 0x0F) | 0x70
+    # Set variant (10xx) in bits 64-65
+    uuid_bytes[8] = (uuid_bytes[8] & 0x3F) | 0x80
+
+    hex_str = uuid_bytes.hex()
+    return f"{hex_str[:8]}-{hex_str[8:12]}-{hex_str[12:16]}-{hex_str[16:20]}-{hex_str[20:]}"
+
+
+def _generate_ulid() -> str:
+    """Generate a ULID (Universally Unique Lexicographically Sortable Identifier)."""
+    timestamp_ms = int(time.time() * 1000)
+    rand_bytes = secrets.token_bytes(10)
+
+    # Encode timestamp (48 bits) as 10 Crockford Base32 chars
+    chars: list[str] = []
+    t = timestamp_ms
+    for _ in range(10):
+        chars.append(_ULID_ALPHABET[t & 0x1F])
+        t >>= 5
+    time_part = "".join(reversed(chars))
+
+    # Encode randomness (80 bits) as 16 Crockford Base32 chars
+    rand_int = int.from_bytes(rand_bytes, "big")
+    chars = []
+    for _ in range(16):
+        chars.append(_ULID_ALPHABET[rand_int & 0x1F])
+        rand_int >>= 5
+    rand_part = "".join(reversed(chars))
+
+    return time_part + rand_part
+
+
+class UuidTool(DevTool):
+    @property
+    def name(self) -> str:
+        return "UUID / ULID Generator"
+
+    @property
+    def keyword(self) -> str:
+        return "uuid"
+
+    @property
+    def category(self) -> str:
+        return "Generators"
+
+    @property
+    def description(self) -> str:
+        return "Generate UUID v4, v7, or ULID; validate UUIDs"
+
+    def process(self, input_text: str, **kwargs: object) -> str:
+        text = input_text.strip()
+
+        # If input looks like a UUID, validate it
+        if text and _UUID_PATTERN.match(text):
+            try:
+                parsed = uuid.UUID(text)
+                return f"Valid UUID (version {parsed.version}): {parsed}"
+            except ValueError:
+                return "Invalid UUID format"
+
+        version = str(kwargs.get("version", "v4"))
+        count = int(kwargs.get("count", 1))
+        uppercase = bool(kwargs.get("uppercase", False))
+        count = max(1, min(count, 100))
+
+        results: list[str] = []
+        for _ in range(count):
+            if version == "v7":
+                val = _generate_uuid_v7()
+            elif version == "ulid":
+                val = _generate_ulid()
+            else:
+                val = str(uuid.uuid4())
+
+            if uppercase:
+                val = val.upper()
+            else:
+                val = val.lower()
+            results.append(val)
+
+        return "\n".join(results)
+
+
+def register() -> DevTool:
+    return UuidTool()

devdash/ui/__init__.py

@@ -0,0 +1 @@
+"""DevDash UI components."""

devdash/ui/notifications.py

@@ -0,0 +1,22 @@
+"""macOS native notifications helper."""
+
+import rumps
+
+
+def notify(title: str, message: str, subtitle: str = "") -> None:
+    """Show a macOS notification with consistent DevDash styling."""
+    rumps.notification(
+        title=title,
+        subtitle=subtitle,
+        message=message,
+    )
+
+
+def notify_copied() -> None:
+    """Show 'Copied to clipboard' notification."""
+    notify("DevDash", "Copied to clipboard!")
+
+
+def notify_error(message: str) -> None:
+    """Show an error notification."""
+    notify("DevDash - Error", message)

devdash/ui/windows.py

@@ -0,0 +1,84 @@
+"""Custom rumps.Window wrappers for consistent tool UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import rumps
+
+from devdash import clipboard
+from devdash.ui.notifications import notify_copied, notify_error
+
+if TYPE_CHECKING:
+    from devdash.tools.base import DevTool
+
+
+def show_tool_dialog(tool: DevTool, input_text: str = "") -> None:
+    """Show input window, process with tool, show output, offer clipboard copy."""
+    window = rumps.Window(
+        message=tool.description or f"Enter input for {tool.name}",
+        title=tool.name,
+        default_text=input_text,
+        ok="Process",
+        cancel="Cancel",
+        dimensions=(320, 200),
+    )
+    response = window.run()
+    if not response.clicked:
+        return
+
+    text = response.text
+    error = tool.validate(text)
+    if error:
+        notify_error(error)
+        return
+
+    try:
+        result = tool.process(text)
+    except Exception as e:
+        notify_error(f"Error: {e}")
+        return
+
+    # Show output window
+    output_window = rumps.Window(
+        message="Result (click OK to copy to clipboard):",
+        title=f"{tool.name} - Output",
+        default_text=result,
+        ok="Copy to Clipboard",
+        cancel="Close",
+        dimensions=(320, 200),
+    )
+    out_response = output_window.run()
+    if out_response.clicked:
+        clipboard.write(result)
+        notify_copied()
+
+
+def show_multi_input_dialog(
+    tool: DevTool,
+    fields: list[tuple[str, str]],
+) -> list[str] | None:
+    """Show sequential input dialogs for tools needing multiple inputs.
+
+    Args:
+        tool: The tool instance.
+        fields: List of (label, default_value) tuples.
+
+    Returns:
+        List of input values, or None if cancelled.
+    """
+    values: list[str] = []
+    for label, default in fields:
+        window = rumps.Window(
+            message=label,
+            title=tool.name,
+            default_text=default,
+            ok="Next" if len(values) < len(fields) - 1 else "Process",
+            cancel="Cancel",
+            dimensions=(320, 150),
+        )
+        response = window.run()
+        if not response.clicked:
+            return None
+        values.append(response.text)
+    return values

devdash_mac-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,30 @@
+devdash/__init__.py,sha256=gtDTOlI0x-HJdB2DQHYS8Tnkt5Nt1t6hUdGHKW8GT-I,111
+devdash/__main__.py,sha256=FFZVLUrCty8o-YTs7ENbkw60HmVwOPOvTBBlHtoFBCo,112
+devdash/app.py,sha256=NAhifbj-vRi7tW0awNpyYDqz6TZlgqzDILXcLEmfBYM,5411
+devdash/clipboard.py,sha256=fGrocv24_75r5Ys3nhIhmF3LJa1x4q6cCHsTADH5muA,2808
+devdash/config.py,sha256=rXz1_1GN9Znvqc3-FSSIuN0IMuTa-4uxCxsqMo1tfAU,1435
+devdash/plugin_loader.py,sha256=LjW9RBM2rYyosmQJBl5L_3O6yHoPAmQJxmaAYMu10Zk,1327
+devdash/storage.py,sha256=kbgqI1QuPH7BhU0t0H9f15UvFso2CqyJn7f_JQtdZ7I,7840
+devdash/tools/__init__.py,sha256=Ht3dBoH29xzzg6988NSJENd63P4uMIRbYszSBCEDO6Y,30
+devdash/tools/base.py,sha256=NPQM6nYTS7ykwcPxRmZj-whUAk74H243Stutvlna20c,928
+devdash/tools/base64_tool.py,sha256=Wx3Lfm-XQZONz9VaiR1rOXmnaQ0PlBuV3KrRKEUs5tE,2640
+devdash/tools/color_tool.py,sha256=vV9tvj-G-7afvq472njgI3KKVf0cBp-M3NqRyHhdCBg,3832
+devdash/tools/cron_tool.py,sha256=7zPhZ9xduiOXtdg116PsQJKRIAecOwxIpzlfypdS2H0,4278
+devdash/tools/hash_tool.py,sha256=DRBRZCbH52Etk4GIDxsFeYF8xnUUt8tO6UaaMYpeL6w,2037
+devdash/tools/json_tool.py,sha256=aRWnSP_zB-ro3W6-Gfemt0ql-zuUHAQXyuXchcke5Wc,1753
+devdash/tools/jwt_tool.py,sha256=r7hpULBiYpVbp7FNyXE9FnUVgPqps2TKYGhXjIjbplE,2831
+devdash/tools/lorem_tool.py,sha256=DIt06y5cqF_wzSDnHUeQy2I48eSpaKerUwSbuFr3nUI,3703
+devdash/tools/password_tool.py,sha256=XZPRQ58tZu9cyJ6-NbsjcyYD4TblheyUoZTyomyN21M,6559
+devdash/tools/regex_tool.py,sha256=h4rJ7ringDUhceg7LePxhQ7AjibySXn6gV13ERbjYZM,2706
+devdash/tools/timestamp_tool.py,sha256=jAMGNQ0_wyapk1Kjz0oSeEZaYurgo6V8w1hZoHlAj9s,4181
+devdash/tools/url_tool.py,sha256=sqi7K1hBgrufPW_iHGBamwWsIYwI3CkuIm5zV8ySXew,2103
+devdash/tools/uuid_tool.py,sha256=xNFj6x_OnMR97acxVSYKMsd-OEKArLauysvR0KpSURg,3404
+devdash/ui/__init__.py,sha256=jiMWDarEwz6tc2z1Yd1sTt3xeoYFBCPkfJM6N0Ayv2g,29
+devdash/ui/notifications.py,sha256=87IAuQIVOsYEqkueSJ7j4I-CAJNnVXBoVH88iXm1MHk,542
+devdash/ui/windows.py,sha256=7HfAETkfeTXS9d1hwb3fLicDvAT37BzXIwPrHUaEOnU,2229
+devdash_mac-0.1.0.dist-info/licenses/LICENSE,sha256=sjP20vbIrJHhrjfJ-FoI9vrktuxBhd9MjV1ddfNIdGU,1077
+devdash_mac-0.1.0.dist-info/METADATA,sha256=Wlo-tw443fJQ2ofJXKjJz9zckaYcI2iYs7A-FbTkdG4,6353
+devdash_mac-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+devdash_mac-0.1.0.dist-info/entry_points.txt,sha256=LIj0XyHuL5S6xW_uFwx5PCViD4s5UNTlsWlKtIc6VI0,50
+devdash_mac-0.1.0.dist-info/top_level.txt,sha256=5d0fXhQcW9hREl625T3slXusJxOgWejd9Pm3VAtHDr4,8
+devdash_mac-0.1.0.dist-info/RECORD,,

devdash_mac-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devdash_mac-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devdash = devdash.__main__:main

devdash_mac-0.1.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+devdash