Makefile

.PHONY: sphinx-docs
sphinx-docs: docs/sphinx/html/index.html
	$(MAKE) -C sphinx clean
	$(MAKE) -C sphinx html


sphinx-serve: sphinx-docs
	python -m http.server


docs/sphinx/html/index.html:
	$(MAKE) -C sphinx clean
	$(MAKE) -C sphinx html


docs/sphinx/sections/onchain/coreschemas.md:
	uv run opdata misc generate_docs

.PHONY: dbt-docs
dbt-docs: docs/dbt/index.html


.PHONY: dbt-docs-open
dbt-docs-open: docs/dbt/index.html
	open docs/dbt/index.html
	

# Generate dbt sources from op_datasets schema definitions
dbt/sources/superchain_oplabs.yml:
	uv run opdata misc generate_dbt


# Generate dbt docs
#
# NOTE (pedro - 2024/09/24) There is a bug in the "_get_one_catalog" function in dbt/adapters/base/impl.py
# For the duckdb adapter the get_one_catalog macro requires "needs_conn=True" but that kwarg is not set
# This causes the "docs generate" command to fail unless we use --empty-catalog.
#
# The second command here is to customize the docs site and bundle it up as a single static HTML file.
docs/dbt/index.html: dbt/sources/superchain_oplabs.yml docs/dbt/optimism.css $(wildcard dbt/docs/*.md)
	./scripts/dbt_docs.sh
	uv run opdata misc customize_dbt