Solidity Lang APIsoliditylang.org ↗

"""Walkthrough: Solidity SDK — documentation, blog, and compiler bug queries."""
from parse_apis.solidity_documentation___blog_api import (
    Solidity, BlogCategory, ResourceNotFound, DocHome, BugIndex
)

solidity = Solidity()

# Get the documentation home page with table of contents
home = solidity.dochomes.get(version="latest")
print(home.title, home.version)
for entry in home.toc[:3]:
    print(entry.title, entry.slug)

# Construct a version and search its pages for a topic
latest = solidity.docversion(slug="latest")
for result in latest.pages.search(query="mapping", limit=3):
    print(result.title, result.path)

# Get a specific documentation page from that version
page = latest.pages.get(slug="types")
print(page.title, page.version)
for heading in page.headings[:3]:
    print(heading.level, heading.text)

# List blog posts filtered by category using the enum
for post in solidity.blogposts.list(category=BlogCategory.RELEASES, limit=3):
    print(post.title, post.date, post.author)

# Get a specific blog post detail with typed error handling
try:
    detail = solidity.blogpostdetails.get(year="2026", month="04", day="29", slug="solidity-0.8.35-release-announcement")
    print(detail.title, detail.date, detail.category)
except ResourceNotFound as exc:
    print(f"Blog post not found: {exc.slug}")

# List known compiler bugs
for bug in solidity.bugs.list(limit=3):
    print(bug.uid, bug.name, bug.severity, bug.introduced, bug.fixed)

# Get the full bugs-by-version index
index = solidity.bugindexes.get()
print(type(index.versions))

print("exercised: dochomes.get / pages.search / pages.get / blogposts.list / blogpostdetails.get / bugs.list / bugindexes.get")