{"id":25198028,"url":"https://github.com/danedens/omnispindle","last_synced_at":"2025-04-04T17:17:25.311Z","repository":{"id":149879734,"uuid":"376904637","full_name":"DanEdens/Omnispindle","owner":"DanEdens","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-03T23:30:40.000Z","size":38,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-04T00:26:05.782Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DanEdens.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-14T17:27:42.000Z","updated_at":"2025-04-03T23:30:44.000Z","dependencies_parsed_at":"2025-02-10T02:40:35.250Z","dependency_job_id":"ae37adff-7070-4e3a-869b-33e679e7fc43","html_url":"https://github.com/DanEdens/Omnispindle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanEdens%2FOmnispindle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanEdens%2FOmnispindle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanEdens%2FOmnispindle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanEdens%2FOmnispindle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DanEdens","download_url":"https://codeload.github.com/DanEdens/Omnispindle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247217219,"owners_count":20903009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-10T02:40:33.177Z","updated_at":"2025-04-04T17:17:25.305Z","avatar_url":"https://github.com/DanEdens.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Omnispindle 🌀\n\n**Your Information Conductor for the Madness_Interactive Ecosystem**\n\nWelcome to **Omnispindle**\n\n\n## Omnispindle Integration\n\nSwarmonomicon now integrates with [Omnispindle](../Omnispindle), a tool for conducting information via MQTT in the Madness_Interactive ecosystem.\n\nThe `omnispindle` module provides an `OmniSpindle` struct that wraps the core Omnispindle functionality:\n\n- Connecting to an MQTT broker\n- Publishing messages to a topic\n- Subscribing to a topic\n- Receiving messages from subscribed topics\n\n### Usage\n\n```rust\nuse swarmonomicon::omnispindle::{OmniSpindle, MqttConfig};\n\nlet config = MqttConfig {\n    host: \"localhost\".to_string(), \n    port: 1883,\n    client_id: \"swarmonomicon\".to_string(),\n};\n\nlet omnispindle = OmniSpindle::new(config)?;\n\nomnispindle.subscribe(\"swarmonomicon/test\")?;\nomnispindle.publish(\"swarmonomicon/test\", \"Hello, Swarmonomicon!\", true)?;\n\nlet msg = omnispindle.receive_message()?;\nprintln!(\"Received: {}\", msg);\n```\n\nThis integration allows Swarmonomicon to seamlessly interact with the MQTT bus used by other tools in the Madness_Interactive ecosystem.\n\n\n## Installation 🔧\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/DanEdens/Omnispindle\ncd Omnispindle\n\n# Build Rust binary\ncargo build --release\n\n# Install Python package (optional)\npip install .\n\n# Add CLI command to PATH (Linux/Mac)\necho 'export PATH=\"$PATH:$(pwd)/target/release\"' \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n```powershell\nREM Clone the repository\ngit clone https://github.com/DanEdens/Omnispindle\ncd Omnispindle\n\nREM Build Rust binary\ncargo build --release\n\nREM Install Python package (optional)\npip install .\n\nREM Add CLI command to PATH (Windows)\nsetx PATH \"%PATH%;%cd%\\target\\release\"\n```\n\n### Environment Variables\n\n- `AWSIP`: MQTT broker host (default: \"localhost\")\n- `AWSPORT`: MQTT broker port (default: 1883)\n- `DENA`: Client ID (default: \"omnispindle\")\n\n## Usage 🚀\n\n### Command Line Interface\n\n```bash\n# Get a variable\nomnispindle get --name \u003cname\u003e --topic \u003ctopic\u003e\n\n# Set a variable\nomnispindle set --name \u003cname\u003e --value \u003cvalue\u003e [--retain]\n\n# Subscribe to a topic\nomnispindle subscribe --topic \u003ctopic\u003e --path \u003coutput_path\u003e\n```\n\n\u003c!-- ### Python API\n\n```python\nfrom omnispindle import MqttClient\n\n# Create client\nclient = MqttClient(host=\"localhost\", port=1883, client_id=\"my-client\")\n\n# Publish message\nclient.publish(\"my/topic\", \"Hello, World!\", retain=True)\n\n# Subscribe to topic\nclient.subscribe(\"my/topic\")\n``` --\u003e\n\n## Development 🛠️\n\n### Building\n\n```bash\n# Build Rust binary\ncargo build\n\n# Run tests\ncargo test\n\n```\n\u003c!-- # # Build Python package --\u003e\n\u003c!-- # maturin develop --\u003e\n\n### Project Structure\n\n```\nOmnispindle/\n├── src/                    # Rust source code\n│   ├── main.rs            # CLI entry point\n│   ├── lib.rs             # Core functionality\n│   ├── mqtt/              # MQTT implementation\n│   └── commands/          # CLI commands\n├── python/                # Python bindings\n├── scripts/\n├── tests/\n└── README.md\n```\n\n## Contributing 🤝\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanedens%2Fomnispindle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanedens%2Fomnispindle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanedens%2Fomnispindle/lists"}