Read data from naučse.python.cz

[messa]

Naučse will provide API with

• course and lesson structure: API se seznamem lekcí a materiálů pyvec/naucse.python.cz#431
• homework data (probably JSON endpoint with rendered homework HTML and metadata)

Ideally this courseware should be pluggable to any lesson and homework data provider with similar API.

[messa]

Nejsem úplně rozhodnutý, jestli do naučse přesouvat i domácí úkoly :) Ale strukturu kurzu a odkazy na materiály by byly fajn z naučse přes to API.

[messa]

Něco se děje :) pyvec/naucse.python.cz#494

[messa]

Naučse PR s implementací API: pyvec/naucse.python.cz#505 (je tam i dump v0.tar.gz ke stažení)

Změny, které by bylo vhodné udělat tady v courseware:

• terminologie:
  • co zde v cw je "lesson", se v naučse jmenuje "session"
  • naučse "lesson" je vlastně "material" uvnitř "session" ("A material may be for a lesson (or an external link)")
• domácí úkoly by se mohly linkovat na lesson_slug a pak by se do "sessions" agregovaly podle toho, jak jsou ty sessions poskládané z lessons v naučse
  • může nastat nepravděpodobný krajní případ, že ta jedna lesson (lesson_slog) bude ve více sessions
• v naučse je ten forkovací mechanismus a asi není dobrý nápad z toho naučse API nějak odvozovat/předpokládat jakékoli vztahy mezi věcmi (hlavně lessons) z různých kurzů
  • i tady v CW je ale potřeba nějak řešit, aby se archivní věci už neměnily (zatím asi kopírováním, proto je v názvu adresáře shared_2018_podzim letopočet),
  • a např. Brno mohlo mít ke stejnému lesson id (lesson_slug) něco jiného, než Praha
• možná prozkoumat to $ref, jestli by to nebylo zajímavější, než je linkování do jiných souborů udělané teď

A samozřejmě ujasnit terminologii, jestli samotnému domácímu úkolu říkat homework, task nebo project 🙂 (koneckonců, přejmenovávalo se to z ukoly.pyladies.cz na projekty.pyladies.cz)

[messa]

Naučse API je nasazené! 🎉 https://naucse.python.cz/v0/naucse.json

Dále viz https://github.com/pyvec/naucse.python.cz/issues/512

[messa]

A samozřejmě ujasnit terminologii, jestli samotnému domácímu úkolu říkat homework, task nebo project 🙂 (koneckonců, přejmenovávalo se to z ukoly.pyladies.cz na projekty.pyladies.cz)

Tak jsem všude v kódu přejmenoval homework na task. (V databázi už stejně byly taskSolutions.)

• 0fcb200
• 7c57e50

[messa]

Přejmenováno, aby kód v courseware odpovídal terminologii naučse (a navíc ho to trochu pročistilo):

• lesson na session (e9b495f)
• lesson item na material item (e205d8e)

[messa]

K uzavření tohoto issue ještě zbývá dořešit (naimplementovat) mapování tasků ("domácích úkolů") k příslušným sessions.

[messa]

Mapování tasků ("domácích úkolů") k příslušným sessions pomocí naučse lessons: #49