Async-Sharepoint 0.1.1__tar.gz

async_sharepoint-0.1.1/.editorconfig

@@ -0,0 +1,37 @@
+# https://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{html,css,js,json,sh,yml,yaml}]
+indent_size = 2
+
+[*.bat]
+indent_style = tab
+end_of_line = crlf
+
+[LICENSE]
+insert_final_newline = false
+
+[justfile]
+indent_style = space
+indent_size = 4
+
+# Ignore binary or generated files
+[*.{png,jpg,gif,ico,woff,woff2,ttf,eot,svg,pdf}]
+charset = unset
+end_of_line = unset
+indent_style = unset
+indent_size = unset
+trim_trailing_whitespace = unset
+insert_final_newline = unset
+max_line_length = unset
+
+[*.{diff,patch}]
+trim_trailing_whitespace = false

async_sharepoint-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,61 @@
+name: Bug Report
+description: Something isn't working as expected.
+title: "BUG: "
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to trigger the bug.
+      placeholder: |
+        1. Install with `uv pip install Async-Sharepoint`
+        2. Run `...`
+        3. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: "Async Sharepoint version"
+      placeholder: "0.1.0"
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      placeholder: "3.13"
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Logs, tracebacks, screenshots, or anything else that helps.
+    validations:
+      required: false

async_sharepoint-0.1.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

async_sharepoint-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature Request
+description: Suggest something new.
+title: "FEAT: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the feature
+    validations:
+      required: true
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: What problem does this solve? What's the use case?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+    validations:
+      required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+    validations:
+      required: false

async_sharepoint-0.1.1/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly
+    cooldown:
+      default-days: 7
+    open-pull-requests-limit: 5

async_sharepoint-0.1.1/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## What
+
+<!-- 1-3 sentences. Link the issue if there is one. -->
+
+## AI Provenance
+
+<!-- Remove this section for human-authored PRs. -->
+
+- **Tool:** <!-- Claude Code, Cursor, Copilot, Codex, etc. -->
+- **Model:** <!-- Claude Opus 4.6, GPT-4o, etc. -->
+- **Prompt/thread:** <!-- Paste your prompt or a link to the thread. -->
+
+## Checklist
+
+- [ ] Addresses exactly one issue or feature
+- [ ] New or changed behavior has test coverage
+- [ ] Diff contains only changes for this task

async_sharepoint-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,174 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # Runs for every commit, from anyone.
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Cache Rust build
+        uses: Swatinem/rust-cache@v2
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.14"
+
+      - name: Sync Python dependencies
+        run: uv sync
+
+      - name: cargo fmt --check
+        run: cargo fmt --check
+
+      - name: cargo clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+      - name: cargo test
+        run: cargo test
+
+      - name: ruff format --check
+        run: uv run --no-sync ruff format --check .
+
+      - name: ruff check
+        run: uv run --no-sync ruff check .
+
+      - name: ty check
+        run: uv run --no-sync ty check .
+
+      - name: maturin develop
+        run: uv run --no-sync maturin develop --uv
+
+      - name: pytest
+        run: uv run --no-sync pytest
+
+  # Only runs for pushes to main authored by deanm0000, and only after tests pass.
+  bump-version:
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main' && github.actor == 'deanm0000'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      version: ${{ steps.bump.outputs.version }}
+      tag: ${{ steps.bump.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Bump version
+        id: bump
+        run: python3 scripts/bump_version.py
+
+      - name: Commit and tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git commit -am "chore: bump version to ${{ steps.bump.outputs.version }}"
+          git tag "${{ steps.bump.outputs.tag }}"
+          git push origin HEAD:main
+          git push origin "${{ steps.bump.outputs.tag }}"
+
+  build-wheels:
+    needs: bump-version
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: windows-latest
+            target: x64
+          - os: macos-latest
+            target: universal2-apple-darwin
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.bump-version.outputs.tag }}
+
+      # abi3-py310 means one wheel per OS/arch covers Python 3.10-3.14.
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: auto
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: dist
+
+  build-sdist:
+    needs: bump-version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.bump-version.outputs.tag }}
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+  publish-pypi:
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+          merge-multiple: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          packages-dir: dist
+
+  publish-crate:
+    needs: bump-version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.bump-version.outputs.tag }}
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Publish core crate to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --manifest-path core/Cargo.toml

async_sharepoint-0.1.1/.gitignore

@@ -0,0 +1,58 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+build/
+dist/
+target/
+eggs/
+.eggs/
+*.egg-info/
+*.egg
+MANIFEST
+target
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+coverage.xml
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.envrc
+.venv
+
+# uv
+#   Generally recommended to include uv.lock in version control for
+#   reproducibility. Uncomment for libraries where you want consumers
+#   to resolve their own dependencies.
+# uv.lock
+
+# Ruff
+.ruff_cache/
+
+# Type checkers
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# Documentation build output
+site/
+
+# IDE files
+# .idea/
+# .vscode/
+test_comm.py
+test_projects.py

async_sharepoint-0.1.1/.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+  "chat.tools.terminal.autoApprove": {
+    "/^cargo check --message-format=short && uv build >/dev/null && uv pip install --python /tmp/async-sharepoint-py3\\.14/bin/python --reinstall dist/\\*\\.whl >/dev/null && python -m pytest tests/test_projects\\.py -q -x$/": {
+      "approve": true,
+      "matchCommandLine": true
+    }
+  }
+}

async_sharepoint-0.1.1/CHANGELOG/unreleased.md

@@ -0,0 +1,38 @@
+# Unreleased
+
+These are the changes that will go out in the next release.
+
+## Changed
+
+- **Breaking:** `SharePointClient` now takes a `CertificateCredential` instead of a `get_token`
+  callable. Authentication runs entirely in Rust, so no Python code executes on the request path.
+- Token refresh moved to a background task owned by the client. It refreshes five minutes before
+  expiry and on any 401 or 403, and entering the async context manager waits for the first token so
+  invalid credentials fail at connect time.
+- The token scope is now derived from the site host rather than supplied by the caller.
+- Replaced the Python runtime implementation with a PyO3 extension using Tokio and Reqwest.
+- Preserved the public async client method names and signatures.
+- Switched package builds from hatchling to maturin and removed the unused CLI metadata.
+- Published type information through `async_sharepoint.pyi`.
+
+## Added
+
+- `CertificateCredential` for the Entra ID certificate client-credentials flow.
+- `SharePointClient.from_static_token()` for wrapping a token you already hold.
+
+Async Sharepoint started out as a project generated from [Cookiecutter PyPackage](https://github.com/audreyfeldroy/cookiecutter-pypackage) containing:
+
+- Initial scaffold for Async Sharepoint.
+- `src/async_sharepoint/` package with CLI (Typer + Rich), py.typed marker
+- Tests with pytest, coverage across Python 3.12/3.13/3.14
+- CI via GitHub Actions: lint (Ruff), type check (ty), test matrix, coverage reporting
+- Security scanning: CodeQL analysis for public repositories, Dependabot, and a Zizmor workflow audit
+- Docs site with Zensical + mkdocstrings and a GitHub Pages deployment workflow
+- Trusted publishing to PyPI with OIDC and build provenance attestation
+- `justfile` with dev commands: qa, test, type-check, docs-serve, release
+- Issue templates, PR template, contributing guide, code of conduct, security policy
+- MIT license, .editorconfig, .gitignore
+
+### Contributors
+
+[@deanm0000](https://github.com/deanm0000) (Dean MacGregor) created Async Sharepoint.

async_sharepoint-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,163 @@
+# Contributing
+
+Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
+
+You can contribute in many ways:
+
+## Types of Contributions
+
+### Report Bugs
+
+Report bugs at https://github.com/deanm0000/Async-Sharepoint/issues.
+
+If you are reporting a bug, please include:
+
+- Your operating system name and version.
+- Any details about your local setup that might be helpful in troubleshooting.
+- Detailed steps to reproduce the bug.
+
+### Fix Bugs
+
+Look through the GitHub issues for bugs. Anything tagged with "bug" and "help wanted" is open to whoever wants to implement it.
+
+### Implement Features
+
+Look through the GitHub issues for features. Anything tagged with "enhancement" and "help wanted" is open to whoever wants to implement it.
+
+### Write Documentation
+
+Async Sharepoint could always use more documentation, whether as part of the official docs, in docstrings, or even on the web in blog posts, articles, and such.
+
+To preview the docs locally:
+
+```sh
+just docs-serve
+```
+
+This starts a local server at http://localhost:8000 with live reload. Edit
+files in `docs/` and run `just docs-build` to verify a production build.
+
+Docs deploy automatically on push to `main` after GitHub Pages is enabled. If
+the generator did not enable it, review the visibility implications first:
+[Pages sites can be public even when their repositories are private](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site),
+and the feature may require a paid GitHub plan for private repositories. Then
+go to Settings > Pages, set the source to **GitHub Actions**, and enable the
+deployment workflow:
+
+```bash
+gh variable set DOCS_DEPLOYMENT_ENABLED \
+    --repo deanm0000/Async-Sharepoint \
+    --body true
+```
+
+Until then, deployment stays paused and local preview and builds still work.
+
+### Submit Feedback
+
+The best way to send feedback is to file an issue at https://github.com/deanm0000/Async-Sharepoint/issues.
+
+If you are proposing a feature:
+
+- Explain in detail how it would work.
+- Keep the scope as narrow as possible, to make it easier to implement.
+- Remember that this is a volunteer-driven project, and that contributions are welcome :)
+
+## Get Started!
+
+Ready to contribute? Here's how to set up Async-Sharepoint for local development.
+
+1. Fork the Async-Sharepoint repo on GitHub.
+2. Clone your fork locally:
+
+   ```sh
+   git clone git@github.com:your_name_here/Async-Sharepoint.git
+   ```
+
+3. Install your local copy with uv:
+
+   ```sh
+   cd Async-Sharepoint/
+   uv sync
+   uv run maturin develop --uv
+   ```
+
+   Building the extension requires Rust 1.88 or newer. Rust dependencies are
+   pinned in `Cargo.lock` and Python dependencies are pinned in `uv.lock`.
+
+4. Create a branch for local development:
+
+   ```sh
+   git checkout -b name-of-your-bugfix-or-feature
+   ```
+
+   Now you can make your changes locally.
+
+5. When you're done making changes, verify formatting, linting, types, and tests without modifying files:
+
+   ```sh
+   just check
+   ```
+
+   Use `just fix` to apply Ruff's automatic fixes, or `just fix-and-check` to apply them before verification.
+
+   Or run the tests alone:
+
+   ```sh
+   just test
+   ```
+
+6. Commit your changes and push your branch to GitHub:
+
+   ```sh
+   git add .
+   git commit -m "Your detailed description of your changes."
+   git push origin name-of-your-bugfix-or-feature
+   ```
+
+7. Submit a pull request through the GitHub website.
+
+## Pull Request Guidelines
+
+Before you submit a pull request, check that it meets these guidelines:
+
+1. The pull request should include tests.
+2. If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.md.
+3. The pull request should pass `cargo fmt`, Clippy, Rust tests, and the Python 3.12, 3.13, and 3.14 test suite.
+
+## Tips
+
+To run a subset of tests:
+
+```sh
+uv run pytest tests/
+```
+
+## Releasing a New Version
+
+1. **Bump the version:**
+   ```bash
+   uv version <version>        # or: uv version --bump minor
+   ```
+2. **Commit:**
+   ```bash
+   git add pyproject.toml uv.lock
+   git commit -m "Bump version to <version>"
+   ```
+3. **Release:**
+   ```bash
+   just release
+   ```
+   This finalizes `CHANGELOG/unreleased.md` as
+   `CHANGELOG/<version>.md`, creates a fresh unreleased file, commits and
+   pushes that notes commit, then creates an annotated `v*` tag and GitHub
+   Release. The tag push triggers `.github/workflows/publish.yml`, which
+   builds the package, generates SLSA provenance attestations, and publishes
+   to PyPI via trusted publishing.
+
+Record release-worthy changes in `CHANGELOG/unreleased.md` as they merge.
+Projects generated before this changelog lifecycle was introduced remain
+compatible when they already have a versioned changelog file.
+
+## Code of Conduct
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.