Skip to content

docs(readme): a Python example that runs - #97

Merged
jfrench9 merged 1 commit into
mainfrom
chore/readme-python-snippet
Oct 5, 2026
Merged

jfrench9 merged 1 commit into
mainfrom
chore/readme-python-snippet

Conversation

@jfrench9

@jfrench9 jfrench9 commented Oct 5, 2026

Copy link
Copy Markdown
Member

Summary

  • The library snippet couldn't run. It passed a filing_meta it never defined. It now loads through FilingSession, which xbrlkit.serve declares as API. That session resolves a ticker, "NVDA 10-Q", cik:accession, lei: or a path the way view and serve do, and needs no extra installed. Serializing to holon and TAVI and the from_holon_json round trip are unchanged.
  • The Arelle-level pair keeps one sentence: load_model → to_xbrl_model(mx, filing) given a FilingMeta, for a host running its own Arelle.
  • Install now lists view among the CLI commands.

The new snippet matches the /python page in xbrlkit-viewer (RoboFinSystems/xbrlkit-viewer#105).

Test plan

  • Ran the snippet exactly as written against this checkout with no extras: NVIDIA 10-K, 1,219 facts, round trip through holon intact
  • Pre-commit gate: ruff, format, basedpyright, pytest (696 passed, 2 skipped)
  • tests/test_server_json.py (reads the README's registry line) passes

🤖 Generated with Claude Code

The library snippet passed a `filing_meta` it never defined, so it could not
run as written. It now loads through FilingSession, which resolves a ticker,
accession, LEI or path the way `view` and `serve` do and needs no extra, and
names the Arelle-level load_model / to_xbrl_model pair for a host with its
own Arelle. The CLI list in Install also gains `view`.
@jfrench9
jfrench9 merged commit 8028986 into main Oct 5, 2026
4 checks passed
@jfrench9
jfrench9 deleted the chore/readme-python-snippet branch October 5, 2026 01:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant