monash-study-kit 1.7.0__tar.gz → 1.8.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. monash_study_kit-1.8.0/.gitignore +13 -0
  2. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/CHANGELOG.md +9 -0
  3. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/PKG-INFO +8 -1
  4. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/README.md +7 -0
  5. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/README.zh-CN.md +7 -0
  6. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/__init__.py +1 -1
  7. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/cli.py +72 -0
  8. monash_study_kit-1.8.0/src/monash_study_kit/export.py +246 -0
  9. monash_study_kit-1.8.0/src/monash_study_kit/location.py +182 -0
  10. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/paths.py +19 -2
  11. monash_study_kit-1.8.0/tests/test_course_export.py +141 -0
  12. monash_study_kit-1.8.0/tests/test_location.py +98 -0
  13. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_security.py +20 -0
  14. monash_study_kit-1.7.0/.gitignore +0 -7
  15. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/ISSUE_TEMPLATE/bug_report.yml +0 -0
  16. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/ISSUE_TEMPLATE/config.yml +0 -0
  17. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/ISSUE_TEMPLATE/feature_request.yml +0 -0
  18. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/pull_request_template.md +0 -0
  19. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/workflows/release.yml +0 -0
  20. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/.github/workflows/test.yml +0 -0
  21. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/CODE_OF_CONDUCT.md +0 -0
  22. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/CONTRIBUTING.md +0 -0
  23. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/LICENSE +0 -0
  24. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/PRIVACY.md +0 -0
  25. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/SECURITY.md +0 -0
  26. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/SECURITY-REVIEW-1.5-SCOPE.md +0 -0
  27. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/adr/0001-one-shared-core.md +0 -0
  28. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/adr/0002-read-only-public-package.md +0 -0
  29. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/adr/0003-release-from-a-tag.md +0 -0
  30. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/adr/0004-confirmed-mail-and-attendance-actions.md +0 -0
  31. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/adr/README.md +0 -0
  32. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/gmail-foundation.md +0 -0
  33. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/google-and-attendance-setup.md +0 -0
  34. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/panels-library-remote.md +0 -0
  35. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/releasing.md +0 -0
  36. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/screenshots/todo.png +0 -0
  37. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/docs/security.md +0 -0
  38. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/glama.json +0 -0
  39. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/pyproject.toml +0 -0
  40. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/scripts/check_dist.py +0 -0
  41. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/scripts/measure_tokens.py +0 -0
  42. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/scripts/smoke_test.py +0 -0
  43. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/skills/monash-study-kit/SKILL.md +0 -0
  44. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/__main__.py +0 -0
  45. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance.py +0 -0
  46. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_assets/PROVENANCE.md +0 -0
  47. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_assets/extract-rows.js +0 -0
  48. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_assets/shared.js +0 -0
  49. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_auto.py +0 -0
  50. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_evidence.py +0 -0
  51. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/attendance_http.py +0 -0
  52. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/browser_login.py +0 -0
  53. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/cdp.py +0 -0
  54. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/claude_setup.py +0 -0
  55. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/cli_attendance.py +0 -0
  56. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/cli_ed.py +0 -0
  57. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/cli_gmail.py +0 -0
  58. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/clients.py +0 -0
  59. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/content_index.py +0 -0
  60. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/doctor.py +0 -0
  61. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/doctor_deep.py +0 -0
  62. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/edexport.py +0 -0
  63. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/edlib.py +0 -0
  64. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/edquery.py +0 -0
  65. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/edsync.py +0 -0
  66. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/features.py +0 -0
  67. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/gmail.py +0 -0
  68. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/gmail_tools.py +0 -0
  69. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/google_client.json +0 -0
  70. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/help_menu.py +0 -0
  71. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/htmldom.py +0 -0
  72. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/jobs.py +0 -0
  73. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/lesson_reader.py +0 -0
  74. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/lessons.py +0 -0
  75. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/library.py +0 -0
  76. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/mcp_server.py +0 -0
  77. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/moodlelib.py +0 -0
  78. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/output.py +0 -0
  79. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/recordings.py +0 -0
  80. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/remote.py +0 -0
  81. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/semester.py +0 -0
  82. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/service_actions.py +0 -0
  83. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/service_jobs.py +0 -0
  84. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/service_setup.py +0 -0
  85. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/student_services.py +0 -0
  86. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/student_tools.py +0 -0
  87. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/syncer.py +0 -0
  88. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/textextract.py +0 -0
  89. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/todo.py +0 -0
  90. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/transcribe.py +0 -0
  91. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/ui/panel.html +0 -0
  92. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/update_check.py +0 -0
  93. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/webnotes.py +0 -0
  94. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/src/monash_study_kit/widgets.py +0 -0
  95. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/conftest.py +0 -0
  96. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_attendance_browser.py +0 -0
  97. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_attendance_fast.py +0 -0
  98. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_attendance_parity.py +0 -0
  99. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_cdp.py +0 -0
  100. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_cli.py +0 -0
  101. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_clients.py +0 -0
  102. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_content_index.py +0 -0
  103. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_doctor.py +0 -0
  104. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_doctor_deep.py +0 -0
  105. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_ed_auth.py +0 -0
  106. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_ed_export.py +0 -0
  107. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_ed_markdown.py +0 -0
  108. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_ed_query.py +0 -0
  109. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_ed_quiz.py +0 -0
  110. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_feature_cli.py +0 -0
  111. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_features.py +0 -0
  112. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_gmail.py +0 -0
  113. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_help_menu.py +0 -0
  114. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_layout.py +0 -0
  115. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_lesson_reader.py +0 -0
  116. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_library.py +0 -0
  117. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_mcp.py +0 -0
  118. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_panels.py +0 -0
  119. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_recordings.py +0 -0
  120. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_remote.py +0 -0
  121. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_removed_files.py +0 -0
  122. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_semester.py +0 -0
  123. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_service_setup.py +0 -0
  124. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_setup.py +0 -0
  125. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_shared_core.py +0 -0
  126. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_skill.py +0 -0
  127. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_student_gmail.py +0 -0
  128. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_student_tools.py +0 -0
  129. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_sync_robustness.py +0 -0
  130. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_todo.py +0 -0
  131. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_update_check.py +0 -0
  132. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_webnotes.py +0 -0
  133. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/tests/test_without_ed.py +0 -0
  134. {monash_study_kit-1.7.0 → monash_study_kit-1.8.0}/uv.lock +0 -0
@@ -0,0 +1,13 @@
1
+ __pycache__/
2
+ *.pyc
3
+ .venv/
4
+ .pytest_cache/
5
+ dist/
6
+ build/
7
+ *.egg-info/
8
+ .DS_Store
9
+ .ruff_cache/
10
+ # 凭据和课程资料一律不进仓库
11
+ *.token
12
+ *-token.json
13
+ client_secret*.json
@@ -2,6 +2,15 @@
2
2
 
3
3
  Version numbers follow `__version__` in `src/monash_study_kit/__init__.py`: patch for bug fixes, minor for new features.
4
4
 
5
+ ## 1.8.0
6
+
7
+ One export for a whole unit, and this package is now the only copy of the Moodle, Ed, Google and attendance code (the author's private server deployment depends on it instead of carrying its own copies).
8
+
9
+ - `monash export FIT1043` (`--to`, `--dir`, `--open`, `--json`) writes a unit's course materials into one zip (or folder): `Moodle/` with the synced files and a `links.md` per folder, `Ed Lessons/` with files, `Links.md` and a `Quiz.md` (questions only) per lesson, and a `README.md` index. The index lists what was not exported and why: a file missing on disk, an Ed file that failed to download, or an Ed unit that was never synced because it is not tracked or not in your Ed course list. It reads only local data and leaves out Ed posts, submissions, grades, feedback, mail, messages and attendance.
10
+ - Meeting passwords (`pwd=`, `passcode=` and similar) are removed from links in the export.
11
+ - Choose where the data lives. The first `monash setup` asks, listing each drive with its free space (another drive is recommended when C: has under 5 GB free). `monash move D:\MonashStudyKit` moves course files, database, logins and settings in one go; the default folder then keeps only a `location.json` pointer. `MONASH_KIT_HOME` still overrides both.
12
+ - A test now fails if a server path (`/opt/`, `/root/`, `/srv/`) appears anywhere in the package or its docs.
13
+
5
14
  ## 1.7.0
6
15
 
7
16
  This is also the first release on PyPI with the 1.6.0 changes below (the local semester week view and private calendar export); 1.6.0 was never published on its own.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: monash-study-kit
3
- Version: 1.7.0
3
+ Version: 1.8.0
4
4
  Summary: Connect Monash Moodle and Ed to Claude, Codex, Cursor or any local MCP client via a local MCP server and CLI: deadlines, announcements, grades, full-text search over course materials and Ed posts, all on your own machine.
5
5
  Project-URL: Homepage, https://github.com/Waldo0926/monash-study-kit
6
6
  Project-URL: Issues, https://github.com/Waldo0926/monash-study-kit/issues
@@ -345,6 +345,8 @@ The file is [`skills/monash-study-kit/SKILL.md`](skills/monash-study-kit/SKILL.m
345
345
  - macOS: `~/Library/Application Support/monash-study-kit`
346
346
  - Windows: `%LOCALAPPDATA%\monash-study-kit`
347
347
 
348
+ That is only the default. The first `monash setup` asks where to keep the data and lists each drive with its free space; if C: has less than 5 GB free it recommends another drive. To move everything later (course files, database, logins, settings): close your AI apps, then `monash move D:\MonashStudyKit`. When the data lives elsewhere, the default folder keeps only a small `location.json` that points to it, and you do not need to log in again.
349
+
348
350
  It contains course files (`files`), the database (`data`), login credentials (`secrets`, readable only by your own user account) and the dedicated login window's profile (`browser-profile`).
349
351
  Run `monash open` to open the course-files folder, or `monash open ed` for Ed Lessons files (in `data/ed-files`, by unit code).
350
352
  - **Stored credentials**: the Moodle session cookie, the Ed API token and the Moodle calendar subscription link. They stay on your computer and are only used to talk to Moodle / Ed.
@@ -418,6 +420,7 @@ You can also query directly in the terminal without any AI:
418
420
  | `monash ed lessons FIT2109` / `quiz FIT2109` | Ed lesson progress / quiz questions (for revision) |
419
421
  | `monash ed read FIT2109 "W3 Pre-Class"` | A whole lesson as Markdown: text slides, reading pages and PDFs in order, plus its quiz questions |
420
422
  | `monash ed export FIT2109 [--module "Week 3"] [--open]` | Zip a unit's Ed materials by week into Downloads |
423
+ | `monash export FIT1043 [--dir] [--open]` | Export a unit's course materials (Moodle + Ed Lessons) with an index of what was left out and why |
421
424
  | `monash config` | View / change settings (restart your AI app afterwards) |
422
425
  | `monash connect [client]` | Connect to Codex, Cursor, VS Code, Windsurf or Gemini CLI (see [Other AI clients](#other-ai-clients)) |
423
426
  | `monash remote serve` / `pair` / `clients` / `revoke` | Optional remote MCP for ChatGPT and Claude on the web ([Host it yourself](https://docs.secureview.tech/study-kit/remote/)) |
@@ -508,6 +511,10 @@ Install Chrome or Edge. If your browser lives somewhere unusual, point to it:
508
511
  By default Windows limits full paths to 260 characters, and unit name + week name + file name can exceed that. Store course files somewhere shorter:
509
512
  `monash config files_dir C:\Monash`, then `monash sync`.
510
513
 
514
+ ### My C: drive is full
515
+
516
+ Move all of the kit's data to another drive with `monash move D:\MonashStudyKit` (close Claude and other AI apps first). The program itself is small; if you also want uv and Python off C:, set `UV_TOOL_DIR`, `UV_PYTHON_INSTALL_DIR` and `UV_CACHE_DIR` to folders on another drive before installing.
517
+
511
518
  ### My units don't use Ed
512
519
 
513
520
  That's fine: deadlines, grades, course files, search, mail and attendance work without it. When `monash setup` asks for the Ed token, press Enter to skip and answer yes to "not using Ed". Or run `monash config use_ed false` at any time. After that sync, the to-do list and `monash doctor` stop mentioning Ed, and your AI app no longer lists the Ed tools. `monash login ed` turns it back on.
@@ -309,6 +309,8 @@ The file is [`skills/monash-study-kit/SKILL.md`](skills/monash-study-kit/SKILL.m
309
309
  - macOS: `~/Library/Application Support/monash-study-kit`
310
310
  - Windows: `%LOCALAPPDATA%\monash-study-kit`
311
311
 
312
+ That is only the default. The first `monash setup` asks where to keep the data and lists each drive with its free space; if C: has less than 5 GB free it recommends another drive. To move everything later (course files, database, logins, settings): close your AI apps, then `monash move D:\MonashStudyKit`. When the data lives elsewhere, the default folder keeps only a small `location.json` that points to it, and you do not need to log in again.
313
+
312
314
  It contains course files (`files`), the database (`data`), login credentials (`secrets`, readable only by your own user account) and the dedicated login window's profile (`browser-profile`).
313
315
  Run `monash open` to open the course-files folder, or `monash open ed` for Ed Lessons files (in `data/ed-files`, by unit code).
314
316
  - **Stored credentials**: the Moodle session cookie, the Ed API token and the Moodle calendar subscription link. They stay on your computer and are only used to talk to Moodle / Ed.
@@ -382,6 +384,7 @@ You can also query directly in the terminal without any AI:
382
384
  | `monash ed lessons FIT2109` / `quiz FIT2109` | Ed lesson progress / quiz questions (for revision) |
383
385
  | `monash ed read FIT2109 "W3 Pre-Class"` | A whole lesson as Markdown: text slides, reading pages and PDFs in order, plus its quiz questions |
384
386
  | `monash ed export FIT2109 [--module "Week 3"] [--open]` | Zip a unit's Ed materials by week into Downloads |
387
+ | `monash export FIT1043 [--dir] [--open]` | Export a unit's course materials (Moodle + Ed Lessons) with an index of what was left out and why |
385
388
  | `monash config` | View / change settings (restart your AI app afterwards) |
386
389
  | `monash connect [client]` | Connect to Codex, Cursor, VS Code, Windsurf or Gemini CLI (see [Other AI clients](#other-ai-clients)) |
387
390
  | `monash remote serve` / `pair` / `clients` / `revoke` | Optional remote MCP for ChatGPT and Claude on the web ([Host it yourself](https://docs.secureview.tech/study-kit/remote/)) |
@@ -472,6 +475,10 @@ Install Chrome or Edge. If your browser lives somewhere unusual, point to it:
472
475
  By default Windows limits full paths to 260 characters, and unit name + week name + file name can exceed that. Store course files somewhere shorter:
473
476
  `monash config files_dir C:\Monash`, then `monash sync`.
474
477
 
478
+ ### My C: drive is full
479
+
480
+ Move all of the kit's data to another drive with `monash move D:\MonashStudyKit` (close Claude and other AI apps first). The program itself is small; if you also want uv and Python off C:, set `UV_TOOL_DIR`, `UV_PYTHON_INSTALL_DIR` and `UV_CACHE_DIR` to folders on another drive before installing.
481
+
475
482
  ### My units don't use Ed
476
483
 
477
484
  That's fine: deadlines, grades, course files, search, mail and attendance work without it. When `monash setup` asks for the Ed token, press Enter to skip and answer yes to "not using Ed". Or run `monash config use_ed false` at any time. After that sync, the to-do list and `monash doctor` stop mentioning Ed, and your AI app no longer lists the Ed tools. `monash login ed` turns it back on.
@@ -296,6 +296,8 @@ npx skills add Waldo0926/monash-study-kit
296
296
  - macOS:`~/Library/Application Support/monash-study-kit`
297
297
  - Windows:`%LOCALAPPDATA%\monash-study-kit`
298
298
 
299
+ 这只是默认位置。第一次 `monash setup` 会问数据放在哪,列出每个盘的剩余空间;C 盘剩不到 5 GB 时会推荐别的盘。以后想整个搬走(课件、数据库、登录状态、设置):先关掉 AI 软件,再运行 `monash move D:\MonashStudyKit`。数据放在别处时,默认目录里只留一个很小的 `location.json` 指过去,不用重新登录。
300
+
299
301
  里面有课件(`files`)、数据库(`data`)、登录凭据(`secrets`,只有你自己的账户能读)、专用登录窗口的配置(`browser-profile`)。运行 `monash open` 可以打开课件文件夹,`monash open ed` 打开 Ed Lessons 的课件(在 `data/ed-files` 里,按课号分)。
300
302
  - **存了哪些凭据**:Moodle 的会话 cookie、Ed 的 API 令牌、Moodle 日历订阅链接。都只在你电脑上,只用来访问 Moodle / Ed 本身。**别把 `secrets` 文件夹发给别人。**
301
303
  - **AI 能看到什么**:只有你提问时 AI 调用工具返回的内容(比如截止日期列表、某个帖子的全文、某份课件的文字)。令牌和 cookie 永远不会发给 AI。**也不要把 Ed 令牌贴进聊天里**,令牌只在终端里输入。
@@ -366,6 +368,7 @@ npx skills add Waldo0926/monash-study-kit
366
368
  | `monash ed lessons FIT2109` / `quiz FIT2109` | Ed Lessons 进度 / 测验题(复习用) |
367
369
  | `monash ed read FIT2109 "W3 Pre-Class"` | 整节 lesson 的正文:文字页、阅读网页、PDF 按页序拼成 Markdown,附测验题 |
368
370
  | `monash ed export FIT2109 [--module "Week 3"] [--open]` | 整门课的 Ed 课件按周打包成 zip,存到“下载” |
371
+ | `monash export FIT1043 [--dir] [--open]` | 导出一门课的课程资料(Moodle + Ed Lessons),附索引,写明没导出的内容和原因 |
369
372
  | `monash config` | 看/改设置(改完重启 AI 软件) |
370
373
  | `monash connect [客户端]` | 接进 Codex、Cursor、VS Code、Windsurf 或 Gemini CLI(见[接入其他 AI 客户端](#接入其他-ai-客户端)) |
371
374
  | `monash remote serve` / `pair` / `clients` / `revoke` | 可选:给 ChatGPT 和网页版 Claude 用的远程 MCP([自己托管(进阶)](https://docs.secureview.tech/zh-cn/study-kit/remote/)) |
@@ -451,6 +454,10 @@ Codex、Cursor、VS Code、Windsurf 或 Gemini CLI:运行 `monash connect` 看
451
454
 
452
455
  Windows 默认整条路径不能超过 260 个字符,课程名 + 周次名 + 文件名叠起来可能超。把课件放到短一点的地方:`monash config files_dir C:\Monash`,然后 `monash sync`。
453
456
 
457
+ ### C 盘满了
458
+
459
+ 用 `monash move D:\MonashStudyKit` 把所有数据搬到别的盘(先关掉 Claude 等 AI 软件)。程序本身不大;如果连 uv 和 Python 也不想放 C 盘,安装前把 `UV_TOOL_DIR`、`UV_PYTHON_INSTALL_DIR`、`UV_CACHE_DIR` 设成别的盘上的文件夹。
460
+
454
461
  ### 我的课不用 Ed
455
462
 
456
463
  没关系:截止日期、成绩、课件、全文搜索、邮件和考勤都不依赖 Ed。`monash setup` 问 Ed 令牌时直接回车跳过,再在“不用 Ed 吗”那里选是;或者随时运行 `monash config use_ed false`。之后同步、待办和 `monash doctor` 都不会再提 Ed,AI 软件里也不再列 Ed 的工具。以后要用了,运行 `monash login ed` 就会重新打开。
@@ -1,4 +1,4 @@
1
1
  """Monash 学习助手:把 Moodle 和 Ed 接进 Claude。"""
2
2
  # 发新版就改这里(pyproject 从这里读):朋友那边的更新提示比的就是 main 上的这个号。
3
3
  # 修 bug 加最后一位,加功能加中间一位。CI 会检查改了 src/ 的 PR 有没有改它。
4
- __version__ = "1.7.0"
4
+ __version__ = "1.8.0"
@@ -40,6 +40,7 @@ import subprocess
40
40
  import sys
41
41
  import urllib.error
42
42
  import webbrowser
43
+ from pathlib import Path
43
44
 
44
45
  from . import __version__, edlib, jobs
45
46
  from .gmail import GmailAuthError, GmailError
@@ -180,6 +181,16 @@ def cmd_setup(args):
180
181
  desktop = claude_setup.install_desktop()
181
182
  code = claude_setup.install_code()
182
183
  return 0 if desktop or code else 1
184
+ from . import location
185
+ if location.first_run():
186
+ print(f"Monash 学习助手 {__version__}\n")
187
+ choice = location.ask()
188
+ if choice is not None:
189
+ ensure_private_dir(choice)
190
+ location.write_pointer(choice)
191
+ print(f"好的,数据放在 {choice}。\n")
192
+ location.restart_setup()
193
+ print()
183
194
  print(f"Monash 学习助手 {__version__}\n数据都放在:{HOME}\n")
184
195
  print("== 1/4 Ed ==")
185
196
  if jobs.have_ed_token():
@@ -333,6 +344,34 @@ def parse_setting(key: str, raw: str, current):
333
344
  return raw
334
345
 
335
346
 
347
+ def cmd_move(args):
348
+ """把整个数据目录(课件、数据库、登录状态、设置)搬到别的位置,比如 C 盘满了换到 D 盘。"""
349
+ from . import location
350
+ if os.environ.get("MONASH_KIT_HOME"):
351
+ print("现在用的是环境变量 MONASH_KIT_HOME 指定的位置,先去掉这个环境变量再搬。", file=sys.stderr)
352
+ return 1
353
+ target = Path(args.target).expanduser()
354
+ print(f"从 {HOME}\n搬到 {target}")
355
+ print("搬之前先关掉 Claude 等用着 monash 的 AI 软件(它们开着会占着数据库)。")
356
+ if not jobs._lock():
357
+ print("现在有同步正在跑,等它跑完再搬。", file=sys.stderr)
358
+ return 1
359
+ try:
360
+ if not args.yes and not _yes("开始搬吗?", default=True):
361
+ return 1
362
+ d = location.move(HOME, target)
363
+ except location.MoveError as e:
364
+ print(e, file=sys.stderr)
365
+ return 1
366
+ finally:
367
+ # 锁文件可能已经跟着搬走了,两处都清
368
+ jobs.LOCK_FILE.unlink(missing_ok=True)
369
+ (target / jobs.LOCK_FILE.name).unlink(missing_ok=True)
370
+ print(f"搬好了:{d['entries']} 项,{d['bytes'] / 1e9:.1f} GB。以后数据都在 {d['to']}。")
371
+ print("重新打开 Claude 就行,不用重新登录。")
372
+ return 0
373
+
374
+
336
375
  def cmd_config(args):
337
376
  if not args.key:
338
377
  for k, v in load_settings().items():
@@ -587,6 +626,31 @@ def cmd_due(args):
587
626
  return emit_json(items) if want_json(args) else _print_due(items)
588
627
 
589
628
 
629
+ def cmd_export(args):
630
+ """一门课的 Moodle 课件 + Ed Lessons 合成一份课程资料(zip 或文件夹),附索引。只用本机已同步的数据。"""
631
+ from . import export as X, moodlelib
632
+ try:
633
+ d = X.export(args.course, args.to, as_dir=args.dir,
634
+ moodle_con=moodlelib.db_connect(), ed_conn=edlib.db_connect())
635
+ except LookupError as e:
636
+ print(e, file=sys.stderr)
637
+ return 1
638
+ if want_json(args):
639
+ return emit_json(d)
640
+ print(f"已导出 {d['course']}({d['bytes'] / 1e6:.1f} MB):{d['path']}")
641
+ if d["moodle"]:
642
+ print(f" Moodle:{d['moodle']['files']} 个文件,{d['moodle']['links']} 条链接")
643
+ if d["ed"]:
644
+ print(f" Ed Lessons:{d['ed']['lessons']} 节 lesson,{d['ed']['files']} 个文件")
645
+ for n in d["notes"]:
646
+ print(f" ! {n}")
647
+ if d["missing"]:
648
+ print(f" 有 {d['missing']} 项没导出,原因写在 README.md 的“没导出的内容”里")
649
+ if args.open:
650
+ reveal(d["path"])
651
+ return 0
652
+
653
+
590
654
  def cmd_grep(args):
591
655
  from . import content_index as CI
592
656
  hits = CI.search(db_connect(), args.query, args.course.upper() if args.course else None, args.limit)
@@ -843,6 +907,11 @@ def build_parser() -> argparse.ArgumentParser:
843
907
  p.add_argument("course", nargs="?"); p.add_argument("--days", type=int, default=14)
844
908
  p = cmd(sub, "grep", cmd_grep, json_flag=True, help="全文搜课件和字幕稿")
845
909
  p.add_argument("query"); p.add_argument("course", nargs="?"); p.add_argument("--limit", type=int, default=15)
910
+ p = cmd(sub, "export", cmd_export, json_flag=True, help="导出一门课的课程资料(Moodle + Ed Lessons,附索引)")
911
+ p.add_argument("course", help="课号,如 FIT1043")
912
+ p.add_argument("--to", help="保存到哪个文件夹(默认“下载”)")
913
+ p.add_argument("--dir", action="store_true", help="写成文件夹,不打 zip")
914
+ p.add_argument("--open", action="store_true", help="导出后在文件管理器里显示")
846
915
  p = cmd(sub, "media", cmd_media, help="录播:YouTube 字幕、Zoom 录像下载和转写(要装 [media])")
847
916
  p.add_argument("--limit", type=int, default=0, help="这次最多转写几个视频")
848
917
  p.add_argument("--match", help="只转写路径里含这段文字的视频")
@@ -850,6 +919,9 @@ def build_parser() -> argparse.ArgumentParser:
850
919
  p.add_argument("--dry-run", action="store_true")
851
920
  p = cmd(sub, "open", cmd_open, help="打开课件文件夹(monash open ed:Ed Lessons 的课件)")
852
921
  p.add_argument("what", nargs="?", choices=["ed"], help="ed=Ed Lessons 的课件文件夹")
922
+ p = cmd(sub, "move", cmd_move, help="把数据(课件、数据库、登录状态)整个搬到别的位置,比如 C 盘满了换到 D 盘")
923
+ p.add_argument("target", help="新位置的完整路径,如 D:\\MonashStudyKit")
924
+ p.add_argument("--yes", action="store_true", help="不再确认")
853
925
  p = cmd(sub, "config", cmd_config, help="看/改设置")
854
926
  p.add_argument("key", nargs="?"); p.add_argument("value", nargs="?")
855
927
  p = cmd(sub, "connect", cmd_connect, help="接进别的 AI 软件:Codex、Cursor、VS Code、Windsurf、Gemini CLI")
@@ -0,0 +1,246 @@
1
+ """整门课的课程资料导出:Moodle 课件和 Ed Lessons 放进同一个目录(或 zip),附一份索引。
2
+
3
+ FIT1043/
4
+ README.md 索引:导出了什么、哪些没导出以及原因
5
+ Moodle/
6
+ Week 01 - .../xxx.pdf
7
+ Week 01 - .../links.md 这个目录里没法下载的外部链接
8
+ Ed Lessons/
9
+ 03 Week 3 - .../02 Lesson/01 Slides.pdf
10
+ 03 Week 3 - .../02 Lesson/Links.md
11
+ 03 Week 3 - .../02 Lesson/Quiz.md
12
+
13
+ 只用本机已经同步好的数据,不联网:先 monash sync,再导出。只导课程资料,不含
14
+ 提交记录、成绩、反馈、邮件、私信和考勤。Zoom 链接里的会议密码会去掉。
15
+ CLI(monash export)和服务器上的整门课 zip 共用这里。
16
+ """
17
+ from __future__ import annotations
18
+
19
+ import os
20
+ import re
21
+ import sqlite3
22
+ import urllib.parse
23
+ import zipfile
24
+ from dataclasses import dataclass, field
25
+ from datetime import datetime
26
+ from pathlib import Path
27
+
28
+ from . import edexport, edquery
29
+ from .moodlelib import FILES_DIR
30
+
31
+ # 课件大多已经压过,再压一遍只费 CPU
32
+ STORED = edexport.STORED
33
+ # 链接里的这些参数是会议密码或一次性令牌,导出给别处看的资料里不该带
34
+ SECRET_PARAMS = {"pwd", "passcode", "password", "token", "tk"}
35
+
36
+
37
+ @dataclass
38
+ class Plan:
39
+ code: str
40
+ entries: list = field(default_factory=list) # [(包内路径, Path 或 str 内容)]
41
+ missing: list = field(default_factory=list) # [{"where", "title", "url", "reason"}]
42
+ notes: list = field(default_factory=list) # 写进索引的说明
43
+ moodle: dict | None = None
44
+ ed: dict | None = None
45
+
46
+ def add(self, arc: str, item) -> None:
47
+ self.entries.append((arc, item))
48
+
49
+
50
+ def scrub_url(url: str) -> str:
51
+ """去掉会议密码这类参数:https://monash.zoom.us/j/123?pwd=abc → https://monash.zoom.us/j/123"""
52
+ parts = urllib.parse.urlsplit(url)
53
+ if not parts.query:
54
+ return url
55
+ kept = [(k, v) for k, v in urllib.parse.parse_qsl(parts.query, keep_blank_values=True)
56
+ if k.lower() not in SECRET_PARAMS]
57
+ return urllib.parse.urlunsplit(parts._replace(query=urllib.parse.urlencode(kept)))
58
+
59
+
60
+ def _code(ref: str) -> str:
61
+ m = re.search(r"[A-Za-z]{3}\d{4}", ref or "")
62
+ return m.group(0).upper() if m else (ref or "").strip()
63
+
64
+
65
+ # ---------------------------------------------------------------- Moodle
66
+
67
+ def moodle_course(con: sqlite3.Connection, code: str) -> dict | None:
68
+ """库里课号对得上的 Moodle 课。同一门课有好几个学期时取跟踪中、id 最大(最新)的那个。"""
69
+ rows = [dict(r) for r in con.execute("SELECT id, code, folder, fullname, tracked, synced_at FROM courses")]
70
+ hits = [r for r in rows if (r["code"] or "").upper() == code]
71
+ hits.sort(key=lambda r: (not r["tracked"], -r["id"]))
72
+ return hits[0] if hits else None
73
+
74
+
75
+ def _links_md(folder: str, items: list) -> str:
76
+ lines = [f"# {folder} 的链接", ""]
77
+ last, seen = None, set()
78
+ for r in items:
79
+ url = scrub_url(r["url"])
80
+ if url in seen:
81
+ continue
82
+ seen.add(url)
83
+ if r["section"] and r["section"] != last:
84
+ lines += ["", f"## {r['section']}", ""]
85
+ last = r["section"]
86
+ lines.append(f"- [{r['title'] or url}]({url})")
87
+ return "\n".join(lines).replace("\n\n\n", "\n\n") + "\n"
88
+
89
+
90
+ def plan_moodle(p: Plan, con: sqlite3.Connection) -> None:
91
+ c = moodle_course(con, p.code)
92
+ if c is None:
93
+ p.notes.append(f"Moodle:本机库里没有 {p.code}。先运行 monash courses 把它勾上,再 monash sync。")
94
+ return
95
+ root = c["folder"] or ""
96
+ stats = {"id": c["id"], "name": c["fullname"], "files": 0, "bytes": 0, "links": 0, "synced_at": c["synced_at"]}
97
+ if not c["synced_at"]:
98
+ p.notes.append(f"Moodle:{p.code} 还没同步过(monash sync {p.code})。")
99
+ for r in con.execute("SELECT path, title, section FROM files WHERE course_id=? AND removed_at IS NULL "
100
+ "ORDER BY path", (c["id"],)):
101
+ path = FILES_DIR / r["path"]
102
+ rel = r["path"][len(root) + 1:] if root and r["path"].startswith(root + "/") else r["path"]
103
+ if path.is_file() and FILES_DIR.resolve() in path.resolve().parents:
104
+ p.add(f"{p.code}/Moodle/{rel}", path)
105
+ stats["files"] += 1
106
+ stats["bytes"] += path.stat().st_size
107
+ else:
108
+ p.missing.append({"where": f"Moodle/{os.path.dirname(rel)}", "title": r["title"] or rel,
109
+ "url": "", "reason": "本地文件不见了(重新 monash sync)"})
110
+ by_folder: dict[str, list] = {}
111
+ for r in con.execute("SELECT folder, section, title, url FROM links WHERE course_id=? ORDER BY folder, section, rowid",
112
+ (c["id"],)):
113
+ by_folder.setdefault(r["folder"], []).append(r)
114
+ for folder, items in by_folder.items():
115
+ p.add(f"{p.code}/Moodle/{folder}/links.md", _links_md(folder, items))
116
+ stats["links"] += len(items)
117
+ p.moodle = stats
118
+
119
+
120
+ # ---------------------------------------------------------------- Ed
121
+
122
+ def _ed_reason(conn: sqlite3.Connection, code: str) -> str:
123
+ """Ed 那边为什么没有 lessons:没找到课、没跟踪,还是课里本来就没有。"""
124
+ try:
125
+ c = edquery.resolve_course(conn, code)
126
+ except edquery.NotFound:
127
+ return (f"本机的 Ed 课程列表里没有 {code}:可能没加入这门课的 Ed,或者 Ed 上的课号不一样。"
128
+ "monash ed courses 可以看有哪些课。")
129
+ if not c.get("tracked"):
130
+ return (f"Ed 上的 {c['code']} 没有被跟踪,所以 lessons 从来没同步过。"
131
+ f"用 monash courses 把它勾上(或 monash sync 之后再看),然后重新导出。")
132
+ return f"Ed 上的 {c['code']} 已跟踪,但还没有同步到 lessons(先 monash sync;Ed 上也可能本来就没有 lessons)。"
133
+
134
+
135
+ def plan_ed(p: Plan, conn: sqlite3.Connection) -> None:
136
+ try:
137
+ ep = edexport.plan(conn, p.code)
138
+ except (LookupError, edquery.NotFound):
139
+ p.notes.append("Ed Lessons:" + _ed_reason(conn, p.code))
140
+ return
141
+ base = f"{p.code}/Ed Lessons"
142
+ cut = len(ep["root"]) + 1
143
+ for arc, path in ep["files"]:
144
+ p.add(f"{base}/{arc[cut:]}", path)
145
+ for l in ep["lessons"]:
146
+ folder = f"{base}/{l['folder'][cut:]}"
147
+ md = [f"# {l['title']}", "", f"- Ed 原页面:{l['url']}"]
148
+ md += [f"- [{t}]({scrub_url(u)})" for t, u in l["links"]]
149
+ p.add(f"{folder}/Links.md", "\n".join(md) + "\n")
150
+ # 按 Ed 原页面链接对应(lesson 标题可能重名)
151
+ quiz_by_lesson = {q["url"]: q for q in edquery.quizzes(conn, ep["course_id"])}
152
+ for l in ep["lessons"]:
153
+ q = quiz_by_lesson.get(l["url"])
154
+ if q:
155
+ p.add(f"{base}/{l['folder'][cut:]}/Quiz.md", edquery.quiz_markdown([q]))
156
+ for m in ep["missing"]:
157
+ p.missing.append({"where": f"Ed Lessons/{m['lesson']}", "title": m["title"], "url": m["url"],
158
+ "reason": "上次同步没下载到(下载失败或超过大小上限)"})
159
+ p.ed = {"id": ep["course_id"], "lessons": len(ep["lessons"]), "files": len(ep["files"]),
160
+ "quizzes": len(quiz_by_lesson)}
161
+
162
+
163
+ # ---------------------------------------------------------------- 索引和写出
164
+
165
+ def _index(p: Plan) -> str:
166
+ now = datetime.now().astimezone().strftime("%Y-%m-%d %H:%M")
167
+ md = [f"# {p.code} 课程资料", "", f"导出于 {now},来自本机已同步的 Moodle 和 Ed Lessons。"
168
+ "这是个人学习副本,课件版权归课程团队,请不要再公开分发。", "",
169
+ "不含:Ed 讨论帖、提交记录、成绩和反馈、邮件、私信、考勤。Zoom 等链接里的会议密码已去掉。", ""]
170
+ if p.moodle:
171
+ m = p.moodle
172
+ md.append(f"- Moodle/:{m['files']} 个文件({m['bytes'] / 1e6:.1f} MB),{m['links']} 条链接写在各目录的 links.md")
173
+ if p.ed:
174
+ e = p.ed
175
+ md.append(f"- Ed Lessons/:{e['lessons']} 节 lesson,{e['files']} 个文件,{e['quizzes']} 节有 Quiz.md(只有题目,没有答案)")
176
+ if p.notes:
177
+ md += ["", "## 说明", ""] + [f"- {n}" for n in p.notes]
178
+ if p.missing:
179
+ md += ["", "## 没导出的内容", "", "| 位置 | 名称 | 原因 | 链接 |", "|---|---|---|---|"]
180
+ for m in p.missing:
181
+ cells = [m["where"], m["title"], m["reason"], scrub_url(m["url"]) if m["url"] else ""]
182
+ md.append("| " + " | ".join(str(c).replace("|", "\\|") for c in cells) + " |")
183
+ return "\n".join(md) + "\n"
184
+
185
+
186
+ def plan(course: str, *, moodle_con: sqlite3.Connection | None, ed_conn: sqlite3.Connection | None) -> Plan:
187
+ p = Plan(code=_code(course))
188
+ if moodle_con is not None:
189
+ plan_moodle(p, moodle_con)
190
+ if ed_conn is not None:
191
+ plan_ed(p, ed_conn)
192
+ if not p.entries:
193
+ raise LookupError(f"{p.code} 没有可导出的资料。\n" + "\n".join(p.notes))
194
+ p.entries.insert(0, (f"{p.code}/README.md", _index(p)))
195
+ return p
196
+
197
+
198
+ def write_zip(p: Plan, out) -> dict:
199
+ total = 0
200
+ with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED, allowZip64=True) as z:
201
+ for arc, item in p.entries:
202
+ if isinstance(item, Path):
203
+ z.write(item, arc, zipfile.ZIP_STORED if item.suffix.lower() in STORED else zipfile.ZIP_DEFLATED)
204
+ total += item.stat().st_size
205
+ else:
206
+ z.writestr(arc, item)
207
+ return _stats(p, total)
208
+
209
+
210
+ def write_dir(p: Plan, dest: Path) -> dict:
211
+ """写成普通文件夹(已经存在的同名文件覆盖)。"""
212
+ import shutil
213
+ total = 0
214
+ for arc, item in p.entries:
215
+ target = dest / arc
216
+ target.parent.mkdir(parents=True, exist_ok=True)
217
+ if isinstance(item, Path):
218
+ shutil.copy2(item, target)
219
+ total += item.stat().st_size
220
+ else:
221
+ target.write_text(item, encoding="utf-8")
222
+ return _stats(p, total)
223
+
224
+
225
+ def _stats(p: Plan, total: int) -> dict:
226
+ return {"course": p.code, "entries": len(p.entries), "bytes": total, "moodle": p.moodle, "ed": p.ed,
227
+ "missing": len(p.missing), "notes": p.notes}
228
+
229
+
230
+ def export(course: str, to: str | Path | None = None, *, as_dir: bool = False,
231
+ moodle_con: sqlite3.Connection | None = None, ed_conn: sqlite3.Connection | None = None) -> dict:
232
+ """导出到文件夹(默认“下载”)。as_dir=True 写成文件夹,否则一个 zip。"""
233
+ p = plan(course, moodle_con=moodle_con, ed_conn=ed_conn)
234
+ dest_dir = Path(to).expanduser() if to else edexport.default_dir()
235
+ dest_dir.mkdir(parents=True, exist_ok=True)
236
+ if as_dir:
237
+ return {"path": str(dest_dir / p.code), **write_dir(p, dest_dir)}
238
+ dest = dest_dir / f"{p.code} 课程资料 {datetime.now().strftime('%Y-%m-%d')}.zip"
239
+ tmp = dest.with_name(dest.name + ".part")
240
+ try:
241
+ with open(tmp, "wb") as f:
242
+ stats = write_zip(p, f)
243
+ os.replace(tmp, dest)
244
+ finally:
245
+ tmp.unlink(missing_ok=True)
246
+ return {"path": str(dest), **stats}