GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — cpp-tree/cpp_tree/curriculum.py at main · RidaCode/cpp-tree

Expand file tree

/

curriculum.py

Copy path
More file actions
More file actions

Latest commit

 

History

History
History
118 lines (103 loc) · 4.22 KB
/

curriculum.py

Copy path

File metadata and controls

118 lines (103 loc) · 4.22 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
"""Load the bundled outline. Lesson keys remain stable across releases."""
from __future__ import annotations
import json
from importlib.resources import files
from typing import cast
from urllib.parse import urlsplit
from .models import Chapter
GROUPS = ("main", "side", "archive")
GROUP_LABELS = {"main": "MAIN TREE", "side": "SIDE QUESTS", "archive": "ARCHIVE"}
def validate_curriculum(raw: object) -> list[Chapter]:
"""Reject broken links, duplicates, and invalid shapes before building indexes."""
if not isinstance(raw, list) or not raw:
raise ValueError("curriculum must be a nonempty list")
chapters: set[str] = set()
lessons: set[str] = set()
groups: set[str] = set()
for chapter in raw:
if not isinstance(chapter, dict):
raise ValueError("each chapter must be an object")
for field in ("id", "title", "group"):
if not isinstance(chapter.get(field), str) or not chapter[field]:
raise ValueError(f"chapter needs a nonempty {field}")
if chapter["id"] in chapters or chapter["group"] not in GROUPS:
raise ValueError("duplicate chapter ID or unknown group")
chapters.add(chapter["id"])
groups.add(chapter["group"])
entries = chapter.get("lessons")
if not isinstance(entries, list) or not entries:
raise ValueError("chapters must contain lessons")
for lesson in entries:
if not isinstance(lesson, dict):
raise ValueError("each lesson must be an object")
for field in ("id", "key", "title", "url"):
if not isinstance(lesson.get(field), str) or not lesson[field]:
raise ValueError(f"lesson needs a nonempty {field}")
if lesson["key"] != f"{chapter['id']}:{lesson['id']}":
raise ValueError("lesson key must match its chapter and lesson IDs")
if lesson["key"] in lessons:
raise ValueError("duplicate lesson key")
lessons.add(lesson["key"])
if "note" in lesson and not isinstance(lesson["note"], str):
raise ValueError("outline notes must be text")
url = urlsplit(lesson["url"])
if (
url.scheme != "https"
or url.netloc != "www.learncpp.com"
or not url.path.startswith("/cpp-tutorial/")
):
raise ValueError("lesson URL must be a LearnCpp HTTPS article")
if groups != set(GROUPS):
raise ValueError("each navigation group must contain a chapter")
return cast(list[Chapter], raw)
CURRICULUM = validate_curriculum(
json.loads(
files("cpp_tree").joinpath("data").joinpath("learncpp.json").read_text(encoding="utf-8")
)
)
CHAPTERS = {c["id"]: c for c in CURRICULUM}
LESSONS = {l["key"]: l for c in CURRICULUM for l in c["lessons"]}
LESSON_CHAPTERS = {l["key"]: c for c in CURRICULUM for l in c["lessons"]}
SHORT = {
"0": "The starting zone",
"1": "C++ basics",
"2": "Functions & files",
"3": "The debugger",
"4": "Fundamental types",
"5": "Constants & strings",
"6": "Operators",
"O": "Bit manipulation",
"7": "Scope & linkage",
"8": "Control flow",
"9": "Error detection",
"10": "Conversions & auto",
"11": "Overloads & templates",
"F": "Constexpr functions",
"12": "References & pointers",
"13": "Enums & structs",
"14": "Classes",
"15": "More on classes",
"16": "Dynamic arrays",
"17": "Fixed-size arrays",
"18": "Iterators & algorithms",
"19": "Dynamic allocation",
"20": "Functions",
"21": "Operator overloading",
"22": "Move & smart pointers",
"23": "Object relationships",
"24": "Inheritance",
"25": "Virtual functions",
"26": "Templates & classes",
"27": "Exceptions",
"28": "Input & output",
"A": "Libraries & FAQ",
"B": "C++ updates",
"C": "The end?",
"D": "Deprecated articles",
}
def group_chapters(group: str) -> list[Chapter]:
return [c for c in CURRICULUM if c["group"] == group]
def group_keys(group: str) -> list[str]:
return [l["key"] for c in group_chapters(group) for l in c["lessons"]]
def chapter_keys(chapter: Chapter) -> set[str]:
return {l["key"] for l in chapter["lessons"]}
You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.