mohr/nexosim
1
0
Fork 0
forked from ROMEO/nexosim
Code Pull Requests Activity

Merge pull request #44 from asynchronics/feature/improve-docgen

Browse Source 
Feature/improve docgen
This commit is contained in:
Serge Barral 2024-09-08 17:40:09 +02:00 committed by GitHub
commit d898fb3f05
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
9 changed files with 27 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.github/workflows/ci.yml vendored
View File

@ -163,3 +163,5 @@ jobs:
- name: Run cargo doc
run: cargo doc --no-deps --all-features --document-private-items
env:
RUSTDOCFLAGS: --cfg docsrs -Dwarnings

2
README.md
View File

@ -72,7 +72,7 @@ asynchronix = "0.2.2"
//
// ┌──────────────┐ ┌──────────────┐
// │ │ │ │
// Input ●─────▶│ multiplier 1 ├─────▶│ multiplier 2 ├─────▶ Output
// Input ●─────►│ multiplier 1 ├─────►│ multiplier 2 ├─────► Output
// │ │ │ │
// └──────────────┘ └──────────────┘
use asynchronix::model::{Model, Output};

4
asynchronix/Cargo.toml
View File

@ -71,6 +71,10 @@ tonic-build = { version = "0.12" }
# `asynchronix_grpc_codegen` flag: regenerate gRPC code from .proto definitions.
unexpected_cfgs = { level = "warn", check-cfg = ['cfg(asynchronix_loom)', 'cfg(asynchronix_grpc_codegen)'] }
[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]
[[test]]
name = "integration"
path = "tests/tests.rs"

2
asynchronix/examples/assembly.rs
View File

@ -15,7 +15,7 @@
//! │ Assembly │
//! │ ┌──────────┐ ┌──────────┐ │
//! PPS │ │ │ coil currents │ │ │position
//! Pulse rate ●───────▶│──▶│ Driver ├───────────────▶│ Motor ├──▶│─────────▶
//! Pulse rate ●───────►│──►│ Driver ├───────────────►│ Motor ├──►│─────────►
//! (±freq)│ │ │ (IA, IB) │ │ │(0:199)
//! │ └──────────┘ └──────────┘ │
//! └──────────────────────────────────────────────┘

10
asynchronix/examples/espresso_machine.rs
View File

@ -12,9 +12,9 @@
//! ┌─────────────────────────────────────────────┐
//! │ (≥0) │
//! │ ┌────────────┐ │
//! └───▶│ │ │
//! └───►│ │ │
//! added volume │ Water tank ├────┐ │
//! Water fill ●───────────────────▶│ │ │ │
//! Water fill ●───────────────────►│ │ │ │
//! (>0) └────────────┘ │ │
//! │ │
//! water sense │ │
@ -22,9 +22,9 @@
//! │ (empty|not empty) │
//! │ │
//! │ ┌────────────┐ ┌────────────┐ │
//! brew time └───▶│ │ command │ │ │
//! Brew time dial ●───────────────────▶│ Controller ├─────────▶│ Water pump ├───┘
//! (>0) ┌───▶│ │ (on|off) │ │
//! brew time └───►│ │ command │ │ │
//! Brew time dial ●───────────────────►│ Controller ├─────────►│ Water pump ├───┘
//! (>0) ┌───►│ │ (on|off) │ │
//! │ └────────────┘ └────────────┘
//! trigger │
//! Brew command ●───────────────┘

2
asynchronix/examples/external_input.rs
View File

@ -11,7 +11,7 @@
//! │ Simulation │
//! ┌────────────┐ ┌────────────┐ │ ┌──────────┐ │
//! │ │ UDP │ │ message │ message │ │ message │ ┌─────────────┐
//! │ UDP Client ├─────────▶│ UDP Server ├──────────▶├─────────▶│ Listener ├─────────▶├──▶│ EventBuffer │
//! │ UDP Client ├─────────►│ UDP Server ├──────────►├─────────►│ Listener ├─────────►├──►│ EventBuffer │
//! │ │ message │ │ │ │ │ │ └─────────────┘
//! └────────────┘ └────────────┘ │ └──────────┘ │
//! └────────────────────────────────┘

12
asynchronix/examples/power_supply.rs
View File

@ -8,22 +8,22 @@
//! ```text
//! ┌────────┐
//! │ │
//! ┌───▶│ Load ├───▶ Power
//! ┌───►│ Load ├───► Power
//! │ │ │
//! │ └────────┘
//! │
//! │ ┌────────┐
//! │ │ │
//! ├───▶│ Load ├───▶ Power
//! ├───►│ Load ├───► Power
//! │ │ │
//! │ └────────┘
//! │
//! │ ┌────────┐
//! ┌──────────┐ voltage▶ │ │ │
//! Voltage setting ●────▶│ │◀────────────┴───▶│ Load ├───▶ Power
//! │ Power │ ◀current │ │
//! ┌──────────┐ voltage► │ │ │
//! Voltage setting ●────►│ │◄────────────┴───►│ Load ├───► Power
//! │ Power │ ◄current │ │
//! │ supply │ └────────┘
//! │ ├───────────────────────────────▶ Total power
//! │ ├───────────────────────────────► Total power
//! └──────────┘
//! ```
use asynchronix::model::Model;

2
asynchronix/examples/stepper_motor.rs
View File

@ -9,7 +9,7 @@
//! ```text
//! ┌──────────┐ ┌──────────┐
//! PPS │ │ coil currents │ │ position
//! Pulse rate ●─────────▶│ Driver ├───────────────▶│ Motor ├──────────▶
//! Pulse rate ●─────────►│ Driver ├───────────────►│ Motor ├──────────►
//! (±freq) │ │ (IA, IB) │ │ (0:199)
//! └──────────┘ └──────────┘
//! ```

10
asynchronix/src/lib.rs
View File

@ -75,7 +75,7 @@
//! ```text
//! ┌────────────┐
//! │ │
//! Input ●───────▶│ Multiplier ├───────▶ Output
//! Input ●───────►│ Multiplier ├───────► Output
//! f64 │ │ f64
//! └────────────┘
//! ```
@ -156,13 +156,13 @@
//! ```text
//! ┌────────────┐
//! │ │
//! ┌──▶│ Delay ├──┐
//! ┌──►│ Delay ├──┐
//! ┌────────────┐ │ │ │ │ ┌────────────┐
//! │ │ │ └────────────┘ │ │ │
//! Input ●──▶│ Multiplier ├───┤ ├──▶│ Delay ├──▶ Output
//! Input ●──►│ Multiplier ├───┤ ├──►│ Delay ├──► Output
//! │ │ │ ┌────────────┐ │ │ │
//! └────────────┘ │ │ │ │ └────────────┘
//! └──▶│ Multiplier ├──┘
//! └──►│ Multiplier ├──┘
//! │ │
//! └────────────┘
//! ```
@ -406,6 +406,8 @@
//! * the [`time`] module discusses in particular the monotonic timestamp format
//! used for simulations ([`time::MonotonicTime`]).
#![warn(missing_docs, missing_debug_implementations, unreachable_pub)]
#![cfg_attr(docsrs, feature(doc_auto_cfg, doc_cfg_hide))]
#![cfg_attr(docsrs, doc(cfg_hide(feature = "dev-hooks")))]
pub(crate) mod channel;
pub(crate) mod executor;