Add python_project() function

.changelog/_unreleased.toml

@@ -0,0 +1,161 @@
+[[entries]]
+id = "d9440e6f-b19b-4b49-bad4-dc7860228cf8"
+type = "improvement"
+description = "Add order-only dependencies between check and format tasks created for Python projects"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "84e8fb46-7aef-4dfc-b4ec-5ad507c82544"
+type = "improvement"
+description = "`build_docker_image(dockerfile)` now treats the path relative to the current project"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "788398a7-320e-45b2-9590-d977387c2ed1"
+type = "improvement"
+description = "Override `MaturinPoetryPyprojectHandler.get_python_version_constraint()` to fall back on `[project.version]` key if `[tool.poetry.version]` is not set"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "ef21ce61-3e39-4177-9182-72c67e80be63"
+type = "feature"
+description = "Add `pex_set_global_store_path()` function"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "79e9748a-4d81-4636-be2e-3772b150c976"
+type = "feature"
+description = "Add `python_app()` function to build a PEX from your Python project."
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "897d94dc-79e7-45bf-abba-bd346a3fb7d5"
+type = "feature"
+description = "Add `PexBuildTask.always_rebuild` property and add `pex_build(always_rebuild, output_file)` parameters"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "1ae440c5-cd7a-4fdc-a6a9-da10165fa260"
+type = "feature"
+description = "Add `ProtocTask` to `kraken.std.protobuf`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "691608ae-68bd-45d6-abbb-bb6a1b7200eb"
+type = "breaking change"
+description = "Remove `buf_lint()` and `buf_format()` helper functions from `kraken.std.protobuf`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "07fb65a6-fe5a-420a-ad96-36a50714dee1"
+type = "feature"
+description = "Add `kraken.std.util.fetch_tarball()`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "ec6bf736-6a6e-4625-9703-89bff7094d56"
+type = "breaking change"
+description = "Add `enable_error_code = \"ignore-without-code, possibly-undefined\"` to default Mypy settings"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "33f61844-e82b-40da-aba9-f552142d6abd"
+type = "improvement"
+description = "`Supplier.of()` and related functions now take an `Iterable[Supplier[Any]]` as the `derived_from` parameter instead of a `Sequence` as it is converted to a `tuple` later anyway."
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "6bddf45d-7195-42d9-a490-2a567371d7f4"
+type = "feature"
+description = "Add `kraken.build.experimental.functional.v1` API with common tasks for operations in a functional manner (fetching a file, tarball, writing a file and executing a shell command)"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "640c9b5a-e459-429c-8aa1-b92430cb5065"
+type = "feature"
+description = "Install Buffrs CLI from GitHub releases"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "6cd1582c-d975-4888-809c-89cd7d66073c"
+type = "improvement"
+description = "`buffrs.install` task now produces a `.gitignore` file in the `proto/vendor` directory to exclude it"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "f8a491fb-daea-4279-b5d6-eb15f73a847b"
+type = "breaking change"
+description = "Remove `BufLintTask` and `BufInstallTask` in favor of `buf()` function that uses our new `kraken.build.experimental.functional.v1` API to implement the same functionality more streamlined"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "7d264f42-d0c1-4077-9fbb-c869ab093b46"
+type = "improvement"
+description = "Pass a default `buf.yaml` configuration to `buf lint` to disable `PACKAGE_VERSION_SUFFIX` and `PACKAGE_DIRECTORY_MATCH` lint rules for compatibility with Buffrs."
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "a8814dcb-b28b-42ed-aa0b-92297a63877d"
+type = "fix"
+description = "Remove default files that should be excluded for `isort`, `pycln` and `black` so that a `build/` directory in the `src/` directory also gets checked. We can do this safely because we expect the `src/` folder in a Python project to contain only files that should be checked unless otherwise explicitly specified"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "863c7431-cfb0-4491-a6c1-7209a6e2cf59"
+type = "feature"
+description = "Add `Supplier.agg()`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "16b2de57-29c2-410f-816a-018e9812871b"
+type = "feature"
+description = "Add `kraken.build.protobuf.v1alpha1.protobuf_project()`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "54f6e294-e60f-402a-97ae-17cbce9e8bc6"
+type = "feature"
+description = "add `pex_build(python_shebang)` parameter"
+author = "[email protected]"
+
+[[entries]]
+id = "9ac5c38b-cb7c-4aa2-bd01-5cf3601dc953"
+type = "feature"
+description = "Add `pex_build(python_versions)`"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "2b5d4590-5c9b-4fd0-a15f-87d93adb6e7e"
+type = "improvement"
+description = "Improve the `--cache-to` argument produced by the `BuildxBuildTask.cache_repo` property to include `image-manifest=true,oci-mediatypes=true` options for better OCI registry support (see https://aws.amazon.com/blogs/containers/announcing-remote-cache-support-in-amazon-ecr-for-buildkit-clients/)"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "5a4c9349-429d-4594-805b-404ed45020c3"
+type = "improvement"
+description = "Expose the `locked` property of `CargoBuildTask` via the `cargo_build` helper function"
+author = "[email protected]"
+
+[[entries]]
+id = "4560750d-452d-43f0-af08-d791aaf5134a"
+type = "improvement"
+description = "Upgrade keyring to v25"
+author = "@NiklasRosenstein"
+
+[[entries]]
+id = "fb3fcc4a-a38a-445f-b124-571395b7ac86"
+type = "feature"
+description = "Introduce `kraken.std.python.project.python_project()` function which creates all tasks for a Python project."
+author = "[email protected]"
+
+[[entries]]
+id = "ae70e553-81c2-4eb2-a6f3-210ca6c24992"
+type = "breaking change"
+description = "Default project groups `lint` now only depends on `check` for order instead of strictly"
+author = "[email protected]"
+
+[[entries]]
+id = "4cb0fe80-d359-4302-8893-c0fd62bf0631"
+type = "improvement"
+description = "Raise `EmptyGitRepositoryError` and `NotAGitRepositoryError` respectively in `git_describe()`"
+author = "@NiklasRosenstein"

.kraken.py

@@ -2,96 +2,8 @@
 
 buildscript(requirements=["kraken-build>=0.33.2"])
 
-import os
-
 from kraken.build import project
-from kraken.std import python
-from kraken.std.git import git_describe, gitignore
-
-
-def configure_project() -> None:
-    from kraken.build import project
-
-    python.ruff(additional_args=["--exclude", "tests/iss-263/example_project"])
-    python.mypy(additional_args=["--exclude", "src/tests/integration/.*/data/.*"], version_spec="==1.8.0")
-
-    if project.directory.joinpath("tests").is_dir():
-        # Explicit list of test directories, Pytest skips the build directory if not specified explicitly.
-        if project.directory.name == "kraken-build":
-            python.pytest(ignore_dirs=["src/tests/integration"], include_dirs=["src/kraken/build"])
-        elif project.directory.name == "kraken-wrapper":
-            python.pytest(doctest_modules=False)
-
-    if project.directory.joinpath("tests/integration").is_dir():
-        python.pytest(
-            name="pytestIntegration",
-            tests_dir="src/tests/integration",
-            ignore_dirs=["src/tests/integration/python/data"],
-            group="integrationTest",
-        )
-
-    python.install()
-    python.info()
-
-    (
-        python.python_settings()
-        .add_package_index(
-            "pypi",
-            credentials=(os.environ["PYPI_USER"], os.environ["PYPI_PASSWORD"]) if "PYPI_USER" in os.environ else None,
-        )
-        .add_package_index(
-            "testpypi",
-            credentials=(os.environ["TESTPYPI_USER"], os.environ["TESTPYPI_PASSWORD"])
-            if "TESTPYPI_USER" in os.environ
-            else None,
-            is_package_source=False,
-        )
-    )
-
-    do_publish = True
-    as_version: str | None = None
-    is_release = False
-    if "CI" in os.environ:
-        if os.environ["GITHUB_REF_TYPE"] == "tag":
-            # TODO (@NiklasRosenstein): It would be nice to add a test that checks if the version in the package
-            #       is consistent (ie. run `slap release --validate <tag>`).
-            is_release = True
-            as_version = os.environ["GITHUB_REF_NAME"]
-        elif os.environ["GITHUB_REF_TYPE"] == "branch":
-            if os.environ["GITHUB_REF_NAME"] == "develop":
-                as_version = python.git_version_to_python(git_describe(project.directory), include_sha=False)
-            else:
-                # NOTE (@NiklasRosenstein): PyPI/TestPypi cannot use PEP 440 local versions (which the version with
-                #       included SHA would qualify as), so we don't publish from branches at all.
-                do_publish = False
-        else:
-            raise EnvironmentError(
-                f"GITHUB_REF_TYPE={os.environ['GITHUB_REF_TYPE']}, GITHUB_REF_NAME={os.environ['GITHUB_REF_NAME']}"
-            )
-    else:
-        do_publish = False
-        as_version = python.git_version_to_python(git_describe(project.directory), include_sha=False)
-
-    build_task = python.build(as_version=as_version)
-
-    if do_publish:
-        testpypi = python.publish(
-            name="publishToTestPypi",
-            package_index="testpypi",
-            distributions=build_task.output_files,
-            skip_existing=True,
-        )
-        if is_release:
-            python.publish(
-                name="publishToPypi",
-                package_index="pypi",
-                distributions=build_task.output_files,
-                after=[testpypi],
-            )
-
 
-gitignore()
 project.subproject("docs")
-for subproject in [project.subproject("kraken-build"), project.subproject("kraken-wrapper")]:
-    with subproject.as_current():
-        configure_project()
+project.subproject("kraken-build")
+project.subproject("kraken-wrapper")

docs/docs/api/kraken.build.python.v1alpha1.md

@@ -0,0 +1,5 @@
+---
+title: kraken.build.python.v1alpha1
+---
+
+::: kraken.build.python.v1alpha1

docs/docs/api/kraken.build.utils.v1alpha1.md

@@ -0,0 +1,5 @@
+---
+title: kraken.build.utils.v1alpha1
+---
+
+::: kraken.build.utils.v1alpha1