d365fo-client copilot-instructions.md

Copilot instructions for d365fo-client

Build, test, and lint commands

Use uv for local commands and dependency management.

# install dependencies
uv sync --dev

# full test suite
uv run pytest

# unit tests only
uv run pytest tests/unit

# integration tests only
uv run pytest tests/integration

# run one test file
uv run pytest tests/unit/test_cli.py

# run one test case
uv run pytest tests/unit/test_cli.py::TestCLIManager::test_config_list_empty

# run one integration file directly
uv run pytest tests/integration/test_sandbox_crud.py

# run sandbox integration suite through the project runner
uv run python tests/integration/test_runner.py sandbox --verbose

# run one sandbox integration file through the runner
uv run python tests/integration/test_runner.py sandbox --test test_sandbox_crud.py

# formatting and linting
uv run black --check .
uv run isort --check-only .
uv run ruff check .
uv run mypy src/

# build
uv build

Cross-platform wrappers exist and mirror the same workflows:

• Unix: make dev, make quality-check, make test-unit, make build
• PowerShell: .\make.ps1 dev, .\make.ps1 quality-check, .\make.ps1 test-unit, .\make.ps1 build

CI installs with uv sync --all-extras, runs uv run pytest tests/ --cov=src/ --cov-report=xml, and builds with uv build.

High-level architecture

This repo has three connected surfaces that share the same core client:

1. Python client: src/d365fo_client/client.py defines FOClient, which composes auth, HTTP session management, CRUD helpers, metadata API helpers, and label operations. Metadata is initialized lazily and uses the V2 cache/search/sync stack under src/d365fo_client/metadata_v2/.
2. CLI: src/d365fo_client/main.py builds the argparse tree, and src/d365fo_client/cli.py routes commands through CLIManager, which resolves config and then runs the same FOClient.
3. MCP server: src/d365fo_client/mcp/fastmcp_main.py is the entry point, fastmcp_server.py assembles the FastMCP server, and tool implementations live in mixins under src/d365fo_client/mcp/mixins/. D365FOClientManager pools FOClient instances per profile for MCP use.