mgraphctl 0.1.0__tar.gz → 0.2.1__tar.gz

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mgraphctl
-Version: 0.1.0
+Version: 0.2.1
 Summary: Microsoft Graph CLI behind the mgraphctl Claude Code skill
 Keywords: microsoft-graph,microsoft-365,outlook,teams,sharepoint,onedrive,cli
 Author: Sviatoslav Sviridov
@@ -13,6 +13,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -25,7 +26,8 @@ Requires-Dist: typer>=0.27,<1
 Requires-Dist: markdownify>=1.2,<2
 Requires-Dist: keyring>=24,<26
 Requires-Dist: tzdata ; sys_platform == 'win32'
-Requires-Python: >=3.11, <3.14
+Requires-Dist: tomli>=2,<3 ; python_full_version < '3.11'
+Requires-Python: >=3.10, <3.14
 Project-URL: Homepage, https://github.com/svd/mgraphctl
 Project-URL: Source, https://github.com/svd/mgraphctl
 Project-URL: Changelog, https://github.com/svd/mgraphctl/blob/main/CHANGELOG.md
@@ -118,6 +120,22 @@ uv run --project <plugin> --frozen --no-dev mgraphctl login
 Every other command reads the cached sign-in silently and never opens a browser or a device-code
 prompt — a missing or expired token fails with an actionable hint instead.
 
+## Commands
+
+All 123 verbs are documented inside the skill, and `--help` works at every level.
+
+| Where | What |
+|---|---|
+| [`skills/mgraphctl/SKILL.md`](skills/mgraphctl/SKILL.md) | the skill itself: setup, a cheat-sheet of every noun and its verbs, recipes, guardrails, exit codes |
+| [`skills/mgraphctl/reference/commands.md`](skills/mgraphctl/reference/commands.md) | the conventions every verb shares — argument resolution, the list envelope, paging defaults, exit codes, environment variables — and the index of the files below |
+| [`skills/mgraphctl/reference/commands/`](skills/mgraphctl/reference/commands/) | one file per noun (`mail.md`, `calendar.md`, `teams.md`, …): each verb's options, the Graph call it makes and the scopes it needs |
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl --help
+${CLAUDE_PLUGIN_ROOT}/mgraphctl mail --help
+${CLAUDE_PLUGIN_ROOT}/mgraphctl mail list --help
+```
+
 ## Where things live
 
 - Virtual environment: under `${CLAUDE_PLUGIN_DATA}` when Claude Code sets it, otherwise
@@ -215,7 +233,7 @@ uv run ruff format src tests
 The test suite runs entirely offline against recorded fixtures — no Microsoft 365 account or
 network access is needed to run it.
 
-CI (`.github/workflows/ci.yml`) runs the suite on Python 3.11–3.13, ruff, `uv lock --check` and a
+CI (`.github/workflows/ci.yml`) runs the suite on Python 3.10–3.13, ruff, `uv lock --check` and a
 credential scan on every push. Releases are annotated `mgraphctl--vX.Y.Z` tags on `main`, cut with
 `claude plugin tag`; the tag publishes the package to PyPI and a GitHub Release. See `VERSIONING.md`.
 

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/README.md

@@ -84,6 +84,22 @@ uv run --project <plugin> --frozen --no-dev mgraphctl login
 Every other command reads the cached sign-in silently and never opens a browser or a device-code
 prompt — a missing or expired token fails with an actionable hint instead.
 
+## Commands
+
+All 123 verbs are documented inside the skill, and `--help` works at every level.
+
+| Where | What |
+|---|---|
+| [`skills/mgraphctl/SKILL.md`](skills/mgraphctl/SKILL.md) | the skill itself: setup, a cheat-sheet of every noun and its verbs, recipes, guardrails, exit codes |
+| [`skills/mgraphctl/reference/commands.md`](skills/mgraphctl/reference/commands.md) | the conventions every verb shares — argument resolution, the list envelope, paging defaults, exit codes, environment variables — and the index of the files below |
+| [`skills/mgraphctl/reference/commands/`](skills/mgraphctl/reference/commands/) | one file per noun (`mail.md`, `calendar.md`, `teams.md`, …): each verb's options, the Graph call it makes and the scopes it needs |
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl --help
+${CLAUDE_PLUGIN_ROOT}/mgraphctl mail --help
+${CLAUDE_PLUGIN_ROOT}/mgraphctl mail list --help
+```
+
 ## Where things live
 
 - Virtual environment: under `${CLAUDE_PLUGIN_DATA}` when Claude Code sets it, otherwise
@@ -181,7 +197,7 @@ uv run ruff format src tests
 The test suite runs entirely offline against recorded fixtures — no Microsoft 365 account or
 network access is needed to run it.
 
-CI (`.github/workflows/ci.yml`) runs the suite on Python 3.11–3.13, ruff, `uv lock --check` and a
+CI (`.github/workflows/ci.yml`) runs the suite on Python 3.10–3.13, ruff, `uv lock --check` and a
 credential scan on every push. Releases are annotated `mgraphctl--vX.Y.Z` tags on `main`, cut with
 `claude plugin tag`; the tag publishes the package to PyPI and a GitHub Release. See `VERSIONING.md`.
 

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "mgraphctl"
-version = "0.1.0"
+version = "0.2.1"
 description = "Microsoft Graph CLI behind the mgraphctl Claude Code skill"
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
-requires-python = ">=3.11,<3.14"
+requires-python = ">=3.10,<3.14"
 keywords = [
     "microsoft-graph",
     "microsoft-365",
@@ -22,6 +22,7 @@ classifiers = [
     "Intended Audience :: End Users/Desktop",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -36,6 +37,7 @@ dependencies = [
     "markdownify>=1.2,<2",
     "keyring>=24,<26",
     "tzdata; sys_platform == 'win32'",
+    "tomli>=2,<3; python_version < '3.11'",
 ]
 
 [[project.authors]]
@@ -70,7 +72,7 @@ module-name = "mgraphctl"
 
 [tool.ruff]
 line-length = 100
-target-version = "py311"
+target-version = "py310"
 extend-exclude = ["docs"]
 
 [tool.ruff.lint]

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/pyproject.toml.orig

@@ -1,12 +1,12 @@
 [project]
 name = "mgraphctl"
-version = "0.1.0"
+version = "0.2.1"
 description = "Microsoft Graph CLI behind the mgraphctl Claude Code skill"
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
 authors = [{ name = "Sviatoslav Sviridov", email = "sviridov@gmail.com" }]
-requires-python = ">=3.11,<3.14"
+requires-python = ">=3.10,<3.14"
 keywords = ["microsoft-graph", "microsoft-365", "outlook", "teams", "sharepoint", "onedrive", "cli"]
 classifiers = [
   "Development Status :: 4 - Beta",
@@ -15,6 +15,7 @@ classifiers = [
   "Intended Audience :: End Users/Desktop",
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -29,6 +30,7 @@ dependencies = [
   "markdownify>=1.2,<2",
   "keyring>=24,<26",
   "tzdata; sys_platform == 'win32'",
+  "tomli>=2,<3; python_version < '3.11'",
 ]
 
 [project.urls]
@@ -55,7 +57,7 @@ module-name = "mgraphctl"
 
 [tool.ruff]
 line-length = 100
-target-version = "py311"
+target-version = "py310"
 # Markdown under docs/ holds illustrative Python blocks; ruff must not rewrite them.
 extend-exclude = ["docs"]
 

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/src/mgraphctl/__init__.py

@@ -1,3 +1,3 @@
 """mgraphctl: Microsoft Graph CLI for the mgraphctl skill."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/src/mgraphctl/config.py

@@ -5,12 +5,17 @@ from __future__ import annotations
 
 import os
 import re
-import tomllib
+import sys
 from collections.abc import Iterable
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
+if sys.version_info >= (3, 11):
+    import tomllib
+else:  # tomllib is stdlib from 3.11; on 3.10 the same parser ships as tomli
+    import tomli as tomllib
+
 from mgraphctl import __version__
 
 CLIENT_ID_DEFAULT = "00000000-0000-0000-0000-000000000000"

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/src/mgraphctl/http.py

@@ -14,7 +14,7 @@ import time
 import uuid
 from collections.abc import Callable, Mapping
 from dataclasses import dataclass, field, replace
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Literal
 from urllib.parse import urlsplit
@@ -399,7 +399,7 @@ class GraphClient:
                 return float(min(int(value), config.RETRY_AFTER_CAP))
             with contextlib.suppress(TypeError, ValueError):
                 when = email.utils.parsedate_to_datetime(value)
-                seconds = (when - datetime.now(UTC)).total_seconds()
+                seconds = (when - datetime.now(timezone.utc)).total_seconds()
                 return max(0.0, min(seconds, config.RETRY_AFTER_CAP))
         base = self.retry_base_ms / 1000
         return min(2**attempt * base, config.BACKOFF_CAP) + random.uniform(0, base)

{mgraphctl-0.1.0 → mgraphctl-0.2.1}/src/mgraphctl/render.py

@@ -13,7 +13,7 @@ import sys
 import time
 from collections.abc import Callable
 from dataclasses import dataclass
-from datetime import UTC, date, datetime, timedelta
+from datetime import date, datetime, timedelta, timezone
 from pathlib import Path
 from typing import Any
 from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
@@ -343,7 +343,7 @@ def parse_graph_dt(value: str | None) -> datetime | None:
         dt = datetime.fromisoformat(text)
     except ValueError:
         return None
-    return dt if dt.tzinfo is not None else dt.replace(tzinfo=UTC)
+    return dt if dt.tzinfo is not None else dt.replace(tzinfo=timezone.utc)
 
 
 def fmt_dt(value: str | None, tz: str) -> str: