sherlock-project/sherlock
48.8
Weak · 15 November 2026
1.4k
lines of production code
Python
primary language
5
measurements over time
What this system is
Features
Automated site listing generation and CI validation summaries
The project now includes scripts to automate documentation and CI feedback. The new \site-list.py\ script reads the supported sites data, sorts them alphabetically, and generates the \sites.mdx\ documentation file, ensuring the list of supported sites is always up-to-date. Additionally, \summarize\_site\_validation.py\ parses JUnit XML test results from the CI workflow and formats them into a readable table for issue comments, clearly indicating pass/fail status for false-positive and false-negative checks to help reviewers assess site validation changes.
devel · high confidence
Initial release of Sherlock Actor for Apify
This change introduces the complete definition and runtime configuration for the Sherlock Actor on the Apify platform. It includes the Dockerfile for the serverless environment, the actor.json manifest, and the input/output data schemas (input\_schema.json, dataset\_schema.json) that define the user interface for submitting usernames and viewing social media profile links. The actor.sh script implements the core logic to execute the Sherlock tool and push results to the Apify dataset, enabling users to perform username reconnaissance across social networks via the Apify Console, CLI, or API.
.actor · high confidence
Behavioural changes
Sherlock restructured as a proper Python package with Python 3.9+ requirement
The tool has been refactored from a script-based structure into a standard Python package (sherlock\_project), introducing a \py.typed\ marker file to support PEP 561 type checking. This change enforces a minimum Python version of 3.9, as the entry point now explicitly checks the runtime version and exits if an older interpreter is detected. The internal logic has been modularized into distinct modules for site information, query results, and notifications, providing a more stable foundation for future features.
_sherlock\project · high confidence
Test coverage
Comprehensive test suite for site validation, NSFW handling, and CLI behavior
Added a new pytest-based test suite covering core Sherlock functionality. Tests verify that the site manifest validates against both local and remote JSON schemas, and that site data is iterable with correct error types. Live integration tests check known positive and negative username probes across various sites (e.g., GitHub, GitLab, Docker Hub) and validate that illegal regex patterns are correctly rejected. The suite also includes regression tests for handling Unicode decode/encode errors in username lookups, verifies the NSFW site removal and explicit selection logic, tests wildcard username expansion, and ensures the CLI correctly reports versioning and errors when no usernames are provided.
tests · high confidence
Dependencies
Migration to Poetry build system and Python 3.9+ requirement
The project has switched its build backend from setuptools to Poetry, introducing a pyproject.toml that defines the build system (poetry-core\>=1.2.0) and manages dependencies. This change enforces a minimum Python version of 3.9 (dropping support for 3.8) and updates the dependency specifications, including allowing higher versions for certifi and pandas, while adding dev dependencies like pytest 8.4.2 and pytest-xdist 3.8.0.
(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 49 → 49 (+0.2)
- Rubric changed (rubric-2026.11.1 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 71 → 66 (-5.3)
- Architecture 69 → 69 (+0.0)
- Maturity 47 → 50 (+3.1)
- Readiness 37 → 37 (+0.0)
- Security 78 → 78 (+0.0)
Resolved (3)
- Further sole-owners (lower concentration)
- No ADRs found
- Off-boarding risk: anonymized user #1
New (5)
- No ADRs found (pyproject.toml)
- Off-boarding risk: anonymized user #1
- Orphaned file (devel/summarize_site_validation.py)
- Orphaned file (sherlock_project/result.py)
- Orphaned files with no living knowledge
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
sherlock-project/sherlock 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 c588d7c8b476df9f9c84912a05d1430fb8cdcdae — 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.73+preprod-52de90b74216.