refactor: remove admission primitives

CHANGELOG.md

@@ -8,12 +8,12 @@ All notable changes to this project will be documented in this file.
 
 ### New features
 
-* Add `admission::PriorityShare` to combine shared-capacity priority thresholds with fair sharing among owners at the same priority.
 * Add an opt-in `asyncband::blocking::FutureExt` bridge with `block_on` and `wait_timeout` methods for waiting on runtime-agnostic futures from synchronous code.
 
 ### Breaking changes
 
 * Gate all exported primitives behind opt-in Cargo features and enable no features by default; downstream dependencies must explicitly enable the APIs they use.
+* Remove `admission::FairShare` and its `admission` Cargo feature from the feature set.
 * Remove the `asyncband::atomicbox` module and its `AtomicBox` and `AtomicOptionBox` types from the public API.
 * Rename `oneshot::Sender::is_closed` and `oneshot::Receiver::is_closed` to `is_disconnected`.
 * Raise the minimum supported Rust version from 1.85.0 to 1.86.0.

README.md

@@ -32,26 +32,24 @@ Asyncband is a runtime-agnostic library providing essential synchronization prim
 
 The crate enables no primitives by default. Categories describe each primitive's primary purpose and do not add another module level, so public paths remain concise, such as `asyncband::mutex` and `asyncband::once::OnceCell`.
 
-| Category                | Primitive                                                                                    | Feature        | Purpose                                                                 |
-| ----------------------- | -------------------------------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------- |
-| Shared state            | [`Mutex`](https://docs.rs/asyncband/*/asyncband/mutex/struct.Mutex.html)                     | `mutex`        | Protect shared data with asynchronous mutual exclusion.                 |
-|                         | [`RwLock`](https://docs.rs/asyncband/*/asyncband/rwlock/struct.RwLock.html)                  | `rwlock`       | Allow multiple readers or one writer.                                   |
-|                         | [`Condvar`](https://docs.rs/asyncband/*/asyncband/condvar/struct.Condvar.html)               | `condvar`      | Wait for notifications while releasing a mutex.                         |
-| One-time initialization | [`Once`](https://docs.rs/asyncband/*/asyncband/once/struct.Once.html)                        | `once`         | Run asynchronous initialization exactly once.                           |
-|                         | [`OnceCell`](https://docs.rs/asyncband/*/asyncband/once/struct.OnceCell.html)                | `once-cell`    | Initialize and store one asynchronous value.                            |
-|                         | [`OnceMap`](https://docs.rs/asyncband/*/asyncband/once/struct.OnceMap.html)                  | `once-map`     | Initialize and store one value per key.                                 |
-| Task coordination       | [`Barrier`](https://docs.rs/asyncband/*/asyncband/barrier/struct.Barrier.html)               | `barrier`      | Wait until all participants reach a synchronization point.              |
-|                         | [`Latch`](https://docs.rs/asyncband/*/asyncband/latch/struct.Latch.html)                     | `latch`        | Wait until a one-way countdown completes.                               |
-|                         | [`WaitGroup`](https://docs.rs/asyncband/*/asyncband/waitgroup/struct.WaitGroup.html)         | `waitgroup`    | Wait for a dynamic group of tasks to finish.                            |
-|                         | [`shutdown`](https://docs.rs/asyncband/*/asyncband/shutdown/)                                | `shutdown`     | Coordinate shutdown signals and completion.                             |
-| Channels                | [`oneshot::channel`](https://docs.rs/asyncband/*/asyncband/oneshot/fn.channel.html)          | `oneshot`      | Send one value between two tasks.                                       |
-|                         | [`mpsc::bounded`](https://docs.rs/asyncband/*/asyncband/mpsc/fn.bounded.html)                | `mpsc`         | Send values from multiple producers through a bounded channel.          |
-|                         | [`mpsc::unbounded`](https://docs.rs/asyncband/*/asyncband/mpsc/fn.unbounded.html)            | `mpsc`         | Send values from multiple producers through an unbounded channel.       |
-|                         | [`broadcast::overflow`](https://docs.rs/asyncband/*/asyncband/broadcast/overflow/)           | `broadcast`    | Broadcast values and report when slow receivers miss overwritten items. |
-| Workload control        | [`Semaphore`](https://docs.rs/asyncband/*/asyncband/semaphore/struct.Semaphore.html)         | `semaphore`    | Control concurrent access with permits.                                 |
-|                         | [`FairShare`](https://docs.rs/asyncband/*/asyncband/admission/struct.FairShare.html)         | `admission`    | Fairly share bounded concurrency across keys.                           |
-|                         | [`PriorityShare`](https://docs.rs/asyncband/*/asyncband/admission/struct.PriorityShare.html) | `admission`    | Reserve shared capacity by priority while preserving per-key fairness.  |
-|                         | [`Group`](https://docs.rs/asyncband/*/asyncband/singleflight/struct.Group.html)              | `singleflight` | Coalesce concurrent calls for the same key.                             |
+| Category                | Primitive                                                                            | Feature        | Purpose                                                                 |
+| ----------------------- | ------------------------------------------------------------------------------------ | -------------- | ----------------------------------------------------------------------- |
+| Shared state            | [`Mutex`](https://docs.rs/asyncband/*/asyncband/mutex/struct.Mutex.html)             | `mutex`        | Protect shared data with asynchronous mutual exclusion.                 |
+|                         | [`RwLock`](https://docs.rs/asyncband/*/asyncband/rwlock/struct.RwLock.html)          | `rwlock`       | Allow multiple readers or one writer.                                   |
+|                         | [`Condvar`](https://docs.rs/asyncband/*/asyncband/condvar/struct.Condvar.html)       | `condvar`      | Wait for notifications while releasing a mutex.                         |
+| One-time initialization | [`Once`](https://docs.rs/asyncband/*/asyncband/once/struct.Once.html)                | `once`         | Run asynchronous initialization exactly once.                           |
+|                         | [`OnceCell`](https://docs.rs/asyncband/*/asyncband/once/struct.OnceCell.html)        | `once-cell`    | Initialize and store one asynchronous value.                            |
+|                         | [`OnceMap`](https://docs.rs/asyncband/*/asyncband/once/struct.OnceMap.html)          | `once-map`     | Initialize and store one value per key.                                 |
+| Task coordination       | [`Barrier`](https://docs.rs/asyncband/*/asyncband/barrier/struct.Barrier.html)       | `barrier`      | Wait until all participants reach a synchronization point.              |
+|                         | [`Latch`](https://docs.rs/asyncband/*/asyncband/latch/struct.Latch.html)             | `latch`        | Wait until a one-way countdown completes.                               |
+|                         | [`WaitGroup`](https://docs.rs/asyncband/*/asyncband/waitgroup/struct.WaitGroup.html) | `waitgroup`    | Wait for a dynamic group of tasks to finish.                            |
+|                         | [`shutdown`](https://docs.rs/asyncband/*/asyncband/shutdown/)                        | `shutdown`     | Coordinate shutdown signals and completion.                             |
+| Channels                | [`oneshot::channel`](https://docs.rs/asyncband/*/asyncband/oneshot/fn.channel.html)  | `oneshot`      | Send one value between two tasks.                                       |
+|                         | [`mpsc::bounded`](https://docs.rs/asyncband/*/asyncband/mpsc/fn.bounded.html)        | `mpsc`         | Send values from multiple producers through a bounded channel.          |
+|                         | [`mpsc::unbounded`](https://docs.rs/asyncband/*/asyncband/mpsc/fn.unbounded.html)    | `mpsc`         | Send values from multiple producers through an unbounded channel.       |
+|                         | [`broadcast::overflow`](https://docs.rs/asyncband/*/asyncband/broadcast/overflow/)   | `broadcast`    | Broadcast values and report when slow receivers miss overwritten items. |
+| Workload control        | [`Semaphore`](https://docs.rs/asyncband/*/asyncband/semaphore/struct.Semaphore.html) | `semaphore`    | Control concurrent access with permits.                                 |
+|                         | [`Group`](https://docs.rs/asyncband/*/asyncband/singleflight/struct.Group.html)      | `singleflight` | Coalesce concurrent calls for the same key.                             |
 
 ## Installation
 

asyncband/Cargo.toml

@@ -38,7 +38,6 @@ rustdoc-args = ["--cfg", "docsrs"]
 [features]
 default = []
 
-admission = []
 barrier = []
 blocking = []
 broadcast = []