Update README, CI, and Docs Setup

.github/workflows/docs.yml

@@ -0,0 +1,29 @@
+name: Publish docs via GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Configure Git user
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

.github/workflows/python-package.yml

@@ -0,0 +1,30 @@
+name: Python package
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11"]
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+    - name: Test with pytest
+      run: |
+        pytest

README.md

@@ -34,20 +34,26 @@ The `did` library provides a framework for managing and querying data that is or
     source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
     ```
 
-3.  **Install the required dependencies:**
+3.  **Install the package and dependencies:**
     ```bash
-    pip install -r requirements.txt
+    pip install -e ".[dev]"
     ```
 
 ### Running the Tests
 
-To run the test suite, use the following command:
+You can run the tests using either `pytest` (if you installed the development dependencies) or the standard `unittest` module.
 
+**Using pytest (Recommended for development):**
 ```bash
-find . -name "test_*.py" -exec python -m unittest {} +
+pytest
 ```
 
-This will discover and run all the tests in the `tests` directory.
+**Using unittest (Standard):**
+```bash
+python -m unittest discover tests
+```
+
+Both commands will discover and run all the tests in the `tests` directory.
 
 ## Documentation
 

docs/api.md

@@ -0,0 +1,3 @@
+# API Reference
+
+Coming soon.

mkdocs.yml

@@ -1,4 +1,6 @@
 site_name: DID-Python
+theme:
+  name: material
 nav:
     - Home: index.md
     - API Reference: api.md

pyproject.toml

@@ -24,6 +24,7 @@ dev = [
     "mkdocs",
     "mkdocs-material",
     "mkdocstrings[python]",
+    "pytest",
 ]
 
 [tool.setuptools]