Changelog#
All notable changes to this project are and will be documented in this file.
This project uses Semantic Versioning when I feel like it.
Summary#
Tests#
60% coverage, 97 tests
Versions#
[1.3]#
[1.3.0] - 2026-09-10#
Changed all extras to dependency groups.
[1.2]#
[1.2.4] - 2026-09-06#
Upgraded to Python 3.15.0rc2.
[1.2.3] - 2026-08-31#
This changelog is getting frustrating to maintain.
[1.2.2] - 2026-08-29#
Again, some workflow changes.
[1.2.1] - 2026-08-25#
Various workflows.
[1.2.0] - 2026-08-19#
Started using Zizmor.
[1.1]#
Breaking changes: There shouldn’t be any, but I made a lot.
[1.1.4] - 2026-08-18#
Pinned GitHub workflow action usages by hashes; some workflow enhancements.
[1.1.3] - 2026-08-13#
Switched from detect-secrets to betterleaks; added asyncutils bug subcommand.
[1.1.2] - 2026-08-03#
Some bug fixes and moves around submodules.
[1.1.1] - skipped#
Switched from pre-commit to prek; removed pre-commit.ci step and replaced with a prek workflow.
[1.1.0] - 2026-07-11#
Semantic versioning be damned! No one uses this project anyway.
[1.0]#
Breaking changes:
Declared end of life for all beta versions.
Included all the symbols listed in the previous section in the public API.
[1.0.2] - skipped#
Added more tests; mangled private attributes in multiple classes; made some refactors; implemented iters.group_from, iters.awindowed_complete,
iters.aall_unique, iters.anth_product, iters.anth_permutation, iters.anth_combination_with_replacement.
[1.0.1] - 2026-06-30#
Implemented util.evaluate_and_return, iters.awrapf, and exceptions.ignore_warnings; added reject_cb and await_cb parameters to
iters.aguessmax and iters.aguessmin; added yield_sentinel keyword argument to util.aiter_from_f.
[1.0.0] - 2026-06-26; first stable version#
Added some tests; enabled some pydocstyle lint rules; refactored internal modules to avoid importing asyncio to show the help message and library version; moved warnings badge generation to slower test run; switched back to codecov due to pricing; integrated spelling checker.
Below versions are unstable#
[0.9]#
Breaking changes:
Declared end of life for all alpha versions.
Changed version shelving and unshelving schema.
Finalized the following top level objects:
Constants:
__version__
__hexversion__
submodules_map
preloaded_submodules
console_preloaded_submodules
Functions:
time_since_boot
Declared the following submodules and symbols as part of the public API:
altlocks
Classes:
CircuitBreaker
DynamicThrottle
Releasing
ResourceGuard
StatefulBarrier
UniqueResourceGuard
base
Classes:
EventLoop (context manager)
Functions:
adisembowel
adisembowel_left
aenumerate
aiter_to_gen
collect
collect_into
drop
iter_to_agen
safe_cancel_batch
sleep_forever
take
Awaitables:
dummy_task
yield_to_event_loop
buckets
Classes:
LeakyBucket
TokenBucket
channels
Classes:
EventBus
Observable
Rendezvous
cli
Functions:
run
compete
Functions:
convert_to_coro_iter
enhanced_gather
enhanced_staggered_race
first_completed
multi_winner_race_with_callback
race_with_callback
config
Classes:
Debugging
Executor
Functions:
get_past_logs
set_logger_level
Configuration values:
basic_repl
debug
loaded_all
logging_to
max_memory_errors
pdb
silent
console
Classes:
AsyncUtilsConsole
ConsoleBase
constants
Classes:
SentinelBase
Constants:
EXECUTORS_FROZENSET
POSSIBLE_EXECUTORS
RECIPROCAL_E
Sentinels:
RAISE
context
Classes:
Context
LocalContext (context manager)
NonReusableLocalContext (context manager)
Constants:
all_contextual_consts
… (every constant in the
all_contextual_constsfrozenset)
Functions:
getcontext
setcontext
events
Classes:
SingleWaiterEventWithValue
EventWithValue
exceptions:
Classes:
ref
IgnoreErrors
WarningToError
Constants:
CRITICAL
Context managers (ignore_*):
ignore_all
ignore_noncritical
ignore_typical
ignore_stop_iteration
ignore_stop_async_iteration
ignore_value_errors
ignore_type_errors
Exception types:
Critical
StateCorrupted
VersionError
VersionConversionError
VersionNormalizerMissing
VersionCorrupted
VersionValueError
VersionNormalizerTypeError
VersionNormalizerFault
BulkheadError
BulkheadFull
BulkheadShutDown
PoolError
PoolFull
PoolShutDown
RateLimitExceeded
BusError
BusTimeout
BusShutDown
BusStatsErrors
BusPublishingError
CircuitBreakerError
CircuitHalfOpen
CircuitOpen
EventValueError
FutureCorrupted
MaxIterationsError
Deadlock
ResourceBusy
ItemsExhausted
LockForceRequest
PasswordQueueError
PasswordRetrievalError
GetPasswordRetrievalError
PutPasswordRetrievalError
ForbiddenOperation
PasswordError
WrongPassword
WrongPasswordType
PasswordMissing
GetPasswordMissing
PutPasswordMissing
Functions:
unnest
unnest_reverse
potent_derive
prepare_exception
raise_exc
exception_occurred
wrap_exc
unwrap_exc
func
Classes:
RateLimited
Functions:
areduce
discard_retval
to_sync
to_async
to_sync_from_loop
aiter_from_f
afcopy
iterf
acompose
every
everymethod
timer
retry
throttle
debounce
measure
measure2
benchmark
star
unstar
futures
Classes:
AsyncCallbacksFuture
AsyncCallbacksTask
TimeAwareAsyncCallbacksFuture
TimeAwareAsyncCallbacksTask
TimeAwareFuture
TimeAwareTask
TimeAwareUniqueCallbacksFuture
TimeAwareUniqueCallbacksTask
UniqueCallbacksFuture
UniqueCallbacksTask
iotools
Classes:
AsyncReadWriteCouple
MemoryMappedIOManager
Functions:
double_ended_text_pipe
double_ended_binary_pipe
iterclasses
Classes:
AChain
APeekable
ABucket
iters
Functions:
… (There are too many of these, so just refer to the IDE autocomplete or read the stub)
locks
Classes:
AdvancedRateLimit
DynamicBoundedSemaphore
PrioritySemaphore
KeyedCondition
RLock
PriorityLock
PriorityRLock
MultiCountDownLatch
locksmiths
Classes:
LocksmithBase
Enumerations:
ForceResult
RecognitionResult
Functions:
succeeded
misc
Classes:
CallbackAccumulator
StateMachine
CacheWithBackgroundRefresh
Functions:
gather_with_limited_concurrency
mixins
Interfaces/Mixins:
AwaitableMixin
AsyncContextMixin
ExecutorRequiredAsyncContextMixin
LockMixin
LockWithOwnerMixin
EventMixin
networking
Classes:
LineProtocol
LFProtocol
CRLFProtocol
CRProtocol
SocketTransport
pools
Classes:
AdvancedPool
ConnectionPool
processors
Classes:
BoundedBatchProcessor
BatchProcessor
Bulkhead
properties
Classes:
AsyncPropertyBase
ConcurrentAsyncProperty
LazyAsyncProperty
RWLockedAsyncProperty
Enumerations:
Deleters
queues
Interfaces:
PotentQueueBase
Classes:
SmartQueue
SmartLifoQueue
SmartPriorityQueue
UserPriorityQueue
Functions:
password_queue
Context managers (ignore_*):
ignore_qshutdown
ignore_qempty
ignore_qfull
ignore_qerrs
rwlocks
Classes:
RWLock
FairRWLock
ReadPreferredRWLock
WritePreferredRWLock
PriorityRWLock
FairPriorityRWLock
WritePreferredPriorityRWLock
AgingRWLock
CoercedMethod
signals
Functions:
wait_for_signal
tools
Functions:
loadf
json_to_argv
json_to_argstr
argv_to_json
argstr_to_json
get_cfg_json_format
print_cfg_json_format
get_cmd_help
print_cmd_help
util
Context managers (ignore_*):
ignore_cancellation
Context manager classes:
anullcontext
Functions:
aawcmf2dcmf
aawcmf2dcmff
dcm
get_future
make_task_factory
new_eager_tasks
sync_await
lockf
done_evt
done_fut
locked_lock
dualcontextmanager
semaphore
safe_cancel
transient_block
transient_block_from_loop
wrap_in_coro
atruthify
afalsify
anullify
avalify
version
Classes:
VersionInfo
VersionDelta
Functions:
normalize
normalize_allow_unimplemented
register_normalizer
unregister_normalizer
dispatch_normalizer
autogenerate_normalizers
[0.9.16] - 2026-06-22#
Greatly improved futures and properties functionality.
[0.9.15] - 2026-06-17#
Committed uv.lock to version control; replaced AsyncGenerator with AsyncGeneratorType and Generator with GeneratorType where appropriate.
[0.9.14] - 2026-06-13#
Refactored base.EventLoop; improved submodule logging and __dir__ method handling.
[0.9.13] - 2026-06-12#
Reorganized the project structure; added a test; clarified documentation.
[0.9.12] - 2026-06-10#
Fixed all warnings in Sphinx nitpicky builds; declared free-threaded support as standard; unpinned the exact beta of Python 3.15.
[0.9.11] - 2026-06-04#
Upgraded to Python 3.15.0b2; added experimental GraalPy and free-threaded support.
[0.9.10] - 2026-05-29#
Integrated CodeQL fully.
[0.9.9] - 2026-05-26#
Added more tests and more badges to the readme; removed codecov upload step superseded by GitHub Code Quality.
[0.9.8] - 2026-05-23#
Eliminated instances of bare Any used to annotate arguments.
[0.9.7] - 2026-05-21#
Added locksmiths submodule.
[0.9.6] - 2026-05-19#
Re-committed .markdownlint.json to version control; documentation nears completion; used GitHub Actions for page deployment.
[0.9.5] - 2026-05-17#
Some bugfixes; began deployment to GitHub Pages.
[0.9.4] - 2026-05-15#
Fixed workflows once more and integrated uv more fully; migrated from mypy to ty, removing stubtest step.
[0.9.3] - 2026-05-11#
Added some tests; changed symbolic links to a copy step in the Read the Docs build, which is more reliable; fixed codecov trigger; added sphinx-copybutton as an optional dependency.
[0.9.2] - 2026-05-07#
Created symbolic links in docs directory linking to root .md files; fixed some bugs; respected some more environment variables and documented this behaviour; completed benchmarks; added myst_parser as an optional dependency; bumped some dependencies; added some examples.
[0.9.1] - 2026-05-01#
Declared full support for python[ -m] asyncutils an entry point; patched function, method and class method signatures where appropriate; added
-P/–pdb option; switched to furo theme.
[0.9.0] - 2026-04-27#
Added some iteration, functional programming and context management utilities.
Below versions have reached EOL#
[0.8]#
Breaking changes:
Created GitHub repository
[0.8.28] - 2026-04-24#
Rewrote submodules loading mechanism; removed fragile relative imports; compressed asyncio and sibling module imports to avoid overhead.
[0.8.27] - 2026-04-21#
Added more tests and fixed stubtest errors; abolished slow markdownlint step in pre-commit; various API additions.
[0.8.26] - 2026-04-18#
Squashed many bugs and stub inaccuracies; integrated stubtest; simplified workflows; added more contextual constants.
[0.8.25] - 2026-04-14#
Created issue templates.
[0.8.24] - 2026-04-10#
Created AI_USAGE_POLICY.md.
[0.8.23] - 2026-04-09#
Integrated pre-commit CI.
[0.8.22] - 2026-04-05#
Created the audit events table.
[0.8.21] - 2026-04-01#
Organized badges into table; started using mypy.
[0.8.20] - 2026-03-29#
Started hosting documentation on Read the Docs.
[0.8.19] - 2026-03-27#
Set up docs directory.
[0.8.17] - 2026-03-24#
Started using detect-secrets.
[0.8.16] - 2026-03-22#
Started using ruff; created py.typed.
[0.8.14] - 2026-03-21#
Set up tests directory; started using pytest.
[0.8.9] - 2026-03-14#
Created Dockerfile.
[0.8.8] - 2026-03-12#
Created .editorconfig and .pre-commit-config.yaml.
[0.8.6] - 2026-03-10#
Created ROADMAP.md.
[0.8.4] - 2026-03-09#
Created SUPPORT.md and CHANGELOG.md.
[0.8.2] - 2026-03-07#
Created CODE_OF_CONDUCT.md and CONTRIBUTING.md.
[0.8.1] - 2026-03-06#
Created pyproject.toml and SECURITY.md.
[0.8.0] - 2026-03-06#
Set up version control; added version submodule.
Below entries are abridged#
[0.7] - 2026-02-09#
Began migration of implementation details into _internal subpackage; fixed initialization logic and command line.
[0.6] - 2026-01#
Completed migration from inline annotations to separated stubs; perfected base.EventLoop and lazy loading; added console and cli submodules.
[0.5] - 2025-12#
Added classes such as altlocks.CircuitBreaker and channels.EventBus; implemented preliminary lazy loading system; created exceptions submodule;
began separation of type annotations from .py into .pyi.
[0.4] - 2025-10#
Added more complicated patterns and procedures such as channels.Observable and signals.wait_for_signal.
[0.3] - 2025-08#
Basically completed refactoring; added more object-oriented patterns such as altlocks.DynamicThrottle and misc.CacheWithBackgroundRefresh.
[0.2] - 2025-07#
Began reorganizing single file containing all functions into submodules.
[0.1] - 2025-06#
Added basic but untested features such as iters.tee, iters.merge, base.to_async, base.iter_to_agen and util.sync_await.
[0.0] - 2025-05#
Development began. This can be classified as a passion project.