ruru 0.1.0__tar.gz

ruru-0.1.0/LICENSE

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

ruru-0.1.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: ruru
+Version: 0.1.0
+Summary: A powerful CLI tool for managing and versioning prompts across projects
+Author-email: Ekky Armandi <me@ekkyarmandi.com>
+Maintainer-email: Ekky Armandi <me@ekkyarmandi.com>
+License: MIT License
+        
+        Copyright (c) 2025 Ekky Armandi
+        
+        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.
+        
+Keywords: prompts,rules,ai,llm,context,version-control,prompt-management
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-decouple>=3.6
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: tqdm>=4.64.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-click>=1.1.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: responses>=0.23.0; extra == "dev"
+Dynamic: license-file
+
+# Ruru CLI
+
+A powerful CLI tool for managing and versioning prompts across projects.
+
+Ruru helps developers manage, version, and sync prompt files (like `.cursorrules`) across multiple projects with a simple command-line interface.
+
+## Features
+
+- 🔐 **Secure Authentication** - API key management with keyring support
+- 📁 **Prompt Management** - Create, update, delete, and version prompts
+- 🔍 **Search & Discovery** - Find prompts by name, tags, or content
+- 📥 **Sync & Download** - Get prompts from the cloud to your local projects
+- 🏷️ **Tagging System** - Organize prompts with custom tags
+- 📊 **Version Control** - Track changes and manage prompt versions
+- ⚙️ **Flexible Configuration** - Environment variables and config file support
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install ruru
+```
+
+### From Source
+
+```bash
+git clone https://github.com/ekkyarmandi/ruru-cli.git
+cd ruru/cli
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Authentication
+
+First, set up your API credentials:
+
+```bash
+# Set API key (will be stored securely in keyring)
+ruru auth login
+
+# Check authentication status
+ruru auth status
+```
+
+### 2. Configuration
+
+Configure the CLI for your environment:
+
+```bash
+# Create .env file with your settings
+cat > .env << EOF
+RURU_API_URL=https://ruru.ekkyarmandi.com
+RURU_API_KEY=your_api_key_here
+RURU_OUTPUT_FORMAT=table
+EOF
+```
+
+### 3. Basic Usage
+
+```bash
+# List all prompts
+ruru prompts list
+
+# Search for prompts
+ruru prompts search "cursor rules"
+
+# Get a specific prompt
+ruru prompts get my-prompt
+
+# Create a new prompt
+ruru prompts create --name "my-new-prompt" --file .cursorrules
+
+# Update an existing prompt
+ruru prompts update my-prompt --file .cursorrules
+```
+
+## Configuration
+
+Ruru CLI supports multiple configuration methods:
+
+### Environment Variables
+
+```bash
+export RURU_API_URL="https://ruru.ekkyarmandi.com"
+export RURU_API_KEY="your_api_key"
+export RURU_OUTPUT_FORMAT="table"  # table, json, yaml
+export RURU_NO_COLOR="false"
+export RURU_VERBOSE="false"
+```
+
+### Configuration File
+
+Create `~/.ruru/config.yaml`:
+
+```yaml
+api:
+  url: "https://ruru.ekkyarmandi.com"
+  timeout: 30
+
+defaults:
+  location: "./"
+  auto_create_dirs: true
+
+output:
+  format: "table"
+  color: true
+
+cache:
+  enabled: true
+  ttl: 300
+```
+
+### .env File
+
+Create a `.env` file in your project directory:
+
+```env
+RURU_API_URL=http://localhost:8000
+RURU_API_KEY=your_local_api_key
+RURU_OUTPUT_FORMAT=json
+```
+
+## Commands
+
+### Authentication
+
+```bash
+ruru auth login          # Set up API credentials
+ruru auth logout         # Remove stored credentials
+ruru auth status         # Check authentication status
+```
+
+### Prompt Management
+
+```bash
+# List and search
+ruru prompts list                    # List all prompts
+ruru prompts list --tags python,ai  # Filter by tags
+ruru prompts search "query"          # Search prompts
+
+# Get prompts
+ruru prompts get <name>              # Download prompt to file
+ruru prompts get <name> --output -   # Print to stdout
+
+# Create and update
+ruru prompts create --name <name> --file <file>
+ruru prompts update <name> --file <file>
+ruru prompts delete <name>
+
+# Version management
+ruru prompts versions <name>         # List versions
+ruru prompts rollback <name> <version>
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/ekkyarmandi/ruru-cli.git
+cd ruru-cli
+
+# Install with development dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linting
+black .
+isort .
+flake8
+mypy .
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=ruru --cov-report=html
+
+# Run specific test file
+pytest tests/test_client.py
+```
+
+## API Integration
+
+The CLI integrates with the Ruru API. For local development:
+
+1. Start the API server:
+
+   ```bash
+   cd ../api
+   uvicorn app.main:app --reload --port 8000
+   ```
+
+2. Configure CLI for local API:
+   ```bash
+   export RURU_API_URL=http://localhost:8000
+   ```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add tests for your changes
+5. Run the test suite (`pytest`)
+6. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📧 Email: me@ekkyarmandi.com
+- 🐛 Issues: [GitHub Issues](https://github.com/ekkyarmandi/ruru-cli/issues)
+- 📖 Documentation: [GitHub Wiki](https://github.com/ekkyarmandi/ruru-cli/wiki)

ruru-0.1.0/README.md

@@ -0,0 +1,226 @@
+# Ruru CLI
+
+A powerful CLI tool for managing and versioning prompts across projects.
+
+Ruru helps developers manage, version, and sync prompt files (like `.cursorrules`) across multiple projects with a simple command-line interface.
+
+## Features
+
+- 🔐 **Secure Authentication** - API key management with keyring support
+- 📁 **Prompt Management** - Create, update, delete, and version prompts
+- 🔍 **Search & Discovery** - Find prompts by name, tags, or content
+- 📥 **Sync & Download** - Get prompts from the cloud to your local projects
+- 🏷️ **Tagging System** - Organize prompts with custom tags
+- 📊 **Version Control** - Track changes and manage prompt versions
+- ⚙️ **Flexible Configuration** - Environment variables and config file support
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install ruru
+```
+
+### From Source
+
+```bash
+git clone https://github.com/ekkyarmandi/ruru-cli.git
+cd ruru/cli
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Authentication
+
+First, set up your API credentials:
+
+```bash
+# Set API key (will be stored securely in keyring)
+ruru auth login
+
+# Check authentication status
+ruru auth status
+```
+
+### 2. Configuration
+
+Configure the CLI for your environment:
+
+```bash
+# Create .env file with your settings
+cat > .env << EOF
+RURU_API_URL=https://ruru.ekkyarmandi.com
+RURU_API_KEY=your_api_key_here
+RURU_OUTPUT_FORMAT=table
+EOF
+```
+
+### 3. Basic Usage
+
+```bash
+# List all prompts
+ruru prompts list
+
+# Search for prompts
+ruru prompts search "cursor rules"
+
+# Get a specific prompt
+ruru prompts get my-prompt
+
+# Create a new prompt
+ruru prompts create --name "my-new-prompt" --file .cursorrules
+
+# Update an existing prompt
+ruru prompts update my-prompt --file .cursorrules
+```
+
+## Configuration
+
+Ruru CLI supports multiple configuration methods:
+
+### Environment Variables
+
+```bash
+export RURU_API_URL="https://ruru.ekkyarmandi.com"
+export RURU_API_KEY="your_api_key"
+export RURU_OUTPUT_FORMAT="table"  # table, json, yaml
+export RURU_NO_COLOR="false"
+export RURU_VERBOSE="false"
+```
+
+### Configuration File
+
+Create `~/.ruru/config.yaml`:
+
+```yaml
+api:
+  url: "https://ruru.ekkyarmandi.com"
+  timeout: 30
+
+defaults:
+  location: "./"
+  auto_create_dirs: true
+
+output:
+  format: "table"
+  color: true
+
+cache:
+  enabled: true
+  ttl: 300
+```
+
+### .env File
+
+Create a `.env` file in your project directory:
+
+```env
+RURU_API_URL=http://localhost:8000
+RURU_API_KEY=your_local_api_key
+RURU_OUTPUT_FORMAT=json
+```
+
+## Commands
+
+### Authentication
+
+```bash
+ruru auth login          # Set up API credentials
+ruru auth logout         # Remove stored credentials
+ruru auth status         # Check authentication status
+```
+
+### Prompt Management
+
+```bash
+# List and search
+ruru prompts list                    # List all prompts
+ruru prompts list --tags python,ai  # Filter by tags
+ruru prompts search "query"          # Search prompts
+
+# Get prompts
+ruru prompts get <name>              # Download prompt to file
+ruru prompts get <name> --output -   # Print to stdout
+
+# Create and update
+ruru prompts create --name <name> --file <file>
+ruru prompts update <name> --file <file>
+ruru prompts delete <name>
+
+# Version management
+ruru prompts versions <name>         # List versions
+ruru prompts rollback <name> <version>
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/ekkyarmandi/ruru-cli.git
+cd ruru-cli
+
+# Install with development dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linting
+black .
+isort .
+flake8
+mypy .
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=ruru --cov-report=html
+
+# Run specific test file
+pytest tests/test_client.py
+```
+
+## API Integration
+
+The CLI integrates with the Ruru API. For local development:
+
+1. Start the API server:
+
+   ```bash
+   cd ../api
+   uvicorn app.main:app --reload --port 8000
+   ```
+
+2. Configure CLI for local API:
+   ```bash
+   export RURU_API_URL=http://localhost:8000
+   ```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add tests for your changes
+5. Run the test suite (`pytest`)
+6. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+7. Push to the branch (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📧 Email: me@ekkyarmandi.com
+- 🐛 Issues: [GitHub Issues](https://github.com/ekkyarmandi/ruru-cli/issues)
+- 📖 Documentation: [GitHub Wiki](https://github.com/ekkyarmandi/ruru-cli/wiki)

ruru-0.1.0/pyproject.toml

@@ -0,0 +1,88 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ruru"
+version = "0.1.0"
+description = "A powerful CLI tool for managing and versioning prompts across projects"
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [
+    {name = "Ekky Armandi", email = "me@ekkyarmandi.com"}
+]
+maintainers = [
+    {name = "Ekky Armandi", email = "me@ekkyarmandi.com"}
+]
+keywords = ["prompts", "rules", "ai", "llm", "context", "version-control", "prompt-management"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Text Processing",
+    "Topic :: Utilities",
+]
+requires-python = ">=3.8.1"
+dependencies = [
+    "click>=8.0.0",
+    "httpx>=0.24.0",
+    "rich>=13.0.0",
+    "pyyaml>=6.0",
+    "python-decouple>=3.6",
+    "keyring>=24.0.0",
+    "tqdm>=4.64.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    "pytest-click>=1.1.0",
+    "black>=23.0.0",
+    "isort>=5.12.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "responses>=0.23.0",
+]
+
+[project.scripts]
+ruru = "ruru.main:cli"
+
+[tool.setuptools]
+packages = ["ruru"]
+
+[tool.setuptools.package-data]
+ruru = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "--cov=ruru --cov-report=term-missing --cov-report=html"
+
+[tool.black]
+line-length = 88
+target-version = ['py38']
+include = '\.pyi?$'
+
+[tool.isort]
+profile = "black"
+multi_line_output = 3
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true 

ruru-0.1.0/ruru/__init__.py

@@ -0,0 +1,15 @@
+"""
+Ruru - A powerful CLI tool for managing and versioning prompts across projects.
+
+Ruru helps developers manage, version, and sync prompt files (like .cursorrules)
+across multiple projects with a simple command-line interface.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Ruru Team"
+__email__ = "me@ekkyarmandi.com"
+__license__ = "MIT"
+
+from .main import cli
+
+__all__ = ["cli"]