tests

Python tests layout

Pytest discovers all test_*.py files under tests/. Shared helpers live at the package root (conftest.py, db_test_fakes.py, fixtures/).

Directory gates (mirror source packages)

Directory	Source package	Coverage config	CI / local gate
`tests/reporting/`	`website_profiling.reporting`	`.coveragerc.reporting`	`pytest tests/reporting/`
`tests/tools/`	`website_profiling.tools`	`.coveragerc.tools`	`pytest tests/tools/`
`tests/content_studio/`	`website_profiling.content_studio`	`.coveragerc` (core)	included in `pytest tests/`

Add new reporting or tools tests inside the matching directory — no need to edit file lists in ci.yml or local-test.sh.

Fixtures: shared files live in tests/fixtures/. Subpackage tests should import via from tests.conftest import FIXTURES (not Path(__file__).parent / "fixtures").

Content Studio

tests/content_studio/
  fakes.py           # shared LLM client doubles
  test_agent.py      # tool-calling analyze loop
  test_ai_suggest.py # rule/AI suggestions orchestration
  test_score.py      # GSC + on-page scoring
  test_tools.py      # deterministic analyze tools

API integration (`tests/api/`)

FastAPI routes are omitted from the core coverage gate (see .coveragerc). Use HTTP integration tests against a real Postgres instead:

tests/api/
  conftest.py              # TestClient + ephemeral property fixture
  test_api_integration.py  # @pytest.mark.integration — full route smoke + CRUD
  test_content_drafts_list.py
  test_report_loader_list.py

Requires DATABASE_URL (same as other @pytest.mark.integration tests). Run:

pytest tests/api/test_api_integration.py -m integration --no-cov

These tests catch response-shape regressions (camelCase vs snake_case), dict_row SQL bugs, and wrong column names that unit mocks miss.

Core (everything else)

Remaining tests/test_*.py files cover the core gate (100% on all packages except reporting/, tools/, and other omits in .coveragerc).

Browser integration tests stay at the top level (test_crawl_fetchers.py, test_crawler_browser_e2e.py) and run via @pytest.mark.browser.

Name		Name	Last commit message	Last commit date
parent directory ..
api		api
clients		clients
content_studio		content_studio
fixtures		fixtures
integrations		integrations
lighthouse		lighthouse
reporting		reporting
tools		tools
README.md		README.md
__init__.py		__init__.py
config_test_utils.py		config_test_utils.py
conftest.py		conftest.py
db_test_fakes.py		db_test_fakes.py
test_agent_readiness.py		test_agent_readiness.py
test_ai_migration_coverage.py		test_ai_migration_coverage.py
test_analysis.py		test_analysis.py
test_analysis_crawl_stores_edge_unit.py		test_analysis_crawl_stores_edge_unit.py
test_analysis_page.py		test_analysis_page.py
test_analysis_text.py		test_analysis_text.py
test_bing_webmaster.py		test_bing_webmaster.py
test_browser_auth_from_session.py		test_browser_auth_from_session.py
test_browser_fetcher_unit.py		test_browser_fetcher_unit.py
test_cli_dispatch.py		test_cli_dispatch.py
test_commands_config_stores_edge_unit.py		test_commands_config_stores_edge_unit.py
test_commands_page_gsc_unit.py		test_commands_page_gsc_unit.py
test_commands_wrappers_unit.py		test_commands_wrappers_unit.py
test_common_analysis_commands_db_unit.py		test_common_analysis_commands_db_unit.py
test_common_io.py		test_common_io.py
test_common_parsing.py		test_common_parsing.py
test_competitor_gap_store.py		test_competitor_gap_store.py
test_concurrency_coverage.py		test_concurrency_coverage.py
test_config_parsing_unit.py		test_config_parsing_unit.py
test_config_resolution.py		test_config_resolution.py
test_config_resolve_more.py		test_config_resolve_more.py
test_config_resolve_unit.py		test_config_resolve_unit.py
test_config_schema_keys.py		test_config_schema_keys.py
test_config_schema_sync.py		test_config_schema_sync.py
test_console_io.py		test_console_io.py
test_content_analysis.py		test_content_analysis.py
test_content_analysis_coverage.py		test_content_analysis_coverage.py
test_content_analysis_pdf.py		test_content_analysis_pdf.py
test_content_analysis_pipeline.py		test_content_analysis_pipeline.py
test_crawl_db_writer_imports.py		test_crawl_db_writer_imports.py
test_crawl_discovery.py		test_crawl_discovery.py
test_crawl_fetchers.py		test_crawl_fetchers.py
test_crawl_frontier.py		test_crawl_frontier.py
test_crawl_gap_coverage.py		test_crawl_gap_coverage.py
test_crawl_html_storage.py		test_crawl_html_storage.py
test_crawl_lighthouse_google_cmd_unit.py		test_crawl_lighthouse_google_cmd_unit.py
test_crawl_pause_resume.py		test_crawl_pause_resume.py
test_crawl_presets.py		test_crawl_presets.py
test_crawl_store_more.py		test_crawl_store_more.py
test_crawler_browser_e2e.py		test_crawler_browser_e2e.py
test_crawler_deep.py		test_crawler_deep.py
test_crawler_session_threadsafe.py		test_crawler_session_threadsafe.py
test_crawler_unit.py		test_crawler_unit.py
test_crux_fetch.py		test_crux_fetch.py
test_db_common.py		test_db_common.py
test_db_pipeline_jobs_unit.py		test_db_pipeline_jobs_unit.py
test_db_store_coverage_gaps.py		test_db_store_coverage_gaps.py
test_db_stores_unit.py		test_db_stores_unit.py
test_extraction.py		test_extraction.py
test_fetchers_sitemap_config_unit.py		test_fetchers_sitemap_config_unit.py
test_google_app_settings.py		test_google_app_settings.py
test_google_cmd_more.py		test_google_cmd_more.py
test_google_store_full.py		test_google_store_full.py
test_gsc_links_csv.py		test_gsc_links_csv.py
test_gsc_links_store.py		test_gsc_links_store.py
test_gsc_links_sync.py		test_gsc_links_sync.py
test_help_cmd.py		test_help_cmd.py
test_historical_keywords_crawl_store_unit.py		test_historical_keywords_crawl_store_unit.py
test_html_store.py		test_html_store.py
test_image_probe.py		test_image_probe.py
test_issue_impact.py		test_issue_impact.py
test_keyword_enrich.py		test_keyword_enrich.py
test_keyword_intent.py		test_keyword_intent.py
test_keyword_planner.py		test_keyword_planner.py
test_keywords_extraction.py		test_keywords_extraction.py
test_lighthouse_runner_flow_unit.py		test_lighthouse_runner_flow_unit.py
test_link_edges.py		test_link_edges.py
test_llm_config.py		test_llm_config.py
test_llm_selector_cache.py		test_llm_selector_cache.py
test_load_config_from_db.py		test_load_config_from_db.py
test_log_parser.py		test_log_parser.py
test_markdown_store.py		test_markdown_store.py
test_missing_points_batch.py		test_missing_points_batch.py
test_mobile_delta.py		test_mobile_delta.py
test_page_google.py		test_page_google.py
test_page_markdown.py		test_page_markdown.py
test_page_markdown_batch.py		test_page_markdown_batch.py
test_page_markdown_cmd.py		test_page_markdown_cmd.py
test_page_record.py		test_page_record.py
test_pipeline_cmd_run_unit.py		test_pipeline_cmd_run_unit.py
test_pipeline_lighthouse_url_selection.py		test_pipeline_lighthouse_url_selection.py
test_pool_and_report_store_unit.py		test_pool_and_report_store_unit.py
test_progress.py		test_progress.py
test_property_google.py		test_property_google.py
test_property_store_unit.py		test_property_store_unit.py
test_rich_results.py		test_rich_results.py
test_roadmap_extras.py		test_roadmap_extras.py

FilesExpand file tree

tests

Directory actions

More options

Directory actions

More options

Latest commit

History

tests

Folders and files

parent directory

README.md

Python tests layout

Directory gates (mirror source packages)

Content Studio

API integration (tests/api/)

Core (everything else)

API integration (`tests/api/`)