TheAngryByrd/IcedTasks
71.4
Strong · 15 November 2026
7.8k
lines of production code
F#
primary language
5
measurements over time
What this system is
Features
Add database and ILSpy example projects
New example projects have been added to demonstrate library usage. The DatabaseDemo example provides a complete ASP.NET Core application showing how to handle cancellation in database operations using Npgsql and Dapper, including a docker-compose file to run a PostgreSQL instance. The ILSpySamples project serves as a playground to inspect the generated IL code for task and cancellable-task workflows.
examples · high confidence
Added F\# async benchmark suite for IcedTasks
This change introduces a new F\# benchmark project (\benchmarks/FSharpBenchmarks\) that provides performance comparisons for asynchronous patterns in F\# against C\# equivalents. The suite includes benchmarks for synchronous and asynchronous completion, file writing operations, and parallel async execution using various builders (standard \async\, \task\, \valueTask\, \cancellableTask\, and \FSharp.Control.Tasks.Affine\). It also adds a new \parallelAsync\ builder implementation for parallel async workflows, allowing users to measure the overhead and performance of parallel async bindings compared to sequential ones.
benchmarks/FSharpBenchmarks · high confidence
Adds parallelAsync builder and AsyncEx helpers for improved async interoperability
The library introduces a new \parallelAsync\ computation expression builder (with variants \parallelAsyncUsingStartChild\ and \parallelAsyncUsingStartImmediateAsTask\) that allows users to execute multiple async workflows concurrently using applicative syntax (\and!\). Additionally, the \AsyncEx\ module provides alternative implementations for awaiting Tasks, ValueTasks, and Awaitables that align with modern .NET exception semantics (avoiding \AggregateException\ wrapping) and adds a \TryFinallyAsync\ extension to F\# \Async\ types for robust compensation logic. These changes enhance performance and error handling when integrating F\# async workflows with C\#-style asynchronous types.
src/IcedTasks · high confidence
Comprehensive documentation for IcedTasks builders and usage patterns
The documentation site has been significantly expanded with new explanation guides and how-to tutorials. The 'Explanations' section now includes detailed comparisons of all available computation expression builders (such as \task\, \valueTask\, \cancellableTask\, \asyncEx\, and \poolingValueTask\), covering their result shapes, hot/cold behavior, and support for features like \and!\, \IAsyncDisposable\, and \IAsyncEnumerable\. It also explains polyfill namespaces for shadowing standard F\# builders and the specific behavior of the \and!\ operator. The 'How-To-Guides' section adds practical examples for integrating \CancellableTask\ into console applications, ASP.NET Minimal APIs, Giraffe, and Falco, alongside guides on composing task values with helper functions, converting between async shapes, and using AsyncEx for .NET interop.
docsSrc · high confidence
Removals
Removed legacy docsTool implementation
The entire docsTool module has been removed from the repository. This deletion eliminates the previous documentation generation pipeline, including the CLI argument parsing, the F\# Literate-based doc generation logic, the Fable.React-based HTML templates, and the local web server used for live previewing. Users relying on this tool for generating API documentation or serving documentation sites will no longer have access to these capabilities within this component.
docsTool · high confidence
Behavioural changes
Build infrastructure overhaul and .NET 10 SDK upgrade
The project has upgraded its required .NET SDK to version 10.0.100-rc.1 (global.json) and restructured the build system to enforce tool restoration and F\# code formatting via Fantomas before every build (Directory.Build.targets). The solution now includes dedicated projects for C\# and F\# benchmarks, tests for .NET Standard 2.0 and 2.1, and example code, while removing the previous docsTool project. Additionally, the .editorconfig has been expanded with specific formatting rules for F\# (Fantomas), XML, and other file types, and a script (generate-sdk-references.fsx) has been added to generate runtime load scripts for the local development environment.
(repo-wide) · high confidence
Build system refactored with extracted changelog and docs modules
The build process has been restructured to improve maintainability and documentation generation. The changelog logic has been extracted into a new \build/Changelog.fs\ module, which now handles version parsing, release note generation, and validation against Keep a Changelog standards. Documentation building has been migrated to FsDocs, with a new \build/FsDocs.fs\ module providing typed parameters for the build and watch commands. Additionally, the \paket.references\ file has been removed, indicating a shift away from Paket for build dependencies, and path resolution in \build.fs\ has been standardized using a \rootDirectory\ variable.
build · high confidence
Modernized devcontainer with .NET 10 support and devcontainer features
The development container configuration has been significantly updated to support .NET 10, with .NET 9 and 8 also available as additional versions. The setup now leverages official devcontainer features for common utilities, GitHub CLI, and Starship shell, replacing the previous manual Debian-based Dockerfile with a more modular approach. This change simplifies the environment setup, improves shell integration with Zsh and Starship, and ensures the container is ready for modern .NET development workflows out of the box.
.devcontainer · high confidence
Updated benchmark reports for Async and AsyncCompletion scenarios
New BenchmarkDotNet result files (Markdown, CSV, and HTML) have been added for the AsyncBenchmarks and AsyncCompletionBenchmarks suites. These reports provide updated performance metrics, including execution time, memory allocation, and garbage generation, comparing various async builders (such as CSharpTasks, Ply, ColdTask, and CancellableValueTask) across different binding scenarios on .NET 7.
benchmarks/FSharpBenchmarks/BenchmarkDotNet.Artifacts · high confidence
Test coverage
Added comprehensive test coverage for async builders and cancellation primitives
Added new test suites in tests/IcedTasks.Tests for the AsyncEx, CancellableTask, CancellableValueTask, CancellablePoolingValueTask, ColdTask, ParallelAsync, PoolingValueTask, and PoolingValueTaskDynamic builders. These tests verify core builder operations (Return, ReturnFrom, Bind) across various task-like types (Task, ValueTask, Async, ColdTask) and ensure correct behavior for cancellation and pooling scenarios. Additionally, updated the Expect module with helper functions for testing asynchronous exceptions and cancellation requests across these different task types.
tests/IcedTasks.Tests · high confidence
Dependencies
Migrate to Central Package Management and update dependencies
The project has switched from Paket to MSBuild Central Package Management, introducing Directory.Packages.props to define versions for FSharp.Core (6.0.4), Expecto (10.2.3), BenchmarkDotNet (0.13.9), and various Fake build tools (6.1.3). This change removes the legacy paket.dependencies and paket.lock files and updates the test and benchmark projects to target .NET 8, 9, and 10.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 66 → 71 (+5.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 75 → 81 (+6.3)
- Architecture 90 → 94 (+4.5)
- Maturity 85 → 89 (+3.7)
- Readiness 49 → 59 (+9.7)
- Security 79 → 77 (-1.8)
- Performance 100 → 100 (+0.0)
Resolved (15)
- Classify ADR enforcement: 0001. Define the cold result types as function type aliases (adr/0001-function-type-aliases-for-cold-results.md)
- Classify ADR enforcement: 0002. Start Async values with Async.StartImmediateAsTask (adr/0002-start-async-with-startimmediateastask.md)
- Classify ADR enforcement: 0003. Convert bound values with Source members, and bind awaiters on their own path (adr/0003-source-members-and-awaiter-binds.md)
- Classify ADR enforcement: 0004. Target netstandard2.0, netstandard2.1, net6.0, and net9.0 (adr/0004-library-target-frameworks.md)
- Classify ADR enforcement: 0005. Start both and! operands before the builder awaits either (adr/0005-and-bang-starts-both-operands.md)
- Classify ADR enforcement: 0006. Give asyncEx task-await semantics that differ from FSharp.Core async (adr/0006-asyncex-task-await-semantics.md)
- Classify ADR enforcement: 0007. Test the netstandard builds in their own test projects (adr/0007-separate-netstandard-test-projects.md)
- Classify ADR enforcement: 0008. Share one resumable implementation through builder base classes (adr/0008-shared-builder-base-classes.md)
- Classify ADR enforcement: 0009. Put the task and async polyfills in opt-in namespaces (adr/0009-opt-in-polyfill-namespaces.md)
- Classify ADR enforcement: 0010. Depend on Microsoft.Bcl.AsyncInterfaces on netstandard2.0 (adr/0010-bcl-asyncinterfaces-on-netstandard2-0.md)
- Classify ADR enforcement: 0011. Set FSharp.Core per target framework with central package management (adr/0011-fsharp-core-per-target-framework.md)
- Classify ADR enforcement: 0012. Give each builder file its own namespace and auto-open all of them (adr/0012-namespace-per-builder-file.md)
- IL efficiency: 2 authored method(s) exceed the IL budget (build/FsDocs.fs)
- Outdated: Microsoft.Bcl.TimeProvider
- Projects may be oversized for their cohesion
New (3)
- No test project references CSharpTaskBenchmarks (benchmarks/CSharpTaskBenchmarks/CSharpTaskBenchmarks.csproj)
- No test project references benchmarks (benchmarks/FSharpBenchmarks/benchmarks.fsproj)
- Outdated: Microsoft.Bcl.TimeProvider (Directory.Packages.props)
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
TheAngryByrd/IcedTasks was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 5db859bd1b0c808ba802b69abec11127751e1c18 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.