Add comprehensive msgraphfs enhancements

This commit introduces major enhancements to make msgraphfs more intuitive
to use.

- Support URL-based filesystem paths (msgd://site/drive/path)
- Enable single filesystem instance to access multiple SharePoint sites
- Add automatic site and drive discovery from URLs
- Support msgd://, sharepoint://, and onedrive:// protocols

- Add AZURE_* environment variable fallback support
- Implement robust OAuth2 token management with automatic refresh
- Support both client credentials and delegated authentication flows

- Implement lazy HTTP client initialization to prevent fork issues
- Add process ID tracking to detect forks and reinitialize clients
- Make filesystem safe for multi-process environments like Airflow
- Resolve threading and subprocess compatibility problems

- Add comprehensive file permissions API (get_permissions method)
- Extended metadata with SharePoint-specific fields (weburl, fields)
- Include permission analysis with user, group, and link breakdown
- Support expand parameters for additional metadata retrieval

- Replace content.py with proper pytest fixtures in conftest.py
- Add comprehensive live credential testing capabilities
- Implement environment variable configuration for test credentials
- Add OAuth2 integration tests and URL parsing validation

- Extensive documentation updates with usage examples
- Multiple protocol registration for fsspec integration
- Improved error messages and debugging information
- Add support for Python 3.10+

The changes maintain full backward compatibility while adding:
- Session-scoped pytest fixtures for better test performance
- Lazy initialization patterns for resource management
- Comprehensive URL parsing for flexible path specifications
- Multi-tenancy support with filesystem instance caching

Author: bolkedebruin

.github/workflows/test.yml

@@ -0,0 +1,81 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: |
+        uv sync --all-extras --dev
+
+    - name: Lint with ruff
+      run: |
+        uv run ruff check .
+
+    - name: Run tests (excluding live credential tests)
+      run: |
+        uv run pytest tests/ -v -m "not live" --cov=msgraphfs --cov-report=xml --cov-report=term-missing
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: ./coverage.xml
+        fail_ci_if_error: true
+
+  test-with-credentials:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    environment: testing-with-credentials
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: |
+        uv sync --all-extras --dev
+
+    - name: Run live credential tests (if credentials available)
+      env:
+        MSGRAPHFS_CLIENT_ID: ${{ secrets.MSGRAPHFS_CLIENT_ID }}
+        MSGRAPHFS_TENANT_ID: ${{ secrets.MSGRAPHFS_TENANT_ID }}
+        MSGRAPHFS_CLIENT_SECRET: ${{ secrets.MSGRAPHFS_CLIENT_SECRET }}
+      run: |
+        if [ -n "$MSGRAPHFS_CLIENT_ID" ] && [ -n "$MSGRAPHFS_TENANT_ID" ] && [ -n "$MSGRAPHFS_CLIENT_SECRET" ]; then
+          echo "Running live credential tests..."
+          uv run pytest tests/ -v -m "live" --tb=short
+        else
+          echo "Skipping live credential tests - credentials not configured"
+        fi