test: init test setup and some tests + dev docs and proper setup with pyproject.toml (#137)

* test: add init tests and setup for tests

Signed-off-by: Samantha Coyle <[email protected]>

* style: clean up unused / autogen files now

Signed-off-by: Samantha Coyle <[email protected]>

* style: ignore req files that we can now autogen

Signed-off-by: Samantha Coyle <[email protected]>

* style: make linter happy

Signed-off-by: Samantha Coyle <[email protected]>

* fix(build): pin deps

Signed-off-by: Samantha Coyle <[email protected]>

* style: update doc ordering

Signed-off-by: Samantha Coyle <[email protected]>

* fix(build): update imports

Signed-off-by: Samantha Coyle <[email protected]>

---------

Signed-off-by: Samantha Coyle <[email protected]>
Co-authored-by: Yaron Schneider <[email protected]>

Author: sicoyle

.github/workflows/build.yaml

@@ -62,4 +62,7 @@ jobs:
         pip install setuptools wheel tox
     - name: Check Typing
       run: |
-        tox -e type
+        tox -e type
+    - name: Run Tests
+      run: |
+        tox -e pytest

.github/workflows/docs.yml

@@ -5,11 +5,13 @@ on:
       - main
     paths:
       - docs/**
+      - '!docs/development/**'
   pull_request:
     branches:
       - main
     paths:
       - docs/**
+      - '!docs/development/**'
   workflow_dispatch:
 permissions:
   contents: write
@@ -29,6 +31,7 @@ jobs:
             docs:
               - 'docs/**'
               - 'mkdocs.yml'
+              - '!docs/development/**'
           base_sha: 'main'
 
   documentation_validation:

.gitignore

@@ -6,6 +6,7 @@ test
 
 # Byte-compiled / optimized / DLL files
 __pycache__/
+**/__pycache__/
 *.py[cod]
 *$py.class
 
@@ -168,4 +169,8 @@ cython_debug/
 
 .ruff_cache/
 
-quickstarts/05-multi-agent-workflow-dapr-workflows/services/**/*_state.json
+quickstarts/05-multi-agent-workflow-dapr-workflows/services/**/*_state.json
+
+# Requirements files since we use pyproject.toml instead
+requirements.txt
+dev-requirements.txt

README.md

@@ -66,7 +66,7 @@ As a part of **CNCF**, Dapr Agents is vendor-neutral, eliminating concerns about
 
 ## Roadmap
 
-Here are some of the major features we're working on for the current quarter:
+Here are some of the major features we're working on:
 
 ### Q2 2025
 - **MCP Support** - Integration with Anthropic's MCP platform ([#50](https://github.com/dapr/dapr-agents/issues/50) ✅ )
@@ -83,7 +83,6 @@ Here are some of the major features we're working on for the current quarter:
 
 For more details about these features and other planned work, please check out our [GitHub issues](https://github.com/dapr/dapr-agents/issues).
 
-
 ### Language Support
 
 | Language | Current Status | Development Status | Stable Status |
@@ -92,6 +91,17 @@ For more details about these features and other planned work, please check out o
 | .NET     | Planning | Q3 2025 | Q4 2025 |
 | Other Languages | Coming Soon | TBD | TBD |
 
+## Documentation
+
+- [Development Guide](docs/development/README.md) - For developers and contributors
+
+## Community
+
+### Contributing to Dapr Agents
+
+Please refer to our [Dapr Community Code of Conduct](https://github.com/dapr/community/blob/master/CODE-OF-CONDUCT.md)
+
+For development setup and guidelines, see our [Development Guide](docs/development/README.md).
 
 ## Getting Started
 
@@ -100,8 +110,6 @@ Prerequisites:
 - [Dapr CLI](https://docs.dapr.io/getting-started/install-dapr-cli/)
 - [Python 3.10](https://www.python.org/downloads/release/python-3100/)
 
-
-
 ### Install Dapr Agents
 
 ```bash
@@ -121,7 +129,3 @@ Dapr Agents is an open-source project under the CNCF umbrella, and we welcome co
 - Documentation: [https://dapr.github.io/dapr-agents/](https://dapr.github.io/dapr-agents/)
 - Community Discord: [Join the discussion](https://bit.ly/dapr-discord). 
 - Contribute: Open an issue or submit a PR to help improve Dapr Agents!
-
-## Code of Conduct
-
-Please refer to our [Dapr Community Code of Conduct](https://github.com/dapr/community/blob/master/CODE-OF-CONDUCT.md)

dapr_agents/__init__.py

@@ -1,6 +1,5 @@
 from dapr_agents.agent import (
     Agent,
-    AgentActor,
     ReActAgent,
     ToolCallAgent,
     OpenAPIReActAgent,

dapr_agents/agent/__init__.py

@@ -1,4 +1,3 @@
 from .base import AgentBase
 from .utils.factory import Agent
-from .actor import AgentActor
 from .patterns import ReActAgent, ToolCallAgent, OpenAPIReActAgent

dev-requirements.txt

@@ -0,0 +1,92 @@
+# Development Guide
+
+## Dependencies
+
+This project uses modern Python packaging with `pyproject.toml`. Dependencies are managed as follows:
+
+- Main dependencies are in `[project.dependencies]`
+- Test dependencies are in `[project.optional-dependencies.test]`
+- Development dependencies are in `[project.optional-dependencies.dev]`
+
+### Generating Requirements Files
+
+If you need to generate requirements files (e.g., for deployment or specific environments):
+
+```bash
+# Generate requirements.txt
+pip-compile pyproject.toml
+
+# Generate dev-requirements.txt
+pip-compile pyproject.toml --extra dev
+```
+
+### Installing Dependencies
+
+```bash
+# Install main package with test dependencies
+pip install -e ".[test]"
+
+# Install main package with development dependencies
+pip install -e ".[dev]"
+
+# Install main package with all optional dependencies
+pip install -e ".[test,dev]"
+```
+
+## Testing
+
+The project uses pytest for testing. To run tests:
+
+```bash
+# Run all tests
+tox -e pytest
+
+# Run specific test file
+tox -e pytest tests/test_random_orchestrator.py
+
+# Run tests with coverage
+tox -e pytest --cov=dapr_agents
+```
+
+## Code Quality
+
+The project uses several tools to maintain code quality:
+
+```bash
+# Run linting
+tox -e flake8
+
+# Run code formatting
+tox -e ruff
+
+# Run type checking
+tox -e type
+```
+
+## Development Workflow
+
+1. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+2. Run tests before making changes:
+   ```bash
+   tox -e pytest
+   ```
+
+3. Make your changes
+
+4. Run code quality checks:
+   ```bash
+   tox -e flake8
+   tox -e ruff
+   tox -e type
+   ```
+
+5. Run tests again:
+   ```bash
+   tox -e pytest
+   ```
+
+6. Submit your changes

docs/development/README.md

@@ -59,4 +59,7 @@ ignore_errors = False
 ignore_errors = True
 
 [mypy-dapr_agents.workflow.*]
-ignore_errors = True
+ignore_errors = True
+
+[mypy-dapr_agents.pubsub.*]
+ignore_errors = True

mypy.ini

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=61.0.0", "setuptools_scm"]
+requires = ["setuptools>=61.0", "setuptools_scm"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -13,6 +13,23 @@ license = {file = "LICENSE"}
 authors = [
     {name = "Dapr Authors", email = "[email protected]"}
 ]
+dependencies = [
+    "dapr>=1.15.0",
+    "pydantic>=2.11.3,<3.0.0",
+    "jinja2>=3.1.0",
+    "pyyaml>=6.0",
+    "requests>=2.31.0",
+    "openapi-pydantic>=0.3.0",
+    "rich==13.9.4",
+    "openai==1.75.0",
+    "azure-identity==1.21.0",
+    "huggingface_hub==0.30.2",
+    "colorama>=0.4.6",
+    "regex>=2023.0.0",
+    "fastapi>=0.110.0",
+    "uvicorn>=0.27.0",
+    "aiohttp>=3.9.0",
+]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
     "Intended Audience :: Developers",
@@ -25,28 +42,23 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 
-dependencies = [
-    "durabletask-dapr >= 0.2.0a7",
-    "pydantic == 2.11.3",
-    "openai == 1.75.0",
-    "openapi-pydantic == 0.5.1",
-    "openapi-schema-pydantic==1.2.4",
-    "regex >= 2023.12.25",
-    "Jinja2 >= 3.1.6",
-    "azure-identity == 1.21.0",
-    "dapr >= 1.15.0",
-    "dapr-ext-fastapi == 1.15.0",
-    "dapr-ext-workflow == 1.15.0",
-    "colorama == 0.4.6",
-    "cloudevents == 1.11.0",
-    "pyyaml == 6.0.2",
-    "rich == 13.9.4",
-    "huggingface_hub == 0.30.2",
-    "numpy == 2.2.2",
-    "mcp == 1.7.1",
-    "opentelemetry-distro == 0.53b1",
-    "opentelemetry-exporter-otlp == 1.32.1",
-    "opentelemetry-instrumentation-requests == 0.53b1",
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0",
+    "pytest-mock>=3.12.0",
+    "httpx>=0.27.0",  # For testing FastAPI endpoints
+]
+dev = [
+    "mypy==1.15.0",
+    "mcp==1.7.1",
+    "opentelemetry-distro==0.53b1",
+    "opentelemetry-exporter-otlp==1.32.1",
+    "opentelemetry-instrumentation-requests==0.53b1",
+    "dapr-ext-fastapi==1.15.0",
+    "dapr-ext-workflow==1.15.0",
+    "cloudevents==1.11.0",
 ]
 
 [project.urls]
@@ -59,4 +71,9 @@ exclude = ["tests"]
 
 [tool.setuptools_scm]
 version_scheme = "guess-next-dev"
-local_scheme = "no-local-version"
+local_scheme = "node-and-date"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+asyncio_mode = "auto"