notifer-cli 1.0.0__tar.gz

notifer_cli-1.0.0/LICENSE

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

notifer_cli-1.0.0/PKG-INFO

@@ -0,0 +1,325 @@
+Metadata-Version: 2.4
+Name: notifer-cli
+Version: 1.0.0
+Summary: Command-line interface for Notifer notification service
+Author-email: Notifer Team <hello@notifer.io>
+License: MIT
+Project-URL: Homepage, https://notifer.io
+Project-URL: Documentation, https://docs.notifer.io
+Project-URL: Repository, https://github.com/nexolab-projects/notifer-cli
+Project-URL: Issues, https://github.com/nexolab-projects/notifer-cli/issues
+Keywords: notifications,cli,pub-sub,push-notifications
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Communications
+Classifier: Topic :: Utilities
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sseclient-py>=1.8.0
+Dynamic: license-file
+
+# Notifer CLI
+
+Command-line interface for [Notifer](https://notifer.io) - simple HTTP-based pub-sub notification service.
+
+## Installation
+
+```bash
+pip install notifer-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/notifer/notifer.git
+cd notifer/cli
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Configure API endpoint
+
+```bash
+# Create config file
+notifer config init
+
+# For production (Notifer cloud)
+notifer config set server https://api.notifer.io
+
+# For local development
+notifer config set server http://localhost:8080
+```
+
+### 2. Publish a message
+
+```bash
+# Simple message
+notifer publish my-topic "Hello World!"
+
+# With title and priority
+notifer publish alerts "Server is down!" \
+  --title "Alert" \
+  --priority 5 \
+  --tags urgent,server
+
+# With markdown
+notifer publish deployments "# Deploy Success\n\n**Status**: ✅" \
+  --priority 4
+```
+
+### 3. Subscribe to messages
+
+```bash
+# Subscribe and print to console
+notifer subscribe my-topic
+
+# Subscribe to multiple topics
+notifer subscribe alerts,deployments
+
+# Save to file
+notifer subscribe my-topic --output messages.jsonl
+```
+
+## Authentication
+
+### Using API Keys (Recommended)
+
+```bash
+# Create API key via web UI or:
+notifer keys create "CI/CD Pipeline" \
+  --scopes publish,topics:read \
+  --email user@example.com \
+  --password yourpassword
+
+# Use API key for publishing
+notifer publish my-topic "Message" --api-key noti_abc123...
+
+# Or save in config
+notifer config set api-key noti_abc123...
+```
+
+### Using Email/Password
+
+```bash
+# Login (stores token in ~/.notifer.yaml)
+notifer login user@example.com
+
+# Publish with stored credentials
+notifer publish my-topic "Message"
+```
+
+## Commands
+
+### Publishing
+
+```bash
+notifer publish <topic> <message> [OPTIONS]
+
+Options:
+  --title TEXT          Message title
+  --priority INTEGER    Priority (1-5, default: 3)
+  --tags TEXT           Comma-separated tags
+  --api-key TEXT        API key for authentication
+  --server TEXT         Override server URL
+```
+
+### Subscribing
+
+```bash
+notifer subscribe <topics> [OPTIONS]
+
+Options:
+  --output PATH         Save messages to file (JSONL format)
+  --since TEXT          Only show messages since timestamp
+  --api-key TEXT        API key for authentication
+  --json                Output raw JSON (no formatting)
+```
+
+### API Keys Management
+
+```bash
+# List API keys
+notifer keys list
+
+# Create new key
+notifer keys create <name> [OPTIONS]
+
+Options:
+  --scopes TEXT         Comma-separated scopes (default: *)
+  --description TEXT    Key description
+  --expires TEXT        Expiration date (ISO format)
+
+# Revoke key
+notifer keys revoke <key-id>
+
+# Delete key
+notifer keys delete <key-id>
+```
+
+### Topics Management
+
+```bash
+# List topics
+notifer topics list
+
+# List your topics
+notifer topics list --mine
+
+# Create topic
+notifer topics create <name> [OPTIONS]
+
+Options:
+  --description TEXT    Topic description
+  --private            Make topic private
+  --discoverable       Make discoverable in browse
+
+# Get topic info
+notifer topics get <name>
+
+# Delete topic
+notifer topics delete <name>
+```
+
+### Configuration
+
+```bash
+# Initialize config file
+notifer config init
+
+# Show current config
+notifer config show
+
+# Set config value
+notifer config set <key> <value>
+
+# Examples:
+notifer config set server https://api.notifer.io  # Production
+notifer config set server http://localhost:8080    # Local dev
+notifer config set api-key noti_abc123...
+```
+
+## Configuration File
+
+The CLI uses `~/.notifer.yaml` for configuration:
+
+```yaml
+# Server settings
+server: https://api.notifer.io  # Production (or http://localhost:8080 for local dev)
+
+# Authentication (choose one)
+api_key: noti_abc123...
+
+# OR email/password (stores JWT token)
+email: user@example.com
+access_token: eyJhbG...
+refresh_token: eyJhbG...
+
+# Default options
+defaults:
+  priority: 3
+  tags: []
+```
+
+## Examples
+
+### CI/CD Integration
+
+```bash
+#!/bin/bash
+# deploy.sh
+
+# Create API key with publish scope
+API_KEY="noti_abc123..."
+
+# Notify on deploy start
+notifer publish deployments "Deploy started for v1.2.3" \
+  --title "Deploy" \
+  --priority 3 \
+  --tags deployment,production \
+  --api-key "$API_KEY"
+
+# Run deployment
+./deploy-script.sh
+
+# Notify on success/failure
+if [ $? -eq 0 ]; then
+  notifer publish deployments "# Deploy Success\n\nVersion **v1.2.3** deployed!" \
+    --priority 4 \
+    --tags deployment,success \
+    --api-key "$API_KEY"
+else
+  notifer publish deployments "Deploy failed!" \
+    --priority 5 \
+    --tags deployment,failure \
+    --api-key "$API_KEY"
+fi
+```
+
+### Monitoring Script
+
+```bash
+#!/bin/bash
+# monitor.sh
+
+# Subscribe to alerts and log to file
+notifer subscribe alerts,errors \
+  --output /var/log/notifer-alerts.jsonl \
+  --api-key noti_abc123...
+```
+
+### GitHub Actions
+
+```yaml
+name: Deploy
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Install Notifer CLI
+        run: pip install notifer-cli
+
+      - name: Notify deploy start
+        run: |
+          notifer publish deployments "Deploy started: ${{ github.sha }}" \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+
+      - name: Deploy
+        run: ./deploy.sh
+
+      - name: Notify success
+        if: success()
+        run: |
+          notifer publish deployments "Deploy successful!" \
+            --priority 4 \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+
+      - name: Notify failure
+        if: failure()
+        run: |
+          notifer publish deployments "Deploy failed!" \
+            --priority 5 \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+```
+
+## License
+
+MIT

notifer_cli-1.0.0/README.md

@@ -0,0 +1,293 @@
+# Notifer CLI
+
+Command-line interface for [Notifer](https://notifer.io) - simple HTTP-based pub-sub notification service.
+
+## Installation
+
+```bash
+pip install notifer-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/notifer/notifer.git
+cd notifer/cli
+pip install -e .
+```
+
+## Quick Start
+
+### 1. Configure API endpoint
+
+```bash
+# Create config file
+notifer config init
+
+# For production (Notifer cloud)
+notifer config set server https://api.notifer.io
+
+# For local development
+notifer config set server http://localhost:8080
+```
+
+### 2. Publish a message
+
+```bash
+# Simple message
+notifer publish my-topic "Hello World!"
+
+# With title and priority
+notifer publish alerts "Server is down!" \
+  --title "Alert" \
+  --priority 5 \
+  --tags urgent,server
+
+# With markdown
+notifer publish deployments "# Deploy Success\n\n**Status**: ✅" \
+  --priority 4
+```
+
+### 3. Subscribe to messages
+
+```bash
+# Subscribe and print to console
+notifer subscribe my-topic
+
+# Subscribe to multiple topics
+notifer subscribe alerts,deployments
+
+# Save to file
+notifer subscribe my-topic --output messages.jsonl
+```
+
+## Authentication
+
+### Using API Keys (Recommended)
+
+```bash
+# Create API key via web UI or:
+notifer keys create "CI/CD Pipeline" \
+  --scopes publish,topics:read \
+  --email user@example.com \
+  --password yourpassword
+
+# Use API key for publishing
+notifer publish my-topic "Message" --api-key noti_abc123...
+
+# Or save in config
+notifer config set api-key noti_abc123...
+```
+
+### Using Email/Password
+
+```bash
+# Login (stores token in ~/.notifer.yaml)
+notifer login user@example.com
+
+# Publish with stored credentials
+notifer publish my-topic "Message"
+```
+
+## Commands
+
+### Publishing
+
+```bash
+notifer publish <topic> <message> [OPTIONS]
+
+Options:
+  --title TEXT          Message title
+  --priority INTEGER    Priority (1-5, default: 3)
+  --tags TEXT           Comma-separated tags
+  --api-key TEXT        API key for authentication
+  --server TEXT         Override server URL
+```
+
+### Subscribing
+
+```bash
+notifer subscribe <topics> [OPTIONS]
+
+Options:
+  --output PATH         Save messages to file (JSONL format)
+  --since TEXT          Only show messages since timestamp
+  --api-key TEXT        API key for authentication
+  --json                Output raw JSON (no formatting)
+```
+
+### API Keys Management
+
+```bash
+# List API keys
+notifer keys list
+
+# Create new key
+notifer keys create <name> [OPTIONS]
+
+Options:
+  --scopes TEXT         Comma-separated scopes (default: *)
+  --description TEXT    Key description
+  --expires TEXT        Expiration date (ISO format)
+
+# Revoke key
+notifer keys revoke <key-id>
+
+# Delete key
+notifer keys delete <key-id>
+```
+
+### Topics Management
+
+```bash
+# List topics
+notifer topics list
+
+# List your topics
+notifer topics list --mine
+
+# Create topic
+notifer topics create <name> [OPTIONS]
+
+Options:
+  --description TEXT    Topic description
+  --private            Make topic private
+  --discoverable       Make discoverable in browse
+
+# Get topic info
+notifer topics get <name>
+
+# Delete topic
+notifer topics delete <name>
+```
+
+### Configuration
+
+```bash
+# Initialize config file
+notifer config init
+
+# Show current config
+notifer config show
+
+# Set config value
+notifer config set <key> <value>
+
+# Examples:
+notifer config set server https://api.notifer.io  # Production
+notifer config set server http://localhost:8080    # Local dev
+notifer config set api-key noti_abc123...
+```
+
+## Configuration File
+
+The CLI uses `~/.notifer.yaml` for configuration:
+
+```yaml
+# Server settings
+server: https://api.notifer.io  # Production (or http://localhost:8080 for local dev)
+
+# Authentication (choose one)
+api_key: noti_abc123...
+
+# OR email/password (stores JWT token)
+email: user@example.com
+access_token: eyJhbG...
+refresh_token: eyJhbG...
+
+# Default options
+defaults:
+  priority: 3
+  tags: []
+```
+
+## Examples
+
+### CI/CD Integration
+
+```bash
+#!/bin/bash
+# deploy.sh
+
+# Create API key with publish scope
+API_KEY="noti_abc123..."
+
+# Notify on deploy start
+notifer publish deployments "Deploy started for v1.2.3" \
+  --title "Deploy" \
+  --priority 3 \
+  --tags deployment,production \
+  --api-key "$API_KEY"
+
+# Run deployment
+./deploy-script.sh
+
+# Notify on success/failure
+if [ $? -eq 0 ]; then
+  notifer publish deployments "# Deploy Success\n\nVersion **v1.2.3** deployed!" \
+    --priority 4 \
+    --tags deployment,success \
+    --api-key "$API_KEY"
+else
+  notifer publish deployments "Deploy failed!" \
+    --priority 5 \
+    --tags deployment,failure \
+    --api-key "$API_KEY"
+fi
+```
+
+### Monitoring Script
+
+```bash
+#!/bin/bash
+# monitor.sh
+
+# Subscribe to alerts and log to file
+notifer subscribe alerts,errors \
+  --output /var/log/notifer-alerts.jsonl \
+  --api-key noti_abc123...
+```
+
+### GitHub Actions
+
+```yaml
+name: Deploy
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Install Notifer CLI
+        run: pip install notifer-cli
+
+      - name: Notify deploy start
+        run: |
+          notifer publish deployments "Deploy started: ${{ github.sha }}" \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+
+      - name: Deploy
+        run: ./deploy.sh
+
+      - name: Notify success
+        if: success()
+        run: |
+          notifer publish deployments "Deploy successful!" \
+            --priority 4 \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+
+      - name: Notify failure
+        if: failure()
+        run: |
+          notifer publish deployments "Deploy failed!" \
+            --priority 5 \
+            --api-key ${{ secrets.NOTIFER_API_KEY }}
+```
+
+## License
+
+MIT

notifer_cli-1.0.0/notifer_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Notifer CLI - Command-line interface for Notifer notification service."""
+
+__version__ = "1.0.0"

notifer_cli-1.0.0/notifer_cli/cli.py

@@ -0,0 +1,47 @@
+"""Main CLI entry point."""
+import click
+from rich.console import Console
+
+from .commands import publish, subscribe, keys, topics, config, auth
+
+console = Console()
+
+
+@click.group()
+@click.version_option(version="1.0.0", prog_name="notifer")
+@click.pass_context
+def cli(ctx):
+    """
+    Notifer CLI - Simple pub-sub notifications from the command line.
+
+    Send and receive notifications, manage API keys, and configure topics.
+
+    \b
+    Examples:
+      # Publish a message
+      notifer publish my-topic "Hello World!"
+
+      # Subscribe to messages
+      notifer subscribe my-topic
+
+      # Manage API keys
+      notifer keys create "CI/CD" --scopes publish
+
+    For more help on a specific command:
+      notifer <command> --help
+    """
+    ctx.ensure_object(dict)
+
+
+# Register command groups
+cli.add_command(publish.publish)
+cli.add_command(subscribe.subscribe)
+cli.add_command(keys.keys)
+cli.add_command(topics.topics)
+cli.add_command(config.config)
+cli.add_command(auth.login)
+cli.add_command(auth.logout)
+
+
+if __name__ == "__main__":
+    cli()