update contributing

Author: kellerza

.github/workflows/python-app.yml

@@ -9,7 +9,7 @@ on:
 env:
   DEFAULT_PYTHON: "3.10"
   RUFF_VERSION: 0.14.10
-  UV_VERSION: 0.9.18
+  UV_VERSION: 0.9.22
 
 permissions:
   contents: read
@@ -21,7 +21,9 @@ jobs:
       - uses: actions/checkout@v6
       - uses: chartboost/ruff-action@v1
         with:
+          args: "check --fix"
           version: ${{ env.RUFF_VERSION }}
+      # A proposal to replace black & pylint
       # - uses: chartboost/ruff-action@v1
       #   with:
       #     args: "format --check"
@@ -30,7 +32,7 @@ jobs:
   black:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v3
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
@@ -39,7 +41,7 @@ jobs:
   pylint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v4
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
@@ -51,7 +53,7 @@ jobs:
         run: uv sync --frozen --all-extras
       - name: Run Pylint
         run: |
-          uv run pylint --disable=too-many-positional-arguments office365
+          uv run pylint office365
 
   pytest:
     runs-on: ubuntu-latest

.pre-commit-config.yaml

@@ -27,15 +27,15 @@ repos:
       #   language: system
       #   pass_filenames: false
 
+      - id: black
+        name: black
+        entry: uv run black .
+        language: system
+        pass_filenames: false
+
       - id: pylint
         name: pylint
         entry: uv run pylint office365
         language: system
         pass_filenames: false
 
-  - repo: https://github.com/psf/black
-    rev: 23.9.1
-    hooks:
-      - id: black
-        args:
-          - --quiet

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-## Welcome Contributors! 🎉
+# Welcome Contributors! 🎉
 
 Thank you for your interest in contributing to the Office365-REST-Python-Client library. This project provides a comprehensive Python client for Microsoft 365 and Microsoft Graph APIs.
 
@@ -34,26 +34,17 @@ cd Office365-REST-Python-Client
 
 ## Development Environment Setup
 
-### Virtual Environment
+Activate the Virtual Environment and install dependencies:
 
 ```bash
-python3 -m venv venv
-. venv/bin/activate  # On Windows: venv\Scripts\activate
-```
-
-### Install Dependencies
-
-```bash
-pip install -r requirements.txt
-pip install -r requirements-dev.txt
+uv sync --all-extras
 ```
 
 ### Pre-commit hooks (recommended)
 
 ```bash
-pip install pre-commit
-pre-commit install
-pre-commit run -a
+uv tool install prek
+prek run --all-files
 ```
 
 ## Code Style and Quality Standards
@@ -69,9 +60,7 @@ Line length: 121 characters (configured in `pyproject.toml`).
 Run locally before pushing:
 
 ```bash
-black .
-ruff check .
-pylint office365
+prek
 ```
 
 ## Testing Guidelines
@@ -82,15 +71,15 @@ Most tests are end-to-end and require actual Microsoft 365 credentials.
 
 1. Create a `.env` file in the project root:
 
-```bash
-export office365_python_sdk_securevars='{username};{password};{client_id};{client_secret}'
-```
+   ```bash
+   export office365_python_sdk_securevars='{username};{password};{client_id};{client_secret}'
+   ```
 
 2. Source the environment file:
 
-```bash
-. .env
-```
+   ```bash
+   . .env
+   ```
 
 Note: The order of values is significant because tests parse by index.
 
@@ -128,9 +117,9 @@ CI note: Full E2E tests in CI rely on repository secrets and may not run on fork
 
 1. Create a feature branch from `master`:
 
-```bash
-git checkout -b feature/your-feature-name
-```
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
 
 2. Make your changes with clear, focused commits
 3. Ensure all tests pass and quality checks are satisfied
@@ -180,5 +169,3 @@ This project is maintained by the community. Be respectful and constructive in a
 ### License
 
 MIT License. By contributing, you agree that your contributions are licensed under these terms.
-
-

examples/sharepoint/files/download_from_lib.py

@@ -22,7 +22,6 @@
 download_root_path = Path(tempfile.mkdtemp())
 
 for item in items:
-
     download_path = download_root_path / item.properties.get("FileDirRef").lstrip("/")
     download_path.mkdir(parents=True, exist_ok=True)
 

generator/generate_model.py

@@ -1,4 +1,3 @@
-
 from generator import load_settings
 from generator.builders.type_builder import TypeBuilder
 from office365.runtime.odata.v3.metadata_reader import ODataV3Reader

office365/azure_env.py

@@ -1,5 +1,4 @@
 class AzureEnvironment(object):
-
     Global = "Global"
     """Referred to as Azure or Azure Global."""
 

office365/directory/serviceprincipals/service_principal.py

@@ -259,7 +259,6 @@ def _get_application_permissions(app_id):
                     return_type.value.add(app_role)
 
         def _resolve_app():
-
             def _after(service_principal):
                 _get_application_permissions(service_principal.id)
 

office365/migration/assessment/scanners/base.py

@@ -33,7 +33,6 @@ def wrapper(self):
 
 
 class BaseScanner(ABC, Generic[T]):
-
     def __init__(self, source):
         # type: (T) -> None
         self.source = source

office365/migration/assessment/scanners/list.py

@@ -6,7 +6,6 @@
 
 
 class ListScanner(BaseScanner[List]):
-
     @property
     def files_count(self):
         return self._properties.get("FilesCount", None)

office365/sharepoint/authpolicy/events/event.py

@@ -2,7 +2,6 @@
 
 
 class SPAuthEvent(Entity):
-
     @property
     def entity_type_name(self):
         return "Microsoft.SharePoint.AuthPolicy.Events.SPAuthEvent"