e3cli 0.3.2__tar.gz → 0.4.1__tar.gz

e3cli-0.4.1/CLAUDE.md

@@ -0,0 +1,41 @@
+# E3CLI — Claude Code Integration
+
+## What is this?
+
+e3cli is a CLI tool for NYCU's E3 Moodle platform. It can sync courses, download materials, check assignments, and submit homework.
+
+## How to use e3cli in this project
+
+```bash
+# Check for new assignments
+e3cli sync
+
+# List upcoming assignments
+e3cli assignments --due-soon 7
+
+# Download course materials
+e3cli download --course "COURSE_NAME"
+
+# Submit completed assignment
+e3cli submit <ASSIGNMENT_ID> <FILE_PATH>
+
+# Interactive mode
+e3cli i
+```
+
+## When a new assignment is detected
+
+1. Run `e3cli sync` to pull latest data
+2. Run `e3cli assignments` to see what's new
+3. Check `~/e3-downloads/` for assignment descriptions
+4. **Always confirm with the user before submitting**
+
+## Token expired?
+
+```bash
+e3cli login --refresh
+```
+
+## Full agent instructions
+
+See `e3cli/agent_prompt.md` for detailed automation workflow.

e3cli-0.4.1/Formula/e3cli.rb

@@ -0,0 +1,84 @@
+class E3cli < Formula
+  include Language::Python::Virtualenv
+
+  desc "NYCU E3 Moodle automation CLI — sync courses, download materials, submit assignments"
+  homepage "https://github.com/junlinwk/e3cli"
+  url "https://github.com/junlinwk/e3cli/archive/refs/tags/v0.3.2.tar.gz"
+  sha256 "81fdd7e59817afbe9863c4c8533355297daaf59a37e526f47ca26d161a6ce7d3"
+  license "MIT"
+
+  depends_on "python@3.12"
+
+  resource "typer" do
+    url "https://files.pythonhosted.org/packages/f5/24/cb09efec5cc954f7f9b930bf8279447d24618bb6758d4f6adf2574c41780/typer-0.24.1.tar.gz"
+    sha256 "e39b4732d65fbdcde189ae76cf7cd48aeae72919dea1fdfc16593be016256b45"
+  end
+
+  resource "click" do
+    url "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz"
+    sha256 "12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a"
+  end
+
+  resource "shellingham" do
+    url "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz"
+    sha256 "8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de"
+  end
+
+  resource "annotated-doc" do
+    url "https://files.pythonhosted.org/packages/57/ba/046ceea27344560984e26a590f90bc7f4a75b06701f653222458922b558c/annotated_doc-0.0.4.tar.gz"
+    sha256 "fbcda96e87e9c92ad167c2e53839e57503ecfda18804ea28102353485033faa4"
+  end
+
+  resource "requests" do
+    url "https://files.pythonhosted.org/packages/34/64/8860370b167a9721e8956ae116825caff829224fbca0ca6e7bf8ddef8430/requests-2.33.0.tar.gz"
+    sha256 "c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652"
+  end
+
+  resource "charset_normalizer" do
+    url "https://files.pythonhosted.org/packages/7b/60/e3bec1881450851b087e301bedc3daa9377a4d45f1c26aa90b0b235e38aa/charset_normalizer-3.4.6.tar.gz"
+    sha256 "1ae6b62897110aa7c79ea2f5dd38d1abca6db663687c0b1ad9aed6f6bae3d9d6"
+  end
+
+  resource "idna" do
+    url "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz"
+    sha256 "795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902"
+  end
+
+  resource "urllib3" do
+    url "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz"
+    sha256 "1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed"
+  end
+
+  resource "certifi" do
+    url "https://files.pythonhosted.org/packages/af/2d/7bf41579a8986e348fa033a31cdd0e4121114f6bce2457e8876010b092dd/certifi-2026.2.25.tar.gz"
+    sha256 "e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7"
+  end
+
+  resource "rich" do
+    url "https://files.pythonhosted.org/packages/b3/c6/f3b320c27991c46f43ee9d856302c70dc2d0fb2dba4842ff739d5f46b393/rich-14.3.3.tar.gz"
+    sha256 "b8daa0b9e4eef54dd8cf7c86c03713f53241884e814f4e2f5fb342fe520f639b"
+  end
+
+  resource "markdown-it-py" do
+    url "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz"
+    sha256 "cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3"
+  end
+
+  resource "mdurl" do
+    url "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz"
+    sha256 "bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"
+  end
+
+  resource "pygments" do
+    url "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz"
+    sha256 "636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "e3cli", shell_output("#{bin}/e3cli version")
+  end
+end

e3cli-0.4.1/PKG-INFO

@@ -0,0 +1,346 @@
+Metadata-Version: 2.4
+Name: e3cli
+Version: 0.4.1
+Summary: NYCU E3 Moodle automation CLI — sync courses, download materials, submit assignments.
+Project-URL: Homepage, https://github.com/junlinwk/e3cli
+Project-URL: Repository, https://github.com/junlinwk/e3cli
+Project-URL: Issues, https://github.com/junlinwk/e3cli/issues
+Author: E3CLI Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,cli,e3,moodle,nycu
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Education
+Requires-Python: >=3.11
+Requires-Dist: requests>=2.31
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.9
+Provides-Extra: ai
+Requires-Dist: anthropic>=0.18; extra == 'ai'
+Requires-Dist: pymupdf>=1.23; extra == 'ai'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=white" alt="Python">
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey?logo=apple&logoColor=white" alt="Platform">
+  <img src="https://img.shields.io/github/license/junlinwk/e3cli?color=green" alt="License">
+  <img src="https://img.shields.io/github/v/tag/junlinwk/e3cli?label=version&color=orange" alt="Version">
+</p>
+
+<h1 align="center">e3cli</h1>
+
+<p align="center">
+  <b>NYCU E3 Moodle automation CLI</b><br>
+  Sync courses, download materials, submit assignments — all from your terminal.
+</p>
+
+<p align="center">
+  <a href="#installation">Install</a> &bull;
+  <a href="#quick-start">Quick Start</a> &bull;
+  <a href="#commands">Commands</a> &bull;
+  <a href="#security">Security</a> &bull;
+  <a href="./README_zh-TW.md">繁體中文</a>
+</p>
+
+---
+
+> **Intended use:** Finished your homework? Too lazy to open the browser? Submit it from CLI.
+>
+> ~~**Unintended use:** Let Claude Code auto-pull new assignments, finish them, and upload. (Please don't.)~~
+
+## Features
+
+- **Login** — Moodle Web Service API authentication with encrypted credential storage
+- **Courses** — List all enrolled courses
+- **Assignments** — View assignments, deadlines, and submission status
+- **Download** — Batch download course materials, skip already-downloaded files
+- **Submit** — Upload and submit assignments directly from CLI
+- **Sync** — One command to pull everything new (materials + assignment status)
+- **Schedule** — Cron-based automatic sync
+- **Bilingual** — Full Chinese/English support
+
+## Supported Platforms
+
+| Platform | Architecture | Status |
+|----------|-------------|--------|
+| macOS | Apple Silicon (ARM64) | :white_check_mark: Supported |
+| macOS | Intel (x86_64) | :white_check_mark: Supported |
+| Linux | x86_64 | :white_check_mark: Supported |
+| Linux | ARM64 | :white_check_mark: Supported |
+
+Requires **Python 3.11+**.
+
+---
+
+## Installation
+
+### Homebrew (recommended)
+
+```bash
+brew tap junlinwk/e3cli
+brew install e3cli
+```
+
+### pipx
+
+```bash
+pipx install git+https://github.com/junlinwk/e3cli.git
+```
+
+### pip
+
+```bash
+pip install git+https://github.com/junlinwk/e3cli.git
+```
+
+### From source
+
+```bash
+git clone https://github.com/junlinwk/e3cli.git
+cd e3cli
+pip install -e ".[dev]"
+```
+
+> After installation, `e3cli` is available as a system-wide command.
+
+### Upgrade
+
+| Method | Command |
+|--------|---------|
+| Homebrew | `brew update && brew upgrade e3cli` |
+| pipx (GitHub) | `pipx install git+https://github.com/junlinwk/e3cli.git --force` |
+| pipx (PyPI) | `pipx upgrade e3cli` |
+| pip (PyPI) | `pip install e3cli --upgrade` |
+
+---
+
+## Quick Start
+
+```bash
+# 1. Login (first time — interactive setup wizard will guide you)
+e3cli login --save
+
+# 2. List your courses
+e3cli courses
+
+# 3. Download all course materials
+e3cli download --all
+
+# 4. Check assignments and deadlines
+e3cli assignments
+
+# 5. Submit an assignment
+e3cli submit <assignment-id> homework.pdf
+
+# 6. Enable automatic sync (every hour)
+e3cli schedule enable
+```
+
+---
+
+## Commands
+
+### `e3cli login`
+
+Authenticate with your Moodle account and store the API token.
+
+```bash
+e3cli login                    # Interactive prompt
+e3cli login -u <student-id>    # Specify username
+e3cli login --save             # Save credentials (encrypted) for auto-refresh
+e3cli login --refresh          # Re-authenticate using saved credentials
+```
+
+### `e3cli logout`
+
+Securely erase all stored credentials and tokens.
+
+```bash
+e3cli logout
+```
+
+### `e3cli courses`
+
+List all enrolled courses in a formatted table.
+
+```bash
+e3cli courses
+```
+
+### `e3cli assignments`
+
+View assignments with deadlines and submission status.
+
+```bash
+e3cli assignments                  # All assignments
+e3cli assignments --due-soon 7     # Due within 7 days
+```
+
+### `e3cli download`
+
+Download course materials to local disk.
+
+```bash
+e3cli download --all               # All courses
+e3cli download --course "OS"       # Filter by course name/code
+```
+
+Files are saved to `~/e3-downloads/<course>/<section>/` by default. Already-downloaded files are skipped automatically (tracked via SQLite).
+
+### `e3cli submit`
+
+Upload and submit an assignment.
+
+```bash
+e3cli submit <assignment-id> file1.pdf file2.zip
+e3cli submit <assignment-id> report.pdf --text "Some notes"
+e3cli submit <assignment-id> late-hw.pdf --force     # Submit past deadline
+```
+
+### `e3cli sync`
+
+Pull all new materials and update assignment status in one command.
+
+```bash
+e3cli sync                # Interactive output
+e3cli sync --quiet        # Silent mode (for cron)
+```
+
+### `e3cli schedule`
+
+Manage automatic sync via system crontab.
+
+```bash
+e3cli schedule enable                  # Default: every 60 minutes
+e3cli schedule enable --interval 30    # Every 30 minutes
+e3cli schedule disable                 # Remove cron job
+e3cli schedule status                  # Show current schedule
+```
+
+### `e3cli setup`
+
+Re-run the interactive setup wizard (language, Moodle URL, download directory, login).
+
+```bash
+e3cli setup
+```
+
+### `e3cli version`
+
+```bash
+e3cli version
+```
+
+---
+
+## Configuration
+
+Config file location: `~/.e3cli/config.toml`
+
+```toml
+[moodle]
+url = "https://e3p.nycu.edu.tw"
+service = "moodle_mobile_app"
+
+[storage]
+download_dir = "~/e3-downloads"
+
+[schedule]
+interval_minutes = 60
+notify = true
+
+[general]
+lang = "zh"    # "zh" or "en", or omit for auto-detect
+```
+
+Auto-created with defaults on first run. Edit to customize, or run `e3cli setup` to reconfigure interactively.
+
+---
+
+## Security
+
+### Credential Storage
+
+e3cli uses **PBKDF2-HMAC-SHA256** key derivation with integrity verification to protect stored credentials:
+
+```
+~/.e3cli/
+  key               # 256-bit random encryption key  (chmod 600)
+  credentials.enc   # Encrypted username + password   (chmod 600)
+  token             # Moodle API token                (chmod 600)
+```
+
+| Measure | Detail |
+|---------|--------|
+| Encryption | PBKDF2-HMAC-SHA256 (100k iterations) + XOR stream cipher |
+| Integrity | HMAC-SHA256 verification on every read |
+| File permissions | `chmod 600` — owner-only read/write |
+| Password input | `getpass` — never appears in shell history or CLI args |
+| Logout | `e3cli logout` overwrites files with zeros before deletion |
+| Key separation | Encryption key and encrypted data stored in separate files |
+
+### What's NOT Stored
+
+- :x: No plaintext passwords on disk
+- :x: No credentials in `config.toml`
+- :x: No credentials in environment variables
+- :x: No credentials in shell history
+
+### Recommendations
+
+- Use `e3cli login --save` only on machines you trust
+- Run `e3cli logout` when done on shared machines
+- The `~/.e3cli/` directory is in `.gitignore` — never commit it
+
+---
+
+## Local Data
+
+| Path | Purpose |
+|------|---------|
+| `~/.e3cli/config.toml` | User configuration |
+| `~/.e3cli/token` | Moodle API token (chmod 600) |
+| `~/.e3cli/key` | Encryption key (chmod 600) |
+| `~/.e3cli/credentials.enc` | Encrypted credentials (chmod 600) |
+| `~/.e3cli/data/e3cli.db` | SQLite tracking DB |
+| `~/e3-downloads/` | Downloaded course materials |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/junlinwk/e3cli.git
+cd e3cli
+make dev       # pip install -e ".[dev]"
+make lint      # ruff check
+make test      # pytest
+make build     # python -m build
+```
+
+## Roadmap
+
+- [ ] AI-powered material summarization
+- [ ] AI-assisted assignment drafting
+- [ ] Smart deadline notifications with priority scoring
+- [ ] Desktop notifications (Linux `notify-send`, macOS `osascript`)
+- [ ] Course filtering by semester
+- [ ] Parallel downloads
+
+---
+
+## License
+
+[MIT](./LICENSE)