e3cli 0.4.1__tar.gz → 0.8.4__tar.gz

e3cli-0.8.4/.github/workflows/release.yml

@@ -0,0 +1,170 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: pip install twine && twine upload dist/*
+
+  update-homebrew:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Calculate tarball sha256
+        id: sha
+        run: |
+          TARBALL_URL="https://github.com/${{ github.repository }}/archive/refs/tags/${{ github.ref_name }}.tar.gz"
+          echo "url=${TARBALL_URL}" >> "$GITHUB_OUTPUT"
+          SHA=$(curl -sL "${TARBALL_URL}" | sha256sum | cut -d' ' -f1)
+          echo "sha256=${SHA}" >> "$GITHUB_OUTPUT"
+          echo "Tarball: ${TARBALL_URL}"
+          echo "SHA256:  ${SHA}"
+
+      - name: Clone homebrew tap
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository_owner }}/homebrew-e3cli
+          token: ${{ secrets.TAP_GITHUB_TOKEN }}
+          path: homebrew-tap
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Generate formula with all transitive dependencies
+        run: |
+          python3 - "${{ github.repository }}" "${{ steps.sha.outputs.url }}" "${{ steps.sha.outputs.sha256 }}" << 'PYSCRIPT'
+          import json, re, sys, urllib.request
+
+          repo, tarball_url, tarball_sha = sys.argv[1], sys.argv[2], sys.argv[3]
+
+          def get_info(pkg):
+              pkg_normalized = re.sub(r'[-_.]+', '-', pkg).lower()
+              try:
+                  data = json.loads(urllib.request.urlopen(f"https://pypi.org/pypi/{pkg_normalized}/json").read())
+              except Exception:
+                  return None
+              ver = data["info"]["version"]
+              requires = data["info"].get("requires_dist") or []
+              deps = []
+              for r in requires:
+                  if "extra ==" in r:
+                      continue
+                  # Extract package name (before any version specifier or marker)
+                  m = re.match(r'^([A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?)', r)
+                  if m:
+                      deps.append(m.group(1).lower())
+              sdist_url, sha = "", ""
+              for f in data["releases"].get(ver, []):
+                  if f["packagetype"] == "sdist":
+                      sdist_url, sha = f["url"], f["digests"]["sha256"]
+                      break
+              return {"name": pkg_normalized, "deps": deps, "url": sdist_url, "sha256": sha}
+
+          # Resolve ALL transitive dependencies
+          seen = set()
+          queue = ["typer", "requests", "rich"]
+          resources = []
+
+          while queue:
+              pkg = queue.pop(0)
+              key = re.sub(r'[-_.]+', '_', pkg).lower()
+              if key in seen:
+                  continue
+              seen.add(key)
+              info = get_info(pkg)
+              if info is None:
+                  print(f"WARNING: Could not resolve {pkg}", file=sys.stderr)
+                  continue
+              if info["url"]:
+                  resources.append(info)
+              for d in info["deps"]:
+                  dk = re.sub(r'[-_.]+', '_', d).lower()
+                  if dk not in seen:
+                      queue.append(d)
+
+          # Build formula
+          lines = [
+              'class E3cli < Formula',
+              '  include Language::Python::Virtualenv',
+              '',
+              '  desc "NYCU E3 Moodle automation CLI — sync courses, download materials, submit assignments"',
+              f'  homepage "https://github.com/{repo}"',
+              f'  url "{tarball_url}"',
+              f'  sha256 "{tarball_sha}"',
+              '  license "MIT"',
+              '',
+              '  depends_on "python@3.12"',
+          ]
+
+          for r in resources:
+              lines += [
+                  '',
+                  f'  resource "{r["name"]}" do',
+                  f'    url "{r["url"]}"',
+                  f'    sha256 "{r["sha256"]}"',
+                  '  end',
+              ]
+
+          lines += [
+              '',
+              '  def install',
+              '    virtualenv_install_with_resources',
+              '  end',
+              '',
+              '  test do',
+              '    assert_match "e3cli", shell_output("#{bin}/e3cli version")',
+              '  end',
+              'end',
+              '',
+          ]
+
+          formula = "\n".join(lines)
+          with open("homebrew-tap/Formula/e3cli.rb", "w") as f:
+              f.write(formula)
+
+          print("=== Generated formula ===")
+          print(formula)
+          print(f"\nTotal resources: {len(resources)}", file=sys.stderr)
+          PYSCRIPT
+
+      - name: Push updated formula
+        run: |
+          cd homebrew-tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/e3cli.rb
+          git diff --cached --quiet && echo "No changes" && exit 0
+          git commit -m "Update e3cli to ${{ github.ref_name }}"
+          git push

e3cli-0.8.4/CLAUDE.md

@@ -0,0 +1,113 @@
+# E3CLI — Claude Code Integration
+
+## What is this?
+
+e3cli is a CLI tool for Moodle platforms (default: NYCU E3). It can sync courses, download materials, check assignments, view announcements, list members, send messages, and submit homework.
+
+## Quick Reference
+
+```bash
+# Sync current semester (materials + assignments)
+e3cli sync
+
+# List assignments (sorted by urgency, with submission status)
+e3cli assignments
+
+# Assignments due within 7 days
+e3cli assignments --due-soon 7
+
+# View full assignment description + attachments
+e3cli assignments --detail <ASSIGNMENT_ID>
+
+# List courses (current semester)
+e3cli courses
+e3cli courses --all    # all semesters
+
+# Download materials
+e3cli download                     # current semester
+e3cli download --course "OS"       # specific course (fuzzy match)
+
+# View announcements
+e3cli announcements -c "OS"
+e3cli announcements -c "OS" --detail <ID>
+
+# List course members
+e3cli members -c "OS"
+
+# Send message to a user
+e3cli message <USER_ID> "message text"
+
+# Submit assignment
+e3cli submit <ASSIGNMENT_ID> <FILE_PATH>
+
+# Re-submit (overwrite) — same command, overwrites previous
+e3cli submit <ASSIGNMENT_ID> <NEW_FILE_PATH>
+
+# Profile management (multi-account, multi-school)
+e3cli profile                      # list all profiles (with Moodle URL)
+e3cli profile use <name>           # switch profile (also switches Moodle URL)
+e3cli profile remove <name>        # remove a profile
+e3cli login --profile <name> --url <moodle-url> --save  # add profile for different school
+
+# Interactive mode (arrow keys)
+e3cli i
+
+# Token expired?
+e3cli login --refresh
+```
+
+## Workflow: When a New Assignment is Detected
+
+1. `e3cli sync` — pull latest materials and assignment status
+2. `e3cli assignments` — see what's new/urgent (sorted by deadline)
+3. `e3cli assignments --detail <ID>` — read the full description and check attachments
+4. Downloaded materials are in the download directory (check `e3cli sync` output for path)
+5. Work on the assignment
+6. `e3cli submit <ID> <file>` — submit when ready
+7. **Always confirm with the user before submitting**
+
+## Reading Assignment Details
+
+```bash
+# Get assignment list with IDs
+e3cli assignments
+
+# Read full description (HTML converted to text)
+e3cli assignments --detail 12345
+
+# The output includes:
+# - Full description text
+# - Attachment list with URLs
+# - Submission status
+# - Due date
+```
+
+## Checking Course Materials
+
+```bash
+# Download materials for a course
+e3cli download --course "artificial intelligence"
+
+# Materials are saved to the download directory
+# The exact path is shown after download completes
+```
+
+## Important Rules
+
+1. **Never submit without user confirmation** — always ask before running `e3cli submit`
+2. **Academic integrity** — assist, don't replace the student's work
+3. **Check deadlines first** — prioritize urgent assignments
+4. **Token expiry** — if commands fail with auth errors, run `e3cli login --refresh`
+5. **Don't read credential files** — use CLI commands, not direct file access
+
+## Data Locations
+
+| Path | Content |
+|------|---------|
+| Download directory | Course materials (shown in sync/download output) |
+| `~/.e3cli/data/e3cli.db` | Local tracking database |
+| `~/.e3cli/config.toml` | Configuration |
+
+## Full Agent Automation Guide
+
+See `e3cli/agent_prompt.md` for the complete automation workflow.

e3cli-0.8.4/COMMIT_EDITMSG

@@ -0,0 +1 @@
+release: v0.4.3

e3cli-0.8.4/HEAD

@@ -0,0 +1 @@
+ref: refs/heads/main