2022-01-23 18:47:06 +01:00
|
|
|
.DEFAULT_GOAL := help
|
2021-10-14 16:48:42 +02:00
|
|
|
PY_SOURCE ?= ingestion/src
|
2021-08-01 14:27:44 -07:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: help
|
|
|
|
help:
|
|
|
|
@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[35m%-30s\033[0m %s\n", $$1, $$2}'
|
|
|
|
|
|
|
|
.PHONY: env38
|
2021-08-01 14:27:44 -07:00
|
|
|
env38:
|
2022-01-23 18:47:06 +01:00
|
|
|
python3.8 -m venv env38
|
|
|
|
|
|
|
|
.PHONY: clean_env37
|
2021-08-01 14:27:44 -07:00
|
|
|
clean_env37:
|
|
|
|
rm -rf env38
|
2021-10-14 16:48:42 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: install
|
|
|
|
install: ## Install the ingestion module to the current environment
|
|
|
|
python -m pip install ingestion/
|
2021-10-15 00:22:59 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: install_test
|
|
|
|
install_test: ## Install the ingestion module with test dependencies
|
|
|
|
python -m pip install "ingestion[test]/"
|
2021-10-15 00:22:59 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: install_dev
|
|
|
|
install_dev: ## Install the ingestion module with dev dependencies
|
|
|
|
python -m pip install "ingestion[dev]/"
|
2021-10-21 23:51:38 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: precommit_install
|
|
|
|
precommit_install: ## Install the project's precommit hooks from .pre-commit-config.yaml
|
2021-10-15 00:22:59 +02:00
|
|
|
@echo "Installing pre-commit hooks"
|
2022-01-23 18:47:06 +01:00
|
|
|
@echo "Make sure to first run install_test first"
|
2022-01-07 03:53:21 +01:00
|
|
|
pre-commit install
|
2021-10-15 00:22:59 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Python Checkstyle
|
|
|
|
.PHONY: lint
|
|
|
|
lint: ## Run pylint on the Python sources to analyze the codebase
|
2021-10-14 16:48:42 +02:00
|
|
|
find $(PY_SOURCE) -path $(PY_SOURCE)/metadata/generated -prune -false -o -type f -name "*.py" | xargs pylint
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: py_format
|
|
|
|
py_format: ## Run black and isort to format the Python codebase
|
|
|
|
isort $(PY_SOURCE) --skip $(PY_SOURCE)/metadata/generated --profile black --multi-line 3
|
2021-10-14 16:48:42 +02:00
|
|
|
black $(PY_SOURCE) --exclude $(PY_SOURCE)/metadata/generated
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: py_format_check
|
|
|
|
py_format_check: ## Check if Python sources are correctly formatted
|
2021-10-14 16:48:42 +02:00
|
|
|
black --check --diff $(PY_SOURCE) --exclude $(PY_SOURCE)/metadata/generated
|
2022-01-23 18:47:06 +01:00
|
|
|
isort --check-only $(PY_SOURCE) --skip $(PY_SOURCE)/metadata/generated --profile black --multi-line 3
|
2021-10-21 23:51:38 +02:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Ingestion models generation
|
|
|
|
.PHONY: generate
|
|
|
|
generate: ## Generate the pydantic models from the JSON Schemas to the ingestion module
|
2021-11-23 04:36:05 +05:30
|
|
|
@echo "Running Datamodel Code Generator"
|
2022-01-22 21:08:14 +01:00
|
|
|
@echo "Make sure to first run the install_dev recipe"
|
2022-01-23 18:47:06 +01:00
|
|
|
datamodel-codegen --input catalog-rest-service/src/main/resources/json --input-file-type jsonschema --output ingestion/src/metadata/generated
|
|
|
|
$(MAKE) install
|
2021-11-21 17:02:31 +01:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Ingestion tests & QA
|
|
|
|
.PHONY: run_ometa_integration_tests
|
|
|
|
run_ometa_integration_tests: ## Run Python integration tests
|
2022-01-07 10:28:38 +01:00
|
|
|
coverage run -m pytest -c ingestion/setup.cfg --doctest-modules --junitxml=ingestion/junit/test-results-integration.xml --override-ini=testpaths="ingestion/tests/integration/ometa ingestion/tests/integration/stage"
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: unit_ingestion
|
|
|
|
unit_ingestion: ## Run Python unit tests
|
2022-01-07 10:28:38 +01:00
|
|
|
coverage run -m pytest -c ingestion/setup.cfg -s --doctest-modules --junitxml=ingestion/junit/test-results-unit.xml --override-ini=testpaths="ingestion/tests/unit"
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: coverage
|
|
|
|
coverage: ## Run all Python tests and generate the coverage report
|
2022-01-07 10:28:38 +01:00
|
|
|
coverage erase
|
2022-01-23 18:47:06 +01:00
|
|
|
$(MAKE) unit_ingestion
|
|
|
|
$(MAKE) run_ometa_integration_tests
|
2022-01-07 10:28:38 +01:00
|
|
|
coverage xml -i -o ingestion/coverage.xml
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: sonar_ingestion
|
|
|
|
sonar_ingestion: ## Run the Sonar analysis based on the tests results and push it to SonarCloud
|
2022-01-07 10:28:38 +01:00
|
|
|
docker run \
|
|
|
|
--rm \
|
|
|
|
-e SONAR_HOST_URL="https://sonarcloud.io" \
|
|
|
|
-e SONAR_LOGIN=$(token) \
|
|
|
|
-v ${PWD}:/usr/src \
|
|
|
|
sonarsource/sonar-scanner-cli \
|
|
|
|
-Dproject.settings=ingestion/sonar-project.properties
|
2021-11-25 11:50:36 +05:30
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Ingestion publish
|
|
|
|
.PHONY: publish
|
|
|
|
publish: ## Publish the ingestion module to PyPI
|
|
|
|
$(MAKE) install_dev generate
|
2021-11-21 17:02:31 +01:00
|
|
|
cd ingestion; \
|
|
|
|
python setup.py install sdist bdist_wheel; \
|
|
|
|
twine check dist/*; \
|
|
|
|
twine upload dist/*
|
2021-12-18 16:41:38 +01:00
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Docker operators
|
|
|
|
.PHONY: build_docker_base
|
|
|
|
build_docker_base: ## Build the base Docker image for the Ingestion Framework Sources
|
|
|
|
$(MAKE) install_dev generate
|
2021-12-18 16:41:38 +01:00
|
|
|
docker build -f ingestion/connectors/Dockerfile-base ingestion/ -t openmetadata/ingestion-connector-base
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: build_docker_connectors
|
|
|
|
build_docker_connectors: ## Build all Ingestion Framework Sources Images to be used as Docker Operators in Airflow
|
2021-12-18 16:41:38 +01:00
|
|
|
@echo "Building Docker connectors. Make sure to run build_docker_base first"
|
|
|
|
python ingestion/connectors/docker-cli.py build
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: push_docker_connectors
|
|
|
|
push_docker_connectors: ## Push all Sources Docker Images to DockerHub
|
2021-12-18 16:41:38 +01:00
|
|
|
@echo "Pushing Docker connectors. Make sure to run build_docker_connectors first"
|
|
|
|
python ingestion/connectors/docker-cli.py push
|
2021-12-28 23:16:52 +05:30
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
## Yarn
|
|
|
|
.PHONY: yarn_install_cache
|
|
|
|
yarn_install_cache: ## Use Yarn to install UI dependencies
|
2021-12-28 23:16:52 +05:30
|
|
|
cd openmetadata-ui/src/main/resources/ui && yarn install --frozen-lockfile
|
|
|
|
|
2022-01-23 18:47:06 +01:00
|
|
|
.PHONY: yarn_start_dev_ui
|
|
|
|
yarn_start_dev_ui: ## Run the UI locally with Yarn
|
2021-12-28 23:16:52 +05:30
|
|
|
cd openmetadata-ui/src/main/resources/ui && yarn start
|
2022-01-23 18:47:06 +01:00
|
|
|
|
|
|
|
## Ingestion Core
|
|
|
|
.PHONY: core_install_dev
|
|
|
|
core_install_dev: ## Prepare a virtualenv for the ingestion-core module
|
|
|
|
cd ingestion-core; \
|
|
|
|
rm -rf venv; \
|
|
|
|
python -m virtualenv venv; \
|
|
|
|
. venv/bin/activate; \
|
|
|
|
python -m pip install ".[dev]"
|
|
|
|
|
|
|
|
.PHONY: core_clean
|
|
|
|
core_clean: ## Clean the ingestion-core generated files
|
|
|
|
rm -rf ingestion-core/src/metadata/generated
|
|
|
|
rm -rf ingestion-core/build
|
|
|
|
rm -rf ingestion-core/dist
|
|
|
|
|
|
|
|
.PHONY: core_generate
|
|
|
|
core_generate: ## Generate the pydantic models from the JSON Schemas to the ingestion-core module
|
|
|
|
$(MAKE) core_install_dev
|
|
|
|
mkdir -p ingestion-core/src/metadata/generated
|
|
|
|
. ingestion-core/venv/bin/activate
|
|
|
|
datamodel-codegen --input catalog-rest-service/src/main/resources/json --input-file-type jsonschema --output ingestion-core/src/metadata/generated
|
|
|
|
|
|
|
|
.PHONY: core_bump_version_dev
|
|
|
|
core_bump_version_dev: ## Bump a `dev` version to the ingestion-core module. To be used when schemas are updated
|
|
|
|
$(MAKE) core_install_dev
|
|
|
|
cd ingestion-core; \
|
|
|
|
. venv/bin/activate; \
|
|
|
|
python -m incremental.update metadata --dev
|
|
|
|
|
|
|
|
.PHONY: core_publish
|
|
|
|
core_publish: ## Install, generate and publish the ingestion-core module to Test PyPI
|
|
|
|
$(MAKE) core_clean core_generate
|
|
|
|
cd ingestion-core; \
|
|
|
|
. venv/bin/activate; \
|
|
|
|
python setup.py install sdist bdist_wheel; \
|
|
|
|
twine check dist/*; \
|
|
|
|
twine upload -r testpypi dist/*
|