8000 GitHub - Jitpomi/dogrs: A modular Rust framework with multi-tenant services, hooks, and pluggable storage — built to avoid stack lock-in. · GitHub
[go: up one dir, main page]

Skip to content
JitpomiPublic

About

A modular Rust framework with multi-tenant services, hooks, and pluggable storage — built to avoid stack lock-in.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

DogRS

A modular Rust framework for services, hooks, tenant context and pluggable transports. Write a service once and expose it through HTTP, gRPC, a CLI or Iroh.

This checkout prepares the 0.4.0 API. It includes breaking changes from the published 0.1.x crates; changing this repository does not publish new crates.io versions. Read the 0.4.0 release notes and earlier migration notes before updating an app.

S3 security notice

The checkout contains a temporary AWS SigV4a dependency fix while retaining Multi-Region Access Point signing. Crates.io consumers do not inherit this patch. Read the status, application workaround and release requirements.

Start here

cargo run -p transport-demo -- http
# Or: cargo run -p transport-demo -- grpc
# Or: cargo run -p transport-demo -- cli

The quickstart includes requests for each mode and requires no database or credentials. Transport documentation explains server composition and Iroh's shared endpoint support.

Workspace

Crate Purpose
dog-core Services, hooks, application builder and explicit tenant context
dog-transport HTTP/Tower, gRPC/Tonic, NDJSON CLI, Iroh and HTTP streaming adapters
dog-axum Deprecated compatibility wrapper; migrate to dog-transport
dog-auth Authentication strategies and typed JWT access/refresh verification
dog-auth-local Password authentication and password protection hooks
dog-auth-oauth Provider-verified OAuth identities and authorization-code support
dog-typedb TypeDB queries, transactions and atomic schema loading
dog-queue Typed jobs, persistent ledgers and broker integrations
dog-blob Blob storage and media utilities
dog-schema, dog-schema-macros, dog-schema-validator Schemas and runtime validation

A tenant context routes an operation; it does not authenticate or authorize the caller. Applications must install authentication and authorization hooks and derive allowed tenants from verified identity. Configure public TLS, request concurrency and deployment limits in the hosting server. See the release notes for the tested scope and remaining application responsibilities.

Queues

PostgreSQL, Redis and NATS JetStream are persistent job ledgers. RabbitMQ, both Kafka clients, AWS SQS and Google Pub/Sub operate with a durable ledger and broker wakeup notifications. Memory is available for tests and ephemeral work. See the queue guide for the API, capacity limits and migration.

Development

All DogRS applications follow the standard application structure, including examples and generated apps. The convention separates application composition, hooks, channels and service modules without choosing a technology stack.

cargo fmt --all -- --check
cargo test --workspace --all-targets --locked
cargo test --workspace --doc --locked
cargo clippy --workspace --all-targets --locked -- -D warnings

CI also checks transport feature combinations, JWT builds with and without PEM support, TypeDB 3.13.6, persistent queues and local broker/emulator integrations. Cloud IAM, provider quotas and deployment-specific TLS configuration are not emulator-tested.

See the example coverage and run guide for applications in dog-examples/. auth-demo has a browser-bound OAuth flow with an in-memory demonstration session store; multi-instance deployments need shared session storage. Example apps are not published as library crates.

Built by JITPOMI.

About

A modular Rust framework with multi-tenant services, hooks, and pluggable storage — built to avoid stack lock-in.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0