ASIMOV.rs: State Management

This package is part of ASIMOV.rs, a polyglot development platform for trustworthy neurosymbolic machine intelligence.

[Features] | [Prerequisites] | [Installation] | [Examples] | [Reference] | [Development]

✨ Features

• Defines flow-based program patterns for refining data into knowledge.
• Implements a module system enabling an ecosystem of modules.
• Enables dataflow systems through reusable components called blocks.
• Compatible with the inventory of dataflow blocks provided by Flows.rs.
• Built on the dataflow primitives provided by the Async-Flow crate.
• Supports opting out of any feature using comprehensive feature flags.
• Adheres to the Rust API Guidelines in its naming conventions.
• Cuts red tape: 100% free and unencumbered public domain software.

🛠️ Prerequisites

• Rust 1.93+ (2024 edition)

⬇️ Installation

Installation via Cargo

cargo add asimov-directory

Installation in Cargo.toml

[dependencies]
asimov-directory = { version = "25" }

Alternatively, enable only specific features:

[dependencies]
asimov-directory = { version = "25", default-features = false, features = ["tracing"] }

👉 Examples

Importing the Library

use asimov_directory::*;

Printing Local Paths

// cargo run --package asimov-directory --example print_paths

use asimov_directory::fs::StateDirectory;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let asimov_dir = StateDirectory::home()?;
    println!("{}", asimov_dir); // "$HOME/.asimov" on Unix
    println!("{}", asimov_dir.configs()?); // "$HOME/.asimov/configs"
    println!("{}", asimov_dir.modules()?); // "$HOME/.asimov/modules"
    println!("{}", asimov_dir.programs()?); // "$HOME/.asimov/libexec"
    Ok(())
}

Listing Installed Modules

// cargo run --package asimov-directory --example list_modules

use asimov_directory::{ModuleNameIterator, fs::StateDirectory};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let modules = StateDirectory::home()?.modules()?;
    let mut module_names = modules.iter_installed().await?;
    while let Some(module_name) = module_names.next().await {
        println!("{}", module_name);
    }
    Ok(())
}

📚 Reference

docs.rs/asimov-directory

Packages

Package	Crate	Docs
asimov-account
asimov-agent
asimov-cache
asimov-cloud
asimov-config
asimov-construct
asimov-core
asimov-credit
asimov-dataset
asimov-directory
asimov-env
asimov-flow
asimov-graph
asimov-huggingface
asimov-id
asimov-installer
asimov-kb
asimov-ledger
asimov-module
asimov-nexus
asimov-ontology
asimov-patterns
asimov-platform
asimov-prompt
asimov-protocol
asimov-proxy
asimov-registry
asimov-repository
asimov-runner
asimov-runtime
asimov-sdk
asimov-server
asimov-snapshot
asimov-token
asimov-universe
asimov-vault

Glossary

• System: A collection of blocks that are connected together. Systems are the top-level entities in dataflow programs.

• Block: An encapsulated system component that processes messages. Blocks are the autonomous units of computation in a system.

• Port: A named connection point on a block that sends or receives messages. Ports are the only interfaces through which blocks communicate with each other.

• Message: A unit of data that flows between blocks in a system, from port to port. Any Rust type that implements the Send + Sync + 'static traits can be used as a message.

👨‍💻 Development

git clone https://github.com/asimov-platform/asimov.rs.git