Expand description
Feature-gated facade for nopace’s admission gate and storage backends.
Modules§
Structs§
- Admission
Operation - Prepared admission command.
- Admission
Request - Store command for one admission decision.
- Basis
Points - Integer basis points where
10_000is 100%. - Call
- One physical provider attempt and all quota claims it consumes.
- Call
Name - Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Claim
- One quota budget consumed by a physical provider attempt.
- Claim
Key - Claim
Label - Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Completion
- Store command that completes a permit and applies feedback.
- Completion
Operation - Prepared completion command.
- Decision
Record - Feedback
- Provider feedback applied when a permit is completed.
- Feedback
Builder - Builder for validated provider feedback.
- Learned
Remaining - Lease
Renewal - Store command that extends a concurrency lease.
- Lease
State - Limit
Headroom - Current availability for one claim/limit pair.
- LimitId
- Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Limit
Ref - A claim/limit pair that constrained admission.
- Memory
Store - Niceness
- Request priority where
0is most important and19is background. - Observed
- Operation value plus feedback that should be stored on completion.
- Pace
- Configured admission gate for one shared quota scope.
- Pace
Builder - Builder for
Pace. - Partition
Key - Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Permit
- Granted permit. Must be completed with feedback.
- Permit
Record - Policy
- Named collection of limits and priority headroom.
- Policy
Fingerprint - Policy
Id - Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Priority
Policy - Priority headroom policy.
- Priority
Policy Builder - Builder for
PriorityPolicy. - Registry
Admission - Admission command without full policy bodies for remote registries.
- Renewal
Operation - Prepared lease-renewal command.
- Reset
Report - Retention
- Retention horizon for replay/idempotency records.
- Scope
Key - Stable identifier, 1-128 bytes, using ASCII letters, digits, and
-._:/. - Scope
State - Durable state for one scope.
- State
Key - Store
Snapshot - System
Clock - Real wall-clock implementation used by default.
- Temporary
State - Timed
Completion - Timed
Constraint - Timed
Renewal
Enums§
- Acquire
Error - Errors returned by admission and waiting.
- Admission
- One-shot admission result.
- Build
Error - Errors returned while building a
Pace. - Completion
Result - Result of applying a completion command.
- Eligibility
- Admission recheck timing.
- Feedback
Error - Errors returned while building provider feedback.
- Lease
Renewal Result - Result of applying a lease-renewal command.
- Limit
- One quota rule inside a policy.
- Limit
State - Policy
Error - Errors returned while constructing policies and limits.
- RunError
- Errors returned by
run,run_observed, andexecute. - Signal
- One feedback signal learned from provider responses.
- Store
Decision - Store decision for one admission request.
- Store
Peek - Read-only headroom response.
- Store
Rejection - Rejections returned by the store algorithm.
- Validation
Error - Errors returned when public identifiers or numeric wrappers are invalid.
- Window
- Time window used by fixed-window limits.
Constants§
- ALGORITHM_
VERSION - CLOCK_
SKEW_ ALLOWANCE - How far past the current horizon a record may claim to live before it is read as having been stamped under an older, longer retention.
- WIRE_
VERSION - Wire format for store commands.
Traits§
- Clock
- Clock used by
Pacefor admission timestamps and sleeps. - Request
- Typed request wrapper for SDK calls.
- Store
- Storage backend contract.
Functions§
- collect_
at - Expires replay records, permits, learned constraints and dead leases.
- credential_
fingerprint - Produces a stable, keyed, domain-separated identifier for a credential.
- decide_
at - duration_
millis - finish_
at - peek_at
- renew_
at - reset_
policy - snapshot_
at - success
- Convenience helper for infallible successful observed operations.
- unix_
millis - Current Unix epoch milliseconds from the system clock.
Type Aliases§
- Attempt
- Result shape for operations that return explicit provider feedback.
- Unix
Millis - Milliseconds since the Unix epoch.