sdsykes/fastimage
60.4
Adequate · 6 November 2026
1.2k
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Initial release of FastImage library
Introduces the FastImage gem, a lightweight Ruby library for determining image size and type by fetching only the necessary header bytes from a URI, local file path, or IO object. The library supports a wide range of formats including GIF, JPEG, BMP, TIFF, ICO, PNG, HEIC/HEIF, AVIF, PSD, SVG, WEBP, and JXL, and can parse Exif orientation data for JPEGs and TIFFs. It handles HTTP redirects (up to 4), allows custom HTTP headers, and includes a compatibility patch for Ruby versions older than 2.2 to support hostnames with underscores.
lib · high confidence
Behavioural changes
7 commits (3 fixes) modifying lib/fastimage/fastimage\_parsing
A change to existing behaviour in lib/fastimage/fastimage\_parsing — 7 commits (3 fixs), 19 files: “Fix HTML with inline SVG being incorrectly detected as SVG”; “Guard rotation swap when no size was found in ISO-BMFF parsing”; “Harden stream reader against negative lengths; return nil for sizeless JXL”; and 4 more (refs \#158).
_lib/fastimage/fastimage\parsing · medium confidence · unverified
FastImage library refactored with modular parsers and new version 2.4.1
The FastImage library has been restructured to use a modular parser architecture, introducing separate files for handling specific image formats (AVIF, BMP, EXIF, GIF, HEIC, ICO, ISO BMFF, JPEG, JXL, JXLC, PNG, PSD, SVG, TIFF, WebP) and stream utilities, while the main class now includes these parsers via a module. This change coincides with a version bump to 2.4.1, as defined in the new version.rb file. The core API methods (size, type, animated?) remain available, but the internal implementation now relies on this new parser registry and lazy property fetching structure.
lib/fastimage · high confidence
Test coverage
1 commit adding/updating tests in test/fixtures/exif-orientation-testimages; 2 commits adding/updating tests in test/fixtures/avif; 5 commits adding/updating tests in test/fixtures/heic; Add test infrastructure for SSL and slow-network scenarios; Added SVG and XML test fixtures.
Dependencies
Initial gemspec and Gemfile setup for FastImage
The project now includes a Gemfile and a gemspec file that define the FastImage gem structure. The gemspec specifies a minimum Ruby version of 1.9.2 and lists development dependencies including fakeweb-fi (\~\> 1.3), rake (\>= 10.5), rdoc, test-unit, and webrick. This establishes the build and testing environment for the library.
(dependencies) · high confidence
Housekeeping
Initial repository setup with documentation and build configuration
The repository is initialized with core project files including a comprehensive README.md detailing the FastImage gem's capabilities (fetching image size/type with minimal network traffic), a CHANGELOG tracking versions up to 2.4.1, an MIT license, and a Rakefile for running tests and generating RDoc documentation. A .gitignore file is added to exclude build artifacts (pkg/), lockfiles (Gemfile.lock), and OS-specific files (.DS\_Store).
(repo-wide) · 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 57 → 60 (+3.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 65 → 65 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 47 → 54 (+6.6)
- Readiness 65 → 65 (+0.0)
- Security 77 → 76 (-0.3)
Resolved (7)
- Inconsistent arity for the same logical operation. Similar to size, the class-level type method takes a URI, while the instance method does not. This creates a potential for confusion regarding which method to call based on whether a FastImage object has been instantiated.
- Inconsistent arity for the same logical operation. The class-level animated? method takes a URI, while the instance method animated does not. The naming convention also shifts from predicate style (?) in the class method to non-predicate in the instance method, which is inconsistent with Ruby conventions where instance methods returning booleans should also end in ?.
- Inconsistent arity for the same logical operation. The class-level method requires a URI argument, while the instance method does not. While this is a common pattern (class method vs instance method), it can be confusing if the user expects FastImage.size to always behave like the instance method or vice versa without clear documentation on context.
- Orphaned file (lib/fastimage.rb)
- Orphaned file (lib/fastimage/fastimage.rb)
- Orphaned file (lib/fastimage/fastimage_parsing/iso_bmff.rb)
- Orphaned files with no living knowledge
New (1)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 5 commits — 3 feature/other, 2 fixes
By area
- (repo) — 2 commits
- lib/fastimage — 2 commits
- (root) — 1 commit
Notable commits
- fix: Merge pull request #168 from sdsykes/fix/zero-size-bmff
- fix: Merge pull request #170 from sdsykes/fix/jxl-nil-size-and-negative-skip
- change: Guard rotation swap when no size was found in ISO-BMFF parsing
- change: Harden stream reader against negative lengths; return nil for sizeless JXL
- change: Update changelog and version to 2.4.2
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
sdsykes/fastimage 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 6 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 22b06927a147e6c76ab5b77192c814dffad3898a — the exact code this score is about.
- Scored under rubric-2026.11.2 — 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.2+preprod-5c4e66d9318b.