Public recordModerate
Software health reportschema 0.23.0 · metrics 1.13.0 · 2026-07-21 20:32 UTC
fralau / mkdocs-macros-plugin
Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.
fralau/mkdocs-macros-plugin holds a health index of 52 out of 100, placing it in the Moderate band. It scores highest on Community & Adoption (62/100) and lowest on Vitality (39/100). It was last updated 79 days ago. A single contributor accounts for most of its recent work.
52
overall / 100Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
52
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Ownership
Laurent FranceschettiPersonal account
24 followers13 public repossince Feb 2018SettleNext
This repository is owned by a personal account. A single-owner project carries more continuity risk than an organization-backed one.
Package ecosystems
| Registry | Package | Version | Downloads / mo | Versions | Last publish | Tags |
|---|---|---|---|---|---|---|
| PyPI | mkdocs-macros-pluginpoints to another repo — not scored | 1.5.0 | 2,917,195 | 38 | 250 days ago | macrosmarkdownmkdocspython |
Metrics by category
Vitality
Is the project alive — is code being written and are releases shipping?
39
Development activity
36At risk
How it's scored
| 18/36 | Push recency — last push 79 days ago |
| 5.5/36 | Commit cadence — 8/52 weeks with commits |
| 13/18 | Commit volume — 27 commits in the last year |
| 0/10 | OpenSSF Scorecard: Maintained — 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
Inputs used
| commits_last_year | 27 |
| human_commit_share | 1 |
| days_since_last_push | 79 |
| active_weeks_last_year | 8 |
Release discipline
44At risk
How it's scored
| 27/27 | Ships releases — 5 releases published |
| 7.2/36 | Release recency — latest release 625 days ago |
| 5.4/27 | Release cadence — a release every ~455 days |
| 0/10 | OpenSSF Scorecard: Signed-Releases — no data |
Inputs used
| releases_count | 5 |
| latest_release_tag | v1.3.7 |
| releases_from_tags | no |
| days_since_latest_release | 625 |
| mean_days_between_releases | 455 |
Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.
Community & Adoption
Does the project have users, downloads, attention, and a welcoming setup for contributors?
62
Popularity & adoption
61Moderate
How it's scored
| 42.3/60 | Stars — 407 stars |
| 14.4/25 | Forks — 54 forks |
| 3.9/15 | Watchers — 6 watchers |
Inputs used
| forks | 54 |
| stars | 407 |
| watchers | 6 |
| growth_state | organic |
| growth_factor_pct | 100 |
Community health
64Moderate
How it's scored
| 22.5/22.5 | README |
| 16.9/22.5 | License — license file present, not a recognized license |
| 18/18 | CONTRIBUTING guide |
| 0/13.5 | Code of conduct |
| 0/7.2 | Issue template |
| 0/6.3 | PR template |
Inputs used
| has_readme | yes |
| has_license | yes |
| has_contributing | yes |
| has_issue_template | no |
| has_code_of_conduct | no |
| has_pull_request_template | no |
Sustainability & Governance
Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?
53
Maintainer resilience (bus factor)
41At risk
How it's scored
| 9/54 | Bus factor — 1 contributor(s) cover half of all commits |
| 8.3/22.5 | Commit distribution — top contributor authored 63% of commits |
| 13.5/13.5 | Contributor breadth — 34 contributors |
| 10/10 | OpenSSF Scorecard: Contributors — project has 3 contributing companies or organizations -- score normalized to 10 |
Inputs used
| bus_factor | 1 |
| contributors_sampled | 34 |
| top_contributor_share | 0.632 |
How it's scored
| 45.5/46.8 | Issue resolution — 97% of issues closed |
| 27/38.3 | PR acceptance — 43/61 decided PRs merged |
| 0/15 | OpenSSF Scorecard: Code-Review — Found 2/30 approved changesets -- score normalized to 0 |
Inputs used
| merged_prs | 43 |
| open_issues | 4 |
| closed_issues | 149 |
| issue_closed_ratio | 0.974 |
| closed_unmerged_prs | 18 |
Ownership & stewardship
50Moderate
How it's scored
| 10/30 | Ownership backing — personal (user) account |
| 0/20 | Verified domain — not applicable to user accounts |
| 10.1/25 | Owner reach — 24 followers of fralau |
| 20.3/25 | Track record — 13 public repos, account ~8 yr old |
Inputs used
| followers | 24 |
| owner_type | User |
| is_verified | — |
| owner_login | fralau |
| public_repos | 13 |
| account_age_days | 3,070 |
Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.
Engineering Quality
Are baseline engineering and documentation practices in place?
59
Engineering practices
48At risk
How it's scored
| 24/24 | CI workflows — 2 workflow(s) |
| 24/24 | Tests present |
| 0/16 | Linter config |
| 0/9.6 | Pre-commit hooks |
| 0/6.4 | .editorconfig |
| 0/20 | OpenSSF Scorecard: CI-Tests — 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
Inputs used
| has_ci | yes |
| has_tests | yes |
| has_editorconfig | no |
| has_linter_config | no |
| has_precommit_config | no |
Documentation
75Good
How it's scored
| 30/30 | README |
| 0/25 | Documentation directory |
| 15/15 | Documentation / homepage site — https://mkdocs-macros-plugin.readthedocs.io |
| 10/10 | Repository description |
| 10/10 | Topics — 8 topics |
| 10/10 | Wiki |
Inputs used
| topics | python, mkdocs, markdown, jinja2-templates, jinja2, documentation, mkdocs-macros-plugin, automation |
| has_wiki | yes |
| homepage | https://mkdocs-macros-plugin.readthedocs.io |
| has_readme | yes |
| has_docs_dir | no |
| has_description | yes |
Security
Are visible security and supply-chain practices strong, without unresolved high-risk jurisdiction exposure?
46
Security posture
32At risk
How it's scored
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 0/7.5 | Branch-Protection — branch protection not enabled on development/release branches |
| 0/2.5 | CI-Tests — 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 2/30 approved changesets -- score normalized to 0 |
| 2.5/2.5 | Contributors — project has 3 contributing companies or organizations -- score normalized to 10 |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.2/2.5 | License — license file detected |
| 0/7.5 | Maintained — 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
| 0/5 | Packaging — no data |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 0/5 | SAST — SAST tool is not run on all commits -- score normalized to 0 |
| 0/5 | Security-Policy — security policy file not detected |
| 0/7.5 | Signed-Releases — no data |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 7.5/7.5 | Vulnerabilities — 0 existing vulnerabilities detected |
Inputs used
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 3.2 |
Excluded from scoring (no data or not applicable): packaging, signed_releases. Remaining weights renormalized.
Dependency advisories
100Excellent
How it's scored
| 35/35 | Direct dependencies free of known advisories — no direct dependency carries a known advisory |
| 25/25 | Indirect dependencies free of known advisories — no indirect dependency carries a known advisory |
| 0/40 | No advisories left outstanding — no advisory carries a publication date |
Inputs used
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 24 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:mkdocs-macros-plugin@1.5.0 runtime dependency closure — what installing the published package pulls in — 24 packages. Reachability is not analyzed.
AI Readiness
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
41
Agent context & guidance
32At risk
How it's scored
| 0/45 | Agent instructions — no CLAUDE.md / AGENTS.md / editor rules |
| 0/15 | Machine-readable docs (llms.txt) |
| 31.5/40 | Legible commit history — 59 of 100 human commits state their intent (structured subject or explanatory body) |
Inputs used
| has_llms_txt | no |
| legible_history_share | 0.59 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
How it's scored
| 0/18 | One-command bootstrap |
| 22/22 | Automated tests |
| 0/11 | Lint / format config |
| 11/11 | Static type checking — mkdocs_macros/py.typed |
| 0/10 | Reproducible environment |
| 0/10 | Demonstrated agent practice — no agent-authored commits among the last 100 |
| 0/8 | Automated maintenance — no automated dependency updates observed |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
Inputs used
| has_nix | no |
| has_tests | yes |
| lockfiles | — |
| has_dockerfile | no |
| typed_language | no |
| bootstrap_files | — |
| has_devcontainer | no |
| has_linter_config | no |
| typecheck_configs | mkdocs_macros/py.typed |
| agent_commit_share | 0 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
How it's scored
| 27/45 | Type-checkable code — Python with type-check config (mkdocs_macros/py.typed) |
| 55/55 | Manageable file sizes — 0/35 source files over 60KB |
Inputs used
| primary_language | Python |
| largest_source_bytes | 36,133 |
| source_files_sampled | 35 |
| oversized_source_files | 0 |
Key facts
407GitHub stars
34contributors
27commits, last 12 months
79days since last push
5releases
1bus factor
4open issues
PyPIpackage ecosystems
Data collection warnings
- pypi package 'mkdocs-macros-plugin' points at a different repository (https://github.com/fralau/mkdocs_macros_plugin); excluded from ecosystem scoring
More detail
Star and fork history 407 ★ / 54 ⇿
407Stars
54Forks
5Releases
When each star and fork was added, collected from GitHub and bucketed by day. Cumulative growth sits directly above the daily additions it is made of, so the two read against each other: steady organic accretion looks nothing like an abrupt, short-lived burst. Where that difference is measurable, it is reported as growth authenticity.
Major 0Minor 3Patch 2
Each point covers 8 days.
OpenSSF Scorecard 3.2 / 10
3.2aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 0 | Branch-Protection | branch protection not enabled on development/release branches |
| 0 | CI-Tests | 0 out of 2 merged PRs checked by a CI test -- score normalized to 0 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 2/30 approved changesets -- score normalized to 0 |
| 10 | Contributors | project has 3 contributing companies or organizations -- score normalized to 10 |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 9 | License | license file detected |
| 0 | Maintained | 1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0 |
| n/a | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 0 | SAST | SAST tool is not run on all commits -- score normalized to 0 |
| 0 | Security-Policy | security policy file not detected |
| n/a | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
Direct dependencies 10
| Registry | Package | Version constraint | Manifest |
|---|---|---|---|
| PyPI | hjson | — | pyproject.toml |
| PyPI | jinja2 | — | pyproject.toml |
| PyPI | mkdocs | >=0.17 | pyproject.toml |
| PyPI | packaging | — | pyproject.toml |
| PyPI | pathspec | — | pyproject.toml |
| PyPI | python-dateutil | — | pyproject.toml |
| PyPI | pyyaml | — | pyproject.toml |
| PyPI | requests | — | pyproject.toml |
| PyPI | super-collections | >= 0.6.2 | pyproject.toml |
| PyPI | termcolor | — | pyproject.toml |
All dependencies 13
Full resolved dependency set from the GitHub dependency graph: 10 direct and 3 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.
| Registry | Package | Version | Relation |
|---|---|---|---|
| PyPI | hjson | — | direct |
| PyPI | jinja2 | — | direct |
| PyPI | mkdocs | — | direct |
| PyPI | packaging | — | direct |
| PyPI | pathspec | — | direct |
| PyPI | python-dateutil | — | direct |
| PyPI | pyyaml | — | direct |
| PyPI | requests | — | direct |
| PyPI | super-collections | — | direct |
| PyPI | termcolor | — | direct |
| PyPI | mkdocs-include-markdown-plugin | — | indirect |
| PyPI | mkdocs-material | — | indirect |
| PyPI | mkdocs-mermaid2-plugin | — | indirect |
Dependency advisories 0
Installing pypi:mkdocs-macros-plugin@1.5.0 pulls in 24 packages, direct and transitive: 0 carry known advisories, of which 0 are direct dependencies.
No known advisories affect the assessed dependencies.
An advisory means the version recorded in the dependency graph falls inside an advisory’s affected range. Reachability is not analysed, and the graph includes development and test pins — a finding may concern tooling rather than shipped software.
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"python",
"mkdocs",
"markdown",
"jinja2-templates",
"jinja2",
"documentation",
"mkdocs-macros-plugin",
"automation"
],
"is_fork": false,
"size_kb": 750,
"has_wiki": true,
"homepage": "https://mkdocs-macros-plugin.readthedocs.io",
"languages": {
"Shell": 1438,
"Python": 90820
},
"pushed_at": "2026-05-03T17:40:07Z",
"created_at": "2018-06-27T15:24:40Z",
"owner_type": "User",
"updated_at": "2026-06-22T16:40:54Z",
"description": "Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.",
"is_archived": false,
"is_disabled": false,
"license_spdx": null,
"default_branch": "master",
"license_spdx_raw": "NOASSERTION",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": null,
"name": "Laurent Franceschetti",
"type": "User",
"login": "fralau",
"company": "SettleNext",
"location": "Geneva, Switzerland",
"followers": 24,
"avatar_url": "https://avatars.githubusercontent.com/u/36767124?v=4",
"created_at": "2018-02-23T14:25:26Z",
"is_verified": null,
"public_repos": 13,
"account_age_days": 3070
},
"license": {
"state": "custom",
"spdx_id": null,
"raw_spdx": "NOASSERTION",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.3.7",
"kind": "patch",
"published_at": "2024-11-03T09:25:47Z"
},
{
"tag": "v1.0.4",
"kind": "patch",
"published_at": "2023-08-13T11:52:51Z"
},
{
"tag": "v0.5.0",
"kind": "minor",
"published_at": "2020-11-23T19:17:08Z"
},
{
"tag": "v0.4.0",
"kind": "minor",
"published_at": "2020-02-24T20:17:01Z"
},
{
"tag": "v0.3.0",
"kind": "minor",
"published_at": "2019-11-10T10:02:05Z"
}
],
"recent_commits": [
{
"oid": "f4f5bb01e28f50e4f0ba697362b1973ae6d4b25d",
"body": "Add `j2_line_statement_prefix` and `j2_line_comment_prefix` to plugin config scheme.\n\nThese options are already forwarded to Jinja through the existing `j2_*` handling, but MkDocs warns because they are not declared in the scheme. Adding them preserves the current runtime behavior while making valid Jinja line statement/comment configuration warning-free.\n\nSigned-off-by: Joey Chen <142381267+JoeyC-Dev@users.noreply.github.com>",
"is_bot": false,
"headline": "fix: support Jinja line prefix config options (#289)",
"author_name": "Joey Chen",
"author_login": "JoeyC-Dev",
"committed_at": "2026-05-03T17:40:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0536f4da1dc643e1fa1f0cc90e71512ada67dc04",
"body": null,
"is_bot": false,
"headline": "Fix type hint for compatibility",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T08:06:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d9a6bc3aac5b12b86f9e2be7af18e1e9178287f6",
"body": null,
"is_bot": false,
"headline": "Require mkdocs-test>=0.6.0 (compatibility with Python 3.8 and 3.9)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T08:03:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bcaa72db2820d60822ffba15e87c75669abc7b92",
"body": " - Remove install restriction for mkdocs-test\n - Add shield in READMEfor Python versions (>= 3.8)",
"is_bot": false,
"headline": "Make last minute corrections",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T07:49:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "356fc2a5b55d1897a2f2c47856d52b10cff4611c",
"body": " - changelog updated\n - bump version number\n - Github tests added for Python 3.8 and 3.9",
"is_bot": false,
"headline": "Prepare for release",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-13T07:44:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "aaf16bdcb9dfcb9c6ea9b6567ea4af7f8c178185",
"body": null,
"is_bot": false,
"headline": "Limit testing to 3.10 up (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:40:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ba5356c0c263355556aa82dad0fbfde3cce4bc4d",
"body": null,
"is_bot": false,
"headline": "Use proper exit for pytest if Python < 3.10 (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:33:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6c796600bc0886696ce9b76b84354d7e2bc1b6fa",
"body": " - MkDocs-Test incompatible with earlier versions",
"is_bot": false,
"headline": "Skip test_modules.py if Python version < 3.10 (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T14:11:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cec7440d46589b303d741a5e2df0a240c25b9bdb",
"body": null,
"is_bot": false,
"headline": "Test installation of d2 in a cross-platform way (#279)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-12T13:27:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "492759c5ab3d05f7c55ec62ffdf9573b715ac6ed",
"body": " - add pytest to test in pyproject.toml",
"is_bot": false,
"headline": "Update with changes from local repo (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:45:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cc5416834a07ffd2ba1fe3d917a701ac6e9c98ad",
"body": null,
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:39:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "54b03834f0dc2457dc116419b6b128323304978a",
"body": null,
"is_bot": false,
"headline": "Clarify code for module import management (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T14:38:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "301b18342b46fb67e0a91f19d3f97d04b8e6faa9",
"body": null,
"is_bot": false,
"headline": "Add GitHub Actions workflow for testing with Pytest",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T13:58:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5b9d8275813c54bca02377ffe6b915f40738e158",
"body": " - Correct import procedure (which did not take it into account)\n - Make test cases to prove it works\n - Bump version no",
"is_bot": false,
"headline": "Fix error importing packages with `module_name` (#278)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-11-11T13:45:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a93a1f74402b5d632acbab35a77d5171eb5d0e6d",
"body": "Added a fix for missing dependency declaration on requests.",
"is_bot": false,
"headline": "Update CHANGELOG for version 1.4.1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-25T12:34:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a76d62bf02f66cc9090cb8b266df738f97c1c80b",
"body": " - included `new_syntax` test case in pytest tests\n - the `config.yml` file contains the j2_extensions parameter\n - bump version number",
"is_bot": false,
"headline": "Add documentation for jinja2_extensions (#272)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:33:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9a329bc2c44af538556c840530d65266ee02ec44",
"body": null,
"is_bot": false,
"headline": "Merge branch 'master' of https://github.com/fralau/mkdocs-macros-plugin",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:01:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2eaf0330e74c458d6ec348a212a94dd7199a89e5",
"body": null,
"is_bot": false,
"headline": "Update post_production.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-18T13:00:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c6ea72ac8d57f3a750891953fa00ad0ffa683ea8",
"body": "…(#273)\n\n* add j2_extensions to config scheme",
"is_bot": false,
"headline": "Enable j2 extensions in mkdocs-macros without false-positive warning …",
"author_name": "William Warriner",
"author_login": "wwarriner",
"committed_at": "2025-10-18T12:59:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "51a3afc4868838f2c0e5f69485e74264cf173af8",
"body": null,
"is_bot": false,
"headline": "Add dependency on `requests` (#269)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-10-01T00:29:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b1dacfb0fba951fc79d36f50895cda3bed3163f6",
"body": null,
"is_bot": false,
"headline": "Delete install_package() function from codebase",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-22T14:15:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4ec687e81b6c1b6ac2ad11f1c8cfae671d86bef0",
"body": " - Change documentation to reflect this\n - Bump version number\n - Changelog for Pypi release",
"is_bot": false,
"headline": "Remove auto-install of missing pluglet (#262)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-21T20:52:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e9dec13e22f12e4fb36bee8065ab90d5e3b90d6e",
"body": null,
"is_bot": false,
"headline": "Remove installation of missing pluglet (but meaningful message) #262",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-21T18:58:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9ef2b98d2b6d9971ecd68da3fcc9360d07373c71",
"body": " - The purpose is to prevent failures of yaml dumps",
"is_bot": false,
"headline": "Include new function `yaml_support()` from super_collections (#258)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-09-19T10:35:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "86e31f781e1d57d0bee0f9e8d2fa6cb756671c9c",
"body": null,
"is_bot": false,
"headline": "Define explicitely python in `update_pypi.sh`",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-12T13:07:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6b396ecb99bffc7b7eab01f1b887bddee8237faa",
"body": null,
"is_bot": false,
"headline": "Add info in doc that a module can have relative path (#263)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-11T15:21:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "62daea93707d9921fbae7bc00c89a824e0667e4b",
"body": "- Added `.has_j2() method for testing the presence of jinja2\n- Added `.env()` method (to clarify code)",
"is_bot": false,
"headline": "Fix: Fix detection of Jinja2, to allow title rendering (#266)",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2025-08-10T16:21:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e0ba1ba3683d5b618c979dd2d7bca5a48f7c87ad",
"body": null,
"is_bot": false,
"headline": "Test built-in filters (#253)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-11-07T11:15:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bc57e31fc29a22c565ee194f3fb1294e0e4e1c5",
"body": " - update CHANGELOG\n - update authors",
"is_bot": false,
"headline": "Fix imprecision in description of parameters for jinja2 syntax (#252)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-11-03T08:28:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4fb7bf6902d11163970f18ec4ddfeb7a51127657",
"body": null,
"is_bot": false,
"headline": "Change tests: MkDocsPage.find() -> find_text()",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-28T19:16:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b906a368ecfd5cd25abcbea0a37f7a23944a8355",
"body": null,
"is_bot": false,
"headline": "Bump version number",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-26T15:15:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "56418062b60c13faa4bbc15ab75fe6301c531fba",
"body": " - Added test case",
"is_bot": false,
"headline": "Fixed incompatibility with d2 module (#249)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-18T19:59:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3a73707abd48c9df214646d57204cff854bbe98b",
"body": " - change update_pypi.sh accordingly",
"is_bot": false,
"headline": "Migrate to pyproject.toml",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-17T04:41:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "99733bed5e62b9cc43cad1def816aefdf28651a1",
"body": null,
"is_bot": false,
"headline": "Demote info messages as debug (#248)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-16T18:01:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6a9a0e4f41e02a79f0e8f682f5329ed89f5dbb27",
"body": null,
"is_bot": false,
"headline": "Bump version number, for distribution (should solve #247)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-10T19:58:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "32cd528114ff8b4203c5bfe216f32ca613266bc9",
"body": " - added the register_macros test case\n - reimplemented the .variables, .macros and .filters\n properties for MacrosDocProject\n - updated documentation, to document hooks scripts\n (including comparison with MkDocs-Macros modules)",
"is_bot": false,
"headline": "Test the hooks for external registration (#237)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-10T05:48:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "16be58d9c64bf29ad489762fb30f6467eb192450",
"body": null,
"is_bot": false,
"headline": "Migrate all tests toward the mkdocs-test framework (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-09T13:28:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "59f82db2a60eae28832b5a1d44fb475f8c9e309f",
"body": null,
"is_bot": false,
"headline": "Replacing local implementation of SuperDict by super-collections version",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-05T09:27:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "38b9681833fd06ae049c10fded1d33514b6c8d8e",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-02T15:27:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eebbbd1b6d9d587dbb36cb08d5aee35c5a8a34a7",
"body": "Add `pathspec` as dependency",
"is_bot": false,
"headline": "Merge pull request #246 from dwreeves/add-pathspec-as-dependency",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-10-02T15:26:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6d9982213eaca2fd44b9ddc101ed417371d829ed",
"body": null,
"is_bot": false,
"headline": "Add `pathspec` as dependency",
"author_name": "Daniel Reeves",
"author_login": "dwreeves",
"committed_at": "2024-10-02T14:26:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69577e12bc5d4bc4f59f276d599f39263fa4ea82",
"body": " - these two objects are now defined separately from the fixture\n (MacrosDocProject and TestMarkdownPage)",
"is_bot": false,
"headline": "Separate standard DocProject and MarkdownPage classes",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-10-01T07:11:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "962472c77a6942c1ed293161aabfa6d2bfc71c9c",
"body": " - issue #244",
"is_bot": false,
"headline": "Split test framework into DocProject (general) and MacrosDocProject",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-30T06:37:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e164982ee22bd2b36316eb1a0026cd0c80f1b4a2",
"body": " - Extracted fixture utilities into `fixture_util.py`\n - Created a ./test_fixture.sh to specifically test the fixture,\n with options (also called when invoking `pytest`)\n - Specifically made a test in that context, for the `find_page()` function.",
"is_bot": false,
"headline": "Improve tests (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-29T12:48:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9186fe67f7dc1427043bea74e49906eeb5c3a797",
"body": " - changed name from opt-in and opt-out",
"is_bot": false,
"headline": "Fixed null test and completed added opt_in and opt_out",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-29T08:17:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b76efefa71834d6ba71ca348bde8b1f3d7baebc2",
"body": " - Added a `null` test project that does nothing\n - Improved the `module` to test further things\n - Redefined the `MardkowPage.is_rendered()` method\n as \"not (source is included in target)\"",
"is_bot": false,
"headline": "Improved tests (#244)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-28T08:56:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6265d905cbaf9af6d1d1601b94df6209a8ca5993",
"body": null,
"is_bot": false,
"headline": "Add a testing framework, as described in #244",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-26T08:30:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa90b968828ff7345c647dbf4b8a3e7f3d6b7661",
"body": null,
"is_bot": false,
"headline": "Fix `print` statement left in code #242",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-18T07:45:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8b3f45628ebaf8be2cb9d58a7263dd8dc3df24f",
"body": null,
"is_bot": false,
"headline": "Document hooks for #237 (register macros/variables/filters)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-16T09:35:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c1029d54dcb938a8ba736f87009eff5bf29ed953",
"body": null,
"is_bot": false,
"headline": "Document how to correct issue with macros / admonitions (#240)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-15T06:15:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "67ccb159e7f135305b3f3a20bd56c58a623228e8",
"body": "Fix registration system",
"is_bot": false,
"headline": "Merge pull request #238 from timvink/master",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-09-14T07:16:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "03f5e89acfa246439cc877cc83c386cdebb1b21f",
"body": null,
"is_bot": false,
"headline": "Fix registration system",
"author_name": "Tim Vink",
"author_login": "timvink",
"committed_at": "2024-09-13T14:11:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ddace9739ffa43b26285e82ea70c8ff0d0e719af",
"body": null,
"is_bot": false,
"headline": "remove property on register methods",
"author_name": "Tim Vink",
"author_login": "timvink",
"committed_at": "2024-09-13T13:13:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "363d9046eeb6cb45f33e56c1cc4507cb6487bc39",
"body": null,
"is_bot": false,
"headline": "Add three hooks `register_variables/macros/filters` (#237)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-09-05T13:37:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2fb833e4009f6875d0df01f00e7c2d4640c1e00a",
"body": "- New filter is now called `relative_url`.",
"is_bot": false,
"headline": "Improved implementation for relative url (#236)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T14:20:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69e7cada20e500177756ce6fe89a7b0c4b1aa640",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T07:06:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5bec964e81d9342ce92b838ad235247dec670f51",
"body": "- This filter is imported from mkdocs.utils",
"is_bot": false,
"headline": "Add standard filter `normalize_url` (#236)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-07-28T07:06:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9a08f11742c130b06ff3345d64855669dbbcc4aa",
"body": "Fix encoding issue for other characters set",
"is_bot": false,
"headline": "Merge pull request #228 from caomingpei/master",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-06-02T06:42:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "590232c22954bbdf96a0ba40fa4ccb261e8f3de6",
"body": "Add type marker for PEP 561 compliance",
"is_bot": false,
"headline": "Merge pull request #231 from kchr/pep561",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-06-02T06:38:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e2126bbcb0c01043402125465fccd6144bc94e2c",
"body": "This adds a `py.typed` file in the package directory, which acts as a\nmarker to declare that it is PEP 561 compliant and includes type hints.\n\nMore information is available here:\n\nhttps://mypy.readthedocs.io/en/stable/installed_packages.html#creating-pep-561-compatible-packages\n\nFixes #219.",
"is_bot": false,
"headline": "Add type marker for PEP 561 compliance",
"author_name": "Noor Christensen",
"author_login": "kchr",
"committed_at": "2024-06-01T22:13:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0ee9856132780e51ffaa74831c4b054aecfcd0a7",
"body": "undefined variable config in readme",
"is_bot": false,
"headline": "Merge pull request #230 from garfieldnate/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-05-13T17:42:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bc801a935198fe97710ddc2b4cc46e3b22e1642",
"body": null,
"is_bot": false,
"headline": "undefined variable config in readme",
"author_name": "Nathan Glenn",
"author_login": "garfieldnate",
"committed_at": "2024-05-13T17:23:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a26a60ba49dc79acee31fe0e605341fb22c146a9",
"body": "Fix this https://github.com/fralau/mkdocs-macros-plugin/issues/227\nThis commit is to set the encoding when open a file. It's useful for\nother characters set users.",
"is_bot": false,
"headline": "!B: fix encoding issue for other characters set",
"author_name": "caomingpei",
"author_login": "caomingpei",
"committed_at": "2024-05-09T09:48:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ec9bbb987856a83fb766caf06233e7218c5d905c",
"body": null,
"is_bot": false,
"headline": "Add missed modifications for #226",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-28T14:36:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d8a154c421bd9e3fb3dfacc2f57fb2b0b264d292",
"body": null,
"is_bot": false,
"headline": "Update doc for #226",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-27T18:56:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4f96dd5b56817275fa7d5597b4bbac394d07b20e",
"body": " - Generated a warning so as to make the build fail\n in strict mode (`mkdocs build --strict`)\n - Updated documentation of Advanced usage and Troubleshooting\n to clarify this.\n - Bumped revision number.",
"is_bot": false,
"headline": "Generate a Warning in case of variable/macro error (#226)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-04-27T18:52:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06834c6e881dcdaf8eb6e8cd5e41040deda86ebb",
"body": " - In the Advanced Usage page",
"is_bot": false,
"headline": "Update documentation for issue #215 (emojis in title)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-06T09:29:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "814205a64d7ee0d88bafefb8fa2df33ba9d7e886",
"body": " Files were missing",
"is_bot": false,
"headline": "Push of missing files for #215",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-02T16:03:01Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "da337b99b3053b04a012d3c4aec38944f20be92d",
"body": " - to prevent a problem in case pymdownx.emoji is being used",
"is_bot": false,
"headline": "Workaround for #215: do not render page title if no macro",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-03-02T14:18:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bf6c8e4cd0cb0dee9999103d44f18550aaeee82b",
"body": null,
"is_bot": false,
"headline": "Minor corrections to the documentation",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-20T10:04:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cfa03e7b24d883a36341b03a84c22beb06dd113d",
"body": " - `render_macros` in the YAML header has the last word\n - update `opt-in` test case\n - update documentation",
"is_bot": false,
"headline": "Correct management of opt-in",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-20T09:34:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "827943d5b857523eeffeef8f6d40231f06ad2be4",
"body": " - this is a mechanism that forces rendering of files\n for the case when `render_by_default` is set to `false`.\n - it uses a git-like syntax to define files to include",
"is_bot": false,
"headline": "Add `force_render_paths` parameter in config file (#204)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-19T15:20:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ef51c7afa22897ec7136b2dd5700a187fed985e8",
"body": null,
"is_bot": false,
"headline": "Fusion with local version",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-18T16:51:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "38ac286d1b16634d3fb848d8e3506c469404d7e6",
"body": "Fix typos and formatting",
"is_bot": false,
"headline": "Merge pull request #209 from alxgu/fix_typo",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-02-18T16:08:41Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c43e9c5240d9415a4c207002b1a4d5f40cbfb53",
"body": " - Now it is possible to specify to additional standard jinja2\n parameters, e.g.\n j2_comment_start_string: '[#'\n j2_comment_end_string: '#]'\n - Updated documentation\n - Updated `new_syntax` use case",
"is_bot": false,
"headline": "Add markers for alternative syntax (#208)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-17T10:21:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e844ea72c0c2e11852290a3b7a2e001cb368f520",
"body": null,
"is_bot": false,
"headline": "Bump version no",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-02-17T09:42:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2e0050c6ecee5ed62b29979536c6058cd49c9838",
"body": null,
"is_bot": false,
"headline": "Correct bold formatting",
"author_name": "Alex",
"author_login": "alxgu",
"committed_at": "2024-02-13T21:52:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d9a85566ad44390c653bea4290b6d3863c0e82db",
"body": null,
"is_bot": false,
"headline": "Fix some typos",
"author_name": "Alex",
"author_login": "alxgu",
"committed_at": "2024-02-13T21:46:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7368260754c65b74e582609d4cd7e38d30b05f7b",
"body": "Add link to wiki for pluglets",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2024-01-28T07:55:02Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2c80db2ccf30f9bd0c09e11e8deebfba275d93c5",
"body": " - The Jinja2 engine used for HTML templates is the\n standard one of MkDocs, and distinct from the\n macros engine.",
"is_bot": false,
"headline": "Add clarification in doc about HTML templates (#200)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-10T15:57:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8b0ad21432e7776198a26515cb2415a2778e5ac0",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-08T15:47:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8e7ae5c6af54114ffe2fdd19f3906e2666c07df5",
"body": " - clarification of examples in first page\n - fix all relative links, following clarification of link management in MkDocs",
"is_bot": false,
"headline": "Improvement in documentation + fix links",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2024-01-08T15:45:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f07146bbc3d317db38b903c4c282315682ccfd31",
"body": "Add example of escaping Handlebars definitions with `{% raw %}`",
"is_bot": false,
"headline": "Merge pull request #193 from oleg-nenashev/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-11-28T20:01:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eef2f23ad74d94b0fd807e924019cbc2c0a7f678",
"body": null,
"is_bot": false,
"headline": "Add example of escaping Handlebars definitions with `{% raw %}`",
"author_name": "Oleg Nenashev",
"author_login": "oleg-nenashev",
"committed_at": "2023-11-28T14:29:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5f72c156815aeb26d4bd48e69cedbd7e06b97616",
"body": " - Now any of the standard functions is accepted (but still files\n if none is found).\n - Error message is explicit.\n - Created the no_module test case to validate that the error is\n properly raised.",
"is_bot": false,
"headline": "Fix bug where `define_env()` is always required in main.py (#191)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-11-28T05:49:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7b71e2566f391af03f8ba9965645d701b0d37770",
"body": null,
"is_bot": false,
"headline": "Add requirement of 'packaging' module (#179)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-31T15:26:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4bfda0bd7efe070439aa5cecea3d3ca2d86375d2",
"body": " - It was a problem with include-markdown directive,\n between doc examples and the 'real' include of the changelog;\n solved it by changing the syntax of the 'real' include.\n - Updated changelog\n - Bumped version number",
"is_bot": false,
"headline": "Fix issue with changelog no longer displayed (#186)",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-31T15:13:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "82c5cdde6f40b2089db1edc6226b1041e7eb415f",
"body": "Add a short_tag attribute to git context",
"is_bot": false,
"headline": "Merge pull request #183 from marcospereira/add-short-tag",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-25T13:22:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "298f07f787b46faa5cc0adc98bd5606e5ac773f8",
"body": null,
"is_bot": false,
"headline": "Add a short_tag attribute to git context",
"author_name": "Marcos Pereira",
"author_login": "marcospereira",
"committed_at": "2023-10-20T15:18:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "428a0151a053f31e5d3bab4345e33c73bf050a08",
"body": null,
"is_bot": false,
"headline": "Remove include-markdown in webdoc, since it crashed readthedocs",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-10-16T14:41:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2161dd45c175e6a0c9fc495212f47b66c27bb2d3",
"body": "Needs a build key.",
"is_bot": false,
"headline": "Update .readthedocs.yml",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-16T14:25:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c64a08d4f8c42f9a6635a97cb88fadaa90a20b12",
"body": "Fix typo in `Rich Markdown Pages` docs",
"is_bot": false,
"headline": "Merge pull request #182 from SimonMarquis/patch-1",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-10-16T14:14:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1c1d2c44693a41874a99f3e8c93dc4d74c3932a3",
"body": null,
"is_bot": false,
"headline": "Fix typo in `Rich Markdown Pages` docs",
"author_name": "Simon Marquis",
"author_login": "SimonMarquis",
"committed_at": "2023-10-16T14:11:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9dba19e3ec0dfce7761eee32dfda4dca6cd312af",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-14T12:12:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7da70895975dc67074e352d811ffeb943b11240c",
"body": null,
"is_bot": false,
"headline": "Add experimental logo",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-14T12:09:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0d36ddee96d7c7ea2178d942b665d8eb620791f3",
"body": null,
"is_bot": false,
"headline": "Add experimental logo",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T08:31:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a035c9ff312a7436606215944d0059e77f680684",
"body": " - minor change to README page",
"is_bot": false,
"headline": "Improve first page of documentation with Mermaid diagrams",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T08:19:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "52f6a316844d1c838159daa023f67c6806a6b692",
"body": "…master",
"is_bot": false,
"headline": "Merge branch 'master' of github.com:fralau/mkdocs_macros_plugin into …",
"author_name": "Laurent Franceschetti",
"author_login": null,
"committed_at": "2023-08-13T06:36:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e5a5bb98d073c24a8015c5998757f2dc7da8f49b",
"body": "Add dependency info.",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-08-13T06:23:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "73cb068b78114d68b8e8a8f81ba9d3995233dbef",
"body": "Give a more user-friendly appearance.",
"is_bot": false,
"headline": "Update README.md",
"author_name": "Laurent Franceschetti",
"author_login": "fralau",
"committed_at": "2023-08-13T06:04:36Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 5,
"commits_last_year": 27,
"latest_release_at": "2024-11-03T09:25:47Z",
"latest_release_tag": "v1.3.7",
"releases_from_tags": false,
"days_since_last_push": 79,
"active_weeks_last_year": 8,
"days_since_latest_release": 625,
"mean_days_between_releases": 455
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 57,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "mkdocs-macros-plugin",
"exists": true,
"license": "MIT",
"keywords": [
"macros",
"markdown",
"mkdocs",
"python",
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Information Technology",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python",
"Programming Language :: Python :: 3 :: Only",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9"
],
"ecosystem": "pypi",
"matches_repo": false,
"registry_url": "https://pypi.org/project/mkdocs-macros-plugin/",
"is_deprecated": false,
"latest_version": "1.5.0",
"repository_url": "https://github.com/fralau/mkdocs_macros_plugin",
"versions_count": 38,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 2917195,
"first_published_at": "2018-09-11T13:44:39.001257Z",
"latest_published_at": "2025-11-13T08:08:55.545536Z",
"latest_version_yanked": null,
"days_since_latest_publish": 250
}
]
},
"popularity": {
"forks": 54,
"stars": 407,
"watchers": 6,
"fork_history": {
"days": [
{
"date": "2018-08-28",
"count": 1
},
{
"date": "2018-10-30",
"count": 1
},
{
"date": "2019-06-11",
"count": 1
},
{
"date": "2020-01-14",
"count": 1
},
{
"date": "2020-02-27",
"count": 1
},
{
"date": "2020-03-02",
"count": 1
},
{
"date": "2020-05-11",
"count": 1
},
{
"date": "2020-05-14",
"count": 1
},
{
"date": "2020-05-29",
"count": 1
},
{
"date": "2020-07-03",
"count": 1
},
{
"date": "2020-09-15",
"count": 1
},
{
"date": "2020-12-30",
"count": 1
},
{
"date": "2021-01-12",
"count": 1
},
{
"date": "2021-01-21",
"count": 1
},
{
"date": "2021-03-03",
"count": 1
},
{
"date": "2021-04-01",
"count": 1
},
{
"date": "2021-05-25",
"count": 1
},
{
"date": "2021-06-25",
"count": 1
},
{
"date": "2021-07-05",
"count": 1
},
{
"date": "2021-09-03",
"count": 1
},
{
"date": "2021-09-08",
"count": 1
},
{
"date": "2021-09-17",
"count": 1
},
{
"date": "2021-11-07",
"count": 1
},
{
"date": "2021-11-17",
"count": 1
},
{
"date": "2021-12-03",
"count": 1
},
{
"date": "2021-12-17",
"count": 1
},
{
"date": "2022-01-03",
"count": 1
},
{
"date": "2022-02-04",
"count": 1
},
{
"date": "2022-03-30",
"count": 1
},
{
"date": "2022-06-22",
"count": 1
},
{
"date": "2022-10-17",
"count": 1
},
{
"date": "2023-04-12",
"count": 1
},
{
"date": "2023-04-21",
"count": 1
},
{
"date": "2023-07-09",
"count": 1
},
{
"date": "2023-10-20",
"count": 1
},
{
"date": "2023-11-28",
"count": 1
},
{
"date": "2024-02-13",
"count": 2
},
{
"date": "2024-02-21",
"count": 1
},
{
"date": "2024-03-04",
"count": 1
},
{
"date": "2024-04-04",
"count": 1
},
{
"date": "2024-05-13",
"count": 1
},
{
"date": "2024-06-01",
"count": 1
},
{
"date": "2024-10-02",
"count": 1
},
{
"date": "2025-08-01",
"count": 1
},
{
"date": "2025-09-21",
"count": 1
},
{
"date": "2025-10-16",
"count": 1
},
{
"date": "2025-11-09",
"count": 1
},
{
"date": "2025-12-02",
"count": 1
},
{
"date": "2026-05-12",
"count": 1
},
{
"date": "2026-05-18",
"count": 1
},
{
"date": "2026-05-29",
"count": 1
}
],
"complete": true,
"collected": 52,
"total_forks": 54
},
"star_history": {
"days": [
{
"date": "2018-09-27",
"count": 1
},
{
"date": "2018-10-07",
"count": 1
},
{
"date": "2018-10-30",
"count": 1
},
{
"date": "2018-11-10",
"count": 1
},
{
"date": "2018-11-16",
"count": 1
},
{
"date": "2018-12-21",
"count": 1
},
{
"date": "2018-12-24",
"count": 1
},
{
"date": "2019-01-15",
"count": 1
},
{
"date": "2019-01-25",
"count": 1
},
{
"date": "2019-02-01",
"count": 2
},
{
"date": "2019-02-06",
"count": 1
},
{
"date": "2019-03-02",
"count": 1
},
{
"date": "2019-03-06",
"count": 1
},
{
"date": "2019-04-12",
"count": 1
},
{
"date": "2019-04-23",
"count": 1
},
{
"date": "2019-05-12",
"count": 1
},
{
"date": "2019-05-31",
"count": 1
},
{
"date": "2019-06-05",
"count": 1
},
{
"date": "2019-06-11",
"count": 1
},
{
"date": "2019-07-15",
"count": 1
},
{
"date": "2019-08-02",
"count": 1
},
{
"date": "2019-08-23",
"count": 1
},
{
"date": "2019-10-09",
"count": 1
},
{
"date": "2019-10-12",
"count": 1
},
{
"date": "2019-10-15",
"count": 1
},
{
"date": "2019-10-31",
"count": 1
},
{
"date": "2019-11-21",
"count": 1
},
{
"date": "2019-12-08",
"count": 1
},
{
"date": "2019-12-09",
"count": 1
},
{
"date": "2019-12-11",
"count": 1
},
{
"date": "2019-12-17",
"count": 1
},
{
"date": "2020-02-05",
"count": 1
},
{
"date": "2020-02-12",
"count": 1
},
{
"date": "2020-02-14",
"count": 1
},
{
"date": "2020-03-10",
"count": 1
},
{
"date": "2020-03-11",
"count": 1
},
{
"date": "2020-03-21",
"count": 1
},
{
"date": "2020-03-22",
"count": 1
},
{
"date": "2020-03-23",
"count": 1
},
{
"date": "2020-05-07",
"count": 1
},
{
"date": "2020-05-11",
"count": 1
},
{
"date": "2020-05-13",
"count": 1
},
{
"date": "2020-05-26",
"count": 1
},
{
"date": "2020-05-29",
"count": 1
},
{
"date": "2020-05-31",
"count": 1
},
{
"date": "2020-06-05",
"count": 1
},
{
"date": "2020-06-08",
"count": 1
},
{
"date": "2020-06-10",
"count": 1
},
{
"date": "2020-06-19",
"count": 1
},
{
"date": "2020-06-20",
"count": 1
},
{
"date": "2020-06-25",
"count": 1
},
{
"date": "2020-06-27",
"count": 1
},
{
"date": "2020-06-29",
"count": 1
},
{
"date": "2020-07-03",
"count": 1
},
{
"date": "2020-07-10",
"count": 1
},
{
"date": "2020-07-13",
"count": 1
},
{
"date": "2020-07-19",
"count": 1
},
{
"date": "2020-07-30",
"count": 1
},
{
"date": "2020-08-24",
"count": 1
},
{
"date": "2020-09-23",
"count": 1
},
{
"date": "2020-09-24",
"count": 1
},
{
"date": "2020-09-27",
"count": 1
},
{
"date": "2020-09-28",
"count": 1
},
{
"date": "2020-09-30",
"count": 1
},
{
"date": "2020-10-08",
"count": 1
},
{
"date": "2020-10-12",
"count": 1
},
{
"date": "2020-11-03",
"count": 1
},
{
"date": "2020-11-12",
"count": 1
},
{
"date": "2020-11-27",
"count": 1
},
{
"date": "2020-11-28",
"count": 1
},
{
"date": "2020-11-29",
"count": 1
},
{
"date": "2020-12-02",
"count": 1
},
{
"date": "2020-12-07",
"count": 1
},
{
"date": "2020-12-10",
"count": 1
},
{
"date": "2020-12-13",
"count": 1
},
{
"date": "2020-12-14",
"count": 1
},
{
"date": "2020-12-15",
"count": 1
},
{
"date": "2020-12-16",
"count": 1
},
{
"date": "2020-12-17",
"count": 1
},
{
"date": "2020-12-22",
"count": 1
},
{
"date": "2020-12-29",
"count": 1
},
{
"date": "2021-01-12",
"count": 1
},
{
"date": "2021-01-26",
"count": 1
},
{
"date": "2021-02-19",
"count": 1
},
{
"date": "2021-02-25",
"count": 2
},
{
"date": "2021-03-04",
"count": 1
},
{
"date": "2021-03-08",
"count": 1
},
{
"date": "2021-03-10",
"count": 2
},
{
"date": "2021-03-29",
"count": 1
},
{
"date": "2021-04-04",
"count": 1
},
{
"date": "2021-04-09",
"count": 1
},
{
"date": "2021-04-15",
"count": 1
},
{
"date": "2021-04-24",
"count": 2
},
{
"date": "2021-05-23",
"count": 1
},
{
"date": "2021-06-06",
"count": 1
},
{
"date": "2021-06-09",
"count": 1
},
{
"date": "2021-06-13",
"count": 1
},
{
"date": "2021-06-18",
"count": 1
},
{
"date": "2021-06-20",
"count": 1
},
{
"date": "2021-06-26",
"count": 1
},
{
"date": "2021-07-06",
"count": 1
},
{
"date": "2021-07-12",
"count": 1
},
{
"date": "2021-07-18",
"count": 1
},
{
"date": "2021-07-20",
"count": 1
},
{
"date": "2021-08-03",
"count": 1
},
{
"date": "2021-08-05",
"count": 1
},
{
"date": "2021-08-23",
"count": 1
},
{
"date": "2021-08-25",
"count": 1
},
{
"date": "2021-08-26",
"count": 1
},
{
"date": "2021-08-28",
"count": 1
},
{
"date": "2021-09-18",
"count": 1
},
{
"date": "2021-10-12",
"count": 1
},
{
"date": "2021-10-13",
"count": 1
},
{
"date": "2021-10-28",
"count": 1
},
{
"date": "2021-11-09",
"count": 1
},
{
"date": "2021-11-11",
"count": 1
},
{
"date": "2021-11-29",
"count": 1
},
{
"date": "2021-11-30",
"count": 1
},
{
"date": "2022-01-05",
"count": 1
},
{
"date": "2022-01-10",
"count": 1
},
{
"date": "2022-01-18",
"count": 1
},
{
"date": "2022-01-19",
"count": 1
},
{
"date": "2022-01-25",
"count": 1
},
{
"date": "2022-01-31",
"count": 1
},
{
"date": "2022-02-01",
"count": 1
},
{
"date": "2022-02-06",
"count": 1
},
{
"date": "2022-02-18",
"count": 1
},
{
"date": "2022-02-19",
"count": 1
},
{
"date": "2022-03-17",
"count": 1
},
{
"date": "2022-03-26",
"count": 1
},
{
"date": "2022-03-30",
"count": 1
},
{
"date": "2022-03-31",
"count": 1
},
{
"date": "2022-04-18",
"count": 1
},
{
"date": "2022-04-29",
"count": 1
},
{
"date": "2022-05-01",
"count": 1
},
{
"date": "2022-05-05",
"count": 1
},
{
"date": "2022-05-16",
"count": 1
},
{
"date": "2022-05-17",
"count": 1
},
{
"date": "2022-06-15",
"count": 1
},
{
"date": "2022-06-30",
"count": 1
},
{
"date": "2022-07-04",
"count": 1
},
{
"date": "2022-07-15",
"count": 1
},
{
"date": "2022-07-18",
"count": 2
},
{
"date": "2022-07-23",
"count": 1
},
{
"date": "2022-07-25",
"count": 1
},
{
"date": "2022-07-26",
"count": 1
},
{
"date": "2022-08-01",
"count": 1
},
{
"date": "2022-08-31",
"count": 1
},
{
"date": "2022-09-02",
"count": 1
},
{
"date": "2022-09-05",
"count": 1
},
{
"date": "2022-09-12",
"count": 1
},
{
"date": "2022-10-13",
"count": 1
},
{
"date": "2022-10-28",
"count": 1
},
{
"date": "2022-11-05",
"count": 1
},
{
"date": "2022-11-17",
"count": 3
},
{
"date": "2022-11-24",
"count": 1
},
{
"date": "2022-11-26",
"count": 1
},
{
"date": "2022-11-30",
"count": 1
},
{
"date": "2022-12-29",
"count": 1
},
{
"date": "2023-01-04",
"count": 1
},
{
"date": "2023-01-05",
"count": 1
},
{
"date": "2023-01-17",
"count": 1
},
{
"date": "2023-01-24",
"count": 1
},
{
"date": "2023-01-28",
"count": 1
},
{
"date": "2023-02-06",
"count": 1
},
{
"date": "2023-02-07",
"count": 1
},
{
"date": "2023-02-09",
"count": 1
},
{
"date": "2023-02-13",
"count": 1
},
{
"date": "2023-02-18",
"count": 1
},
{
"date": "2023-02-20",
"count": 1
},
{
"date": "2023-02-28",
"count": 1
},
{
"date": "2023-03-26",
"count": 2
},
{
"date": "2023-04-03",
"count": 1
},
{
"date": "2023-04-05",
"count": 1
},
{
"date": "2023-04-11",
"count": 1
},
{
"date": "2023-04-16",
"count": 2
},
{
"date": "2023-04-30",
"count": 1
},
{
"date": "2023-05-06",
"count": 1
},
{
"date": "2023-05-08",
"count": 1
},
{
"date": "2023-05-16",
"count": 1
},
{
"date": "2023-05-25",
"count": 1
},
{
"date": "2023-05-26",
"count": 1
},
{
"date": "2023-05-29",
"count": 1
},
{
"date": "2023-05-30",
"count": 1
},
{
"date": "2023-06-05",
"count": 1
},
{
"date": "2023-06-06",
"count": 1
},
{
"date": "2023-06-08",
"count": 1
},
{
"date": "2023-06-17",
"count": 1
},
{
"date": "2023-06-20",
"count": 1
},
{
"date": "2023-06-27",
"count": 1
},
{
"date": "2023-07-04",
"count": 1
},
{
"date": "2023-07-07",
"count": 1
},
{
"date": "2023-07-09",
"count": 2
},
{
"date": "2023-07-17",
"count": 1
},
{
"date": "2023-07-28",
"count": 1
},
{
"date": "2023-08-04",
"count": 1
},
{
"date": "2023-08-07",
"count": 2
},
{
"date": "2023-08-08",
"count": 1
},
{
"date": "2023-08-17",
"count": 1
},
{
"date": "2023-08-18",
"count": 1
},
{
"date": "2023-08-19",
"count": 2
},
{
"date": "2023-08-21",
"count": 1
},
{
"date": "2023-08-24",
"count": 1
},
{
"date": "2023-09-03",
"count": 2
},
{
"date": "2023-09-10",
"count": 1
},
{
"date": "2023-09-14",
"count": 1
},
{
"date": "2023-09-15",
"count": 2
},
{
"date": "2023-09-17",
"count": 1
},
{
"date": "2023-09-19",
"count": 1
},
{
"date": "2023-09-23",
"count": 1
},
{
"date": "2023-09-28",
"count": 1
},
{
"date": "2023-10-02",
"count": 1
},
{
"date": "2023-10-08",
"count": 1
},
{
"date": "2023-10-16",
"count": 2
},
{
"date": "2023-10-19",
"count": 1
},
{
"date": "2023-10-23",
"count": 1
},
{
"date": "2023-11-04",
"count": 1
},
{
"date": "2023-11-06",
"count": 1
},
{
"date": "2023-11-07",
"count": 1
},
{
"date": "2023-11-18",
"count": 1
},
{
"date": "2023-11-20",
"count": 1
},
{
"date": "2023-11-28",
"count": 1
},
{
"date": "2023-12-07",
"count": 1
},
{
"date": "2023-12-11",
"count": 1
},
{
"date": "2023-12-12",
"count": 3
},
{
"date": "2023-12-14",
"count": 1
},
{
"date": "2023-12-20",
"count": 1
},
{
"date": "2023-12-26",
"count": 1
},
{
"date": "2023-12-27",
"count": 1
},
{
"date": "2023-12-28",
"count": 1
},
{
"date": "2024-01-04",
"count": 1
},
{
"date": "2024-01-20",
"count": 1
},
{
"date": "2024-01-22",
"count": 1
},
{
"date": "2024-01-26",
"count": 1
},
{
"date": "2024-01-30",
"count": 1
},
{
"date": "2024-02-09",
"count": 1
},
{
"date": "2024-02-16",
"count": 1
},
{
"date": "2024-02-18",
"count": 1
},
{
"date": "2024-02-26",
"count": 1
},
{
"date": "2024-03-08",
"count": 1
},
{
"date": "2024-03-26",
"count": 1
},
{
"date": "2024-04-01",
"count": 11
},
{
"date": "2024-04-02",
"count": 4
},
{
"date": "2024-04-03",
"count": 3
},
{
"date": "2024-04-04",
"count": 1
},
{
"date": "2024-04-11",
"count": 1
},
{
"date": "2024-04-12",
"count": 1
},
{
"date": "2024-04-16",
"count": 1
},
{
"date": "2024-04-19",
"count": 1
},
{
"date": "2024-04-24",
"count": 1
},
{
"date": "2024-05-05",
"count": 1
},
{
"date": "2024-05-09",
"count": 1
},
{
"date": "2024-05-10",
"count": 1
},
{
"date": "2024-05-12",
"count": 1
},
{
"date": "2024-05-19",
"count": 1
},
{
"date": "2024-05-27",
"count": 1
},
{
"date": "2024-05-28",
"count": 1
},
{
"date": "2024-05-30",
"count": 1
},
{
"date": "2024-06-01",
"count": 1
},
{
"date": "2024-06-02",
"count": 1
},
{
"date": "2024-06-07",
"count": 1
},
{
"date": "2024-06-15",
"count": 1
},
{
"date": "2024-06-18",
"count": 1
},
{
"date": "2024-06-27",
"count": 1
},
{
"date": "2024-06-28",
"count": 1
},
{
"date": "2024-07-05",
"count": 1
},
{
"date": "2024-07-06",
"count": 1
},
{
"date": "2024-07-13",
"count": 1
},
{
"date": "2024-07-18",
"count": 1
},
{
"date": "2024-07-29",
"count": 1
},
{
"date": "2024-07-30",
"count": 2
},
{
"date": "2024-08-02",
"count": 1
},
{
"date": "2024-08-06",
"count": 1
},
{
"date": "2024-08-08",
"count": 1
},
{
"date": "2024-08-15",
"count": 1
},
{
"date": "2024-08-16",
"count": 1
},
{
"date": "2024-08-19",
"count": 1
},
{
"date": "2024-08-20",
"count": 1
},
{
"date": "2024-08-22",
"count": 1
},
{
"date": "2024-08-23",
"count": 1
},
{
"date": "2024-09-03",
"count": 1
},
{
"date": "2024-09-06",
"count": 1
},
{
"date": "2024-09-15",
"count": 1
},
{
"date": "2024-09-17",
"count": 1
},
{
"date": "2024-09-18",
"count": 1
},
{
"date": "2024-09-19",
"count": 1
},
{
"date": "2024-09-23",
"count": 1
},
{
"date": "2024-09-27",
"count": 1
},
{
"date": "2024-09-30",
"count": 1
},
{
"date": "2024-10-04",
"count": 1
},
{
"date": "2024-10-05",
"count": 1
},
{
"date": "2024-10-07",
"count": 1
},
{
"date": "2024-10-08",
"count": 1
},
{
"date": "2024-10-09",
"count": 1
},
{
"date": "2024-10-10",
"count": 1
},
{
"date": "2024-10-12",
"count": 1
},
{
"date": "2024-10-16",
"count": 1
},
{
"date": "2024-10-25",
"count": 2
},
{
"date": "2024-11-03",
"count": 1
},
{
"date": "2024-11-06",
"count": 1
},
{
"date": "2024-11-19",
"count": 1
},
{
"date": "2024-11-23",
"count": 1
},
{
"date": "2024-12-12",
"count": 1
},
{
"date": "2024-12-16",
"count": 1
},
{
"date": "2024-12-19",
"count": 1
},
{
"date": "2024-12-24",
"count": 1
},
{
"date": "2024-12-31",
"count": 1
},
{
"date": "2025-01-04",
"count": 1
},
{
"date": "2025-01-05",
"count": 1
},
{
"date": "2025-01-07",
"count": 1
},
{
"date": "2025-01-12",
"count": 1
},
{
"date": "2025-01-14",
"count": 1
},
{
"date": "2025-01-24",
"count": 2
},
{
"date": "2025-01-27",
"count": 1
},
{
"date": "2025-02-10",
"count": 1
},
{
"date": "2025-02-22",
"count": 1
},
{
"date": "2025-02-27",
"count": 1
},
{
"date": "2025-03-04",
"count": 1
},
{
"date": "2025-03-10",
"count": 1
},
{
"date": "2025-04-02",
"count": 1
},
{
"date": "2025-04-04",
"count": 1
},
{
"date": "2025-04-11",
"count": 2
},
{
"date": "2025-04-12",
"count": 1
},
{
"date": "2025-04-21",
"count": 1
},
{
"date": "2025-04-24",
"count": 1
},
{
"date": "2025-04-27",
"count": 1
},
{
"date": "2025-05-02",
"count": 1
},
{
"date": "2025-05-12",
"count": 1
},
{
"date": "2025-05-27",
"count": 1
},
{
"date": "2025-05-30",
"count": 1
},
{
"date": "2025-06-04",
"count": 1
},
{
"date": "2025-06-18",
"count": 1
},
{
"date": "2025-06-21",
"count": 1
},
{
"date": "2025-06-26",
"count": 1
},
{
"date": "2025-07-15",
"count": 1
},
{
"date": "2025-07-26",
"count": 1
},
{
"date": "2025-08-05",
"count": 1
},
{
"date": "2025-08-14",
"count": 1
},
{
"date": "2025-08-15",
"count": 2
},
{
"date": "2025-08-28",
"count": 1
},
{
"date": "2025-08-29",
"count": 1
},
{
"date": "2025-09-03",
"count": 1
},
{
"date": "2025-09-05",
"count": 1
},
{
"date": "2025-09-17",
"count": 1
},
{
"date": "2025-09-29",
"count": 1
},
{
"date": "2025-10-14",
"count": 1
},
{
"date": "2025-10-16",
"count": 1
},
{
"date": "2025-10-20",
"count": 1
},
{
"date": "2025-10-31",
"count": 1
},
{
"date": "2025-11-09",
"count": 1
},
{
"date": "2025-11-21",
"count": 1
},
{
"date": "2026-01-01",
"count": 1
},
{
"date": "2026-01-02",
"count": 1
},
{
"date": "2026-01-12",
"count": 1
},
{
"date": "2026-01-17",
"count": 1
},
{
"date": "2026-01-19",
"count": 1
},
{
"date": "2026-01-20",
"count": 1
},
{
"date": "2026-01-23",
"count": 1
},
{
"date": "2026-01-25",
"count": 1
},
{
"date": "2026-02-12",
"count": 3
},
{
"date": "2026-02-14",
"count": 1
},
{
"date": "2026-03-31",
"count": 1
},
{
"date": "2026-04-20",
"count": 1
},
{
"date": "2026-05-04",
"count": 1
},
{
"date": "2026-05-17",
"count": 1
},
{
"date": "2026-06-05",
"count": 1
},
{
"date": "2026-06-19",
"count": 1
}
],
"complete": true,
"collected": 406,
"total_stars": 407
},
"open_issues_and_prs": 5
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"mkdocs_macros/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 36133,
"source_files_sampled": 35,
"oversized_source_files": 0,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml",
"setup.py"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 24,
"assessed_package": "pypi:mkdocs-macros-plugin@1.5.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "hjson",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "jinja2",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "mkdocs",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.17"
},
{
"name": "packaging",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pathspec",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "python-dateutil",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pyyaml",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "super-collections",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">= 0.6.2"
},
{
"name": "termcolor",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "hjson",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "jinja2",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "packaging",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pathspec",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "python-dateutil",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pyyaml",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "requests",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "super-collections",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "termcolor",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-include-markdown-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-material",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mkdocs-mermaid2-plugin",
"direct": false,
"version": null,
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 13,
"direct_count": 10,
"indirect_count": 3
}
},
"maintainership": {
"issues": {
"open_prs": 1,
"merged_prs": 43,
"open_issues": 4,
"closed_ratio": 0.974,
"closed_issues": 149,
"closed_unmerged_prs": 18
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "fralau",
"commits": 84,
"avatar_url": "https://avatars.githubusercontent.com/u/36767124?v=4"
},
{
"type": "User",
"login": "eyllanesc",
"commits": 5,
"avatar_url": "https://avatars.githubusercontent.com/u/4896200?v=4"
},
{
"type": "User",
"login": "anatoly-scherbakov",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/2282888?v=4"
},
{
"type": "User",
"login": "honzajavorek",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/283441?v=4"
},
{
"type": "User",
"login": "jimporter",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/826865?v=4"
},
{
"type": "User",
"login": "timvink",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/5570380?v=4"
},
{
"type": "User",
"login": "alxgu",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/5547258?v=4"
},
{
"type": "User",
"login": "akhmerov",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/2069677?v=4"
},
{
"type": "User",
"login": "CrispyDrone",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/37639058?v=4"
},
{
"type": "User",
"login": "Bomberus",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/8161919?v=4"
}
],
"contributors_sampled": 34,
"top_contributor_share": 0.632
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"greetings.yml",
"test_push.yaml"
],
"has_docs_dir": false,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 0,
"reason": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 2/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 10,
"reason": "project has 3 contributing companies or organizations -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 9,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 0,
"reason": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "f4f5bb01e28f50e4f0ba697362b1973ae6d4b25d",
"ran_at": "2026-07-21T20:31:57Z",
"aggregate_score": 3.2,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/fralau/mkdocs-macros-plugin",
"host": "github.com",
"name": "mkdocs-macros-plugin",
"owner": "fralau"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 52,
"inputs": {
"security": 46,
"vitality": 39,
"community": 62,
"governance": 53,
"engineering": 59
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "at_risk",
"name": "Vitality",
"value": 39,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "at_risk",
"name": "Development activity",
"note": null,
"notes": [],
"value": 36,
"inputs": {
"commits_last_year": 27,
"human_commit_share": 1,
"days_since_last_push": 79,
"active_weeks_last_year": 8
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 79 days ago",
"points": 18,
"status": "partial",
"details": [
{
"code": "push_recency",
"params": {
"days": 79
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "8/52 weeks with commits",
"points": 5.5,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 8
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "27 commits in the last year",
"points": 13,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 27
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "at_risk",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 44,
"inputs": {
"releases_count": 5,
"latest_release_tag": "v1.3.7",
"releases_from_tags": false,
"days_since_latest_release": 625,
"mean_days_between_releases": 455
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "5 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 5
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 625 days ago",
"points": 7.2,
"status": "partial",
"details": [
{
"code": "release_recency",
"params": {
"days": 625
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~455 days",
"points": 5.4,
"status": "partial",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 455
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 79,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 79 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 79
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "moderate",
"name": "Community & Adoption",
"value": 62,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "moderate",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"forks": 54,
"stars": 407,
"watchers": 6,
"growth_state": "organic",
"growth_factor_pct": 100
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "407 stars",
"points": 42.3,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 407
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "54 forks",
"points": 14.4,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 54
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "6 watchers",
"points": 3.9,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 6
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "moderate",
"name": "Community health",
"note": null,
"notes": [],
"value": 64,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "license file present, not a recognized license",
"points": 16.9,
"status": "partial",
"details": [
{
"code": "license_custom",
"params": {}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 53,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 41,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 34,
"top_contributor_share": 0.632
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 63% of commits",
"points": 8.3,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 63
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "34 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 34
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 3 contributing companies or organizations -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 72,
"inputs": {
"merged_prs": 43,
"open_issues": 4,
"closed_issues": 149,
"issue_closed_ratio": 0.974,
"closed_unmerged_prs": 18
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "97% of issues closed",
"points": 45.5,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 97
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "43/61 decided PRs merged",
"points": 27,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 43,
"decided": 61
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 2/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 50,
"inputs": {
"followers": 24,
"owner_type": "User",
"is_verified": null,
"owner_login": "fralau",
"public_repos": 13,
"account_age_days": 3070
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "24 followers of fralau",
"points": 10.1,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 24,
"login": "fralau"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "13 public repos, account ~8 yr old",
"points": 20.3,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 13
}
},
{
"code": "account_age_years",
"params": {
"years": 8
}
}
],
"max_points": 25
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "moderate",
"name": "Engineering Quality",
"value": 59,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "at_risk",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 48,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "2 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 2
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "good",
"name": "Documentation",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"topics": [
"python",
"mkdocs",
"markdown",
"jinja2-templates",
"jinja2",
"documentation",
"mkdocs-macros-plugin",
"automation"
],
"has_wiki": true,
"homepage": "https://mkdocs-macros-plugin.readthedocs.io",
"has_readme": true,
"has_docs_dir": false,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://mkdocs-macros-plugin.readthedocs.io",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "8 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 8
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 46,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 32,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 3.2
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "0 out of 2 merged PRs checked by a CI test -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 2/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 3 contributing companies or organizations -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:mkdocs-macros-plugin@1.5.0 runtime dependency closure — what installing the published package pulls in — 24 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:mkdocs-macros-plugin@1.5.0",
"assessed": 24
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 24,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 24,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 17
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 41,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 32,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.59,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "59 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 31.5,
"status": "partial",
"details": [
{
"code": "legible_history",
"params": {
"legible": 59,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 33,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"mkdocs_macros/py.typed"
],
"agent_commit_share": 0,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "mkdocs_macros/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "mkdocs_macros/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 100",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 36133,
"source_files_sampled": 35,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (mkdocs_macros/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "mkdocs_macros/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/35 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 35,
"oversized": 0
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"pypi package 'mkdocs-macros-plugin' points at a different repository (https://github.com/fralau/mkdocs_macros_plugin); excluded from ecosystem scoring"
],
"report_type": "repository",
"generated_at": "2026-07-21T20:32:16.313632Z",
"schema_version": "0.23.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/f/fralau/mkdocs-macros-plugin.svg",
"full_name": "fralau/mkdocs-macros-plugin",
"license_state": "custom",
"license_spdx": null
}Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.23.0 — full methodology · metrics wiki.
How one result sits in the wider record: aggregate statistics — PyPI.