Skip to content

docs: added examples and improved READMEs#15

Merged
deadcode-walker merged 4 commits intomainfrom
docs/examples-and-readmes
Mar 20, 2026
Merged

docs: added examples and improved READMEs#15
deadcode-walker merged 4 commits intomainfrom
docs/examples-and-readmes

Conversation

@deadcode-walker
Copy link
Owner

Summary

Added 6 new examples demonstrating previously uncovered features and rewrote all 5 READMEs with accurate APIs, correct version numbers, and full feature coverage.

New examples

Example Crate Demonstrates
ami_call_tracker.rs asterisk-rs-ami CallTracker, CompletedCall records, background task
agi_ivr.rs asterisk-rs-agi IVR menu, DTMF, AstDB, variables, branching
ari_recording.rs asterisk-rs-ari Channel recording and playback
ari_pending.rs asterisk-rs-ari Race-free PendingChannel origination
ari_websocket_transport.rs asterisk-rs-ari Unified WebSocket transport mode
pbx_dial.rs asterisk-rs Pbx high-level dial, wait_for_answer, CompletedCall

README fixes

  • Root: fixed version numbers, fixed missing .await, fixed AGI handler signature, added feature selection, call tracker, PBX, pending resources, transport modes to capabilities, added 4 example snippets
  • Core: expanded from 16 to 62 lines with all types, event bus, reconnect policy, domain constants
  • AMI: added call tracker section, builder options table, fixed ReconnectPolicy import and defaults
  • AGI: added available commands section (7 category tables), expanded capabilities
  • ARI: fixed AriConfig::builder() to AriConfigBuilder::new(), added transport modes, pending resources, resource handles, outbound WS server, media channel sections

Other

  • Added tracing/tracing-subscriber dev-deps to umbrella crate for pbx_dial example
  • Updated AGENTS.md examples table
  • Added no-inline-tests policy to omp rules

…port, and PBX examples

New examples demonstrating previously uncovered features:
- ami_call_tracker: CallTracker for correlating AMI events into CompletedCall records
- agi_ivr: realistic IVR menu with DTMF, AstDB, variables, branching logic
- ari_recording: channel recording and playback with filtered event subscription
- ari_pending: race-free origination via PendingChannel factory
- ari_websocket_transport: unified WebSocket transport mode with REST and events
- pbx_dial: high-level Pbx abstraction for dial, wait_for_answer, hangup, CDR

Added tracing and tracing-subscriber dev-dependencies to umbrella crate for pbx_dial example.
…coverage

Root README:
- fixed version numbers (0.1 umbrella, 0.4 AMI, 0.2 AGI, 0.4 ARI)
- fixed missing .await on recv() in quick example
- added feature selection section with default-features=false
- added call tracker, PBX, pending resources, transport modes, outbound WS,
  media channel to capabilities
- added four new example snippets (call tracker, AGI IVR, ARI pending, PBX dial)
- fixed AGI handler signature to use native async fn (not Pin<Box<dyn Future>>)
- fixed ARI imports to use actual module paths

Core README:
- expanded from 16 to 62 lines
- listed all error types, event bus types, reconnect policy, credentials,
  and domain constant enums

AMI README:
- added call tracker section with example
- added builder options table with correct defaults
- fixed ReconnectPolicy import path to asterisk_rs_core::config
- fixed timeout default (30s not 10s), ping_interval default (disabled)

AGI README:
- added available commands section organized by category (7 tables)
- expanded capabilities with command count and hangup detection

ARI README:
- fixed AriConfig::builder() to AriConfigBuilder::new()
- added transport modes, race-free resource creation, resource handles,
  outbound WebSocket server, and media channel sections
- expanded capabilities list
@github-actions github-actions bot added documentation Improvements or additions to documentation dependencies Pull requests that update a dependency file ami agi ari core labels Mar 20, 2026
@deadcode-walker deadcode-walker merged commit d9df228 into main Mar 20, 2026
17 of 18 checks passed
This was referenced Mar 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agi ami ari core dependencies Pull requests that update a dependency file documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant