The Odin Project APItheodinproject.com ↗

"""Walkthrough: The Odin Project SDK — bounded, re-runnable; every call capped."""
from parse_apis.the_odin_project_api import OdinProject, PathSlug, ResourceNotFound

client = OdinProject()

# List all available learning paths
for path in client.paths.list(limit=5):
    print(path.title, path.slug, path.course_count)

# Get a specific path by slug enum, then list its courses
foundations = client.paths.get(slug=PathSlug.FOUNDATIONS)
first_course = foundations.courses.list(limit=1).first()

# Drill into the course: get full details with sections
if first_course:
    detail = first_course.details()
    print(detail.title, detail.description[:80])
    for section in detail.sections[:2]:
        print(section.name)
        for lesson in section.lessons[:3]:
            print(lesson.title, lesson.type, lesson.slug)

    # List all lessons for the course
    for ls in first_course.lessons.list(limit=5):
        print(ls.title, ls.type, ls.section)

    # List projects in the course
    for proj in first_course.projects.list(limit=3):
        print(proj.title, proj.slug, proj.type)

# Search lessons by keyword
for match in client.paths.search_lessons(query="html", limit=3):
    print(match.title, match.slug, match.path, match.course)

# Get full lesson content and sub-operations
lesson = client.lessons.get(slug="introduction-to-html-and-css")
print(lesson.title, lesson.course, lesson.github_edit_url)
for q in lesson.knowledge_check[:2]:
    print(q)

# Get lesson resources
res = lesson.resources()
for link in res.all_links[:3]:
    print(link.title, link.url, link.section)

# Get lesson changelog
cl = lesson.changelog()
print(cl.lesson_title, cl.changelog_url)

# Typed error handling
try:
    client.lessons.get(slug="nonexistent-lesson-slug-xyz")
except ResourceNotFound as exc:
    print(f"not found: {exc}")

print("exercised: paths.list / paths.get / courses.list / details / lessons.list / projects.list / search_lessons / lessons.get / resources / changelog")