Dagger
Search

python-sdk-dev

The Python SDK's development module.

Installation

dagger install github.com/zongruxie4/dagger/sdk/python/dev@23ba14eb605a5cef9cbe5a9bca1730f4af7f4ce0

Entrypoint

Return Type
PythonSdkDev !
Arguments
NameTypeDefault ValueDescription
sourceDirectory -Directory with sources
containerContainer nullBase container
Example
Function PythonSdkDev.Constructor is not accessible from the python-sdk-dev module
Function PythonSdkDev.Constructor is not accessible from the python-sdk-dev module
Function PythonSdkDev.Constructor is not accessible from the python-sdk-dev module
Function PythonSdkDev.Constructor is not accessible from the python-sdk-dev module

Types

PythonSdkDevDocs 🔗

Manage the reference documentation (Sphinx).

build() 🔗

Build the documentation.

Return Type
Directory !
Example
Function PythonSdkDevDocs.build is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.build is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.build is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.build is not accessible from the python-sdk-dev module

preview() 🔗

Build and preview the documentation in the browser.

Return Type
Service !
Arguments
NameTypeDefault ValueDescription
bindInteger !8000

The port to bind the web preview for the built docs

Example
Function PythonSdkDevDocs.preview is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.preview is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.preview is not accessible from the python-sdk-dev module
Function PythonSdkDevDocs.preview is not accessible from the python-sdk-dev module

PythonSdkDevTestSuite 🔗

Run the test suite.

default() 🔗

Run python tests.

Return Type
Container !
Example
Function PythonSdkDevTestSuite.default is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.default is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.default is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.default is not accessible from the python-sdk-dev module

provision() 🔗

Test provisioning.

This publishes a cli binary in an ephemeral http server and checks if the SDK can download, extract and run it.

Return Type
Container !
Arguments
NameTypeDefault ValueDescription
cliBinFile !-

Dagger binary to use for test

runnerHostString null

_EXPERIMENTAL_DAGGER_RUNNER_HOST value

Example
Function PythonSdkDevTestSuite.provision is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.provision is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.provision is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.provision is not accessible from the python-sdk-dev module

run() 🔗

Run the pytest command.

Return Type
Container !
Arguments
NameTypeDefault ValueDescription
args[String ! ] !-

Arguments to pass to pytest

Example
Function PythonSdkDevTestSuite.run is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.run is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.run is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.run is not accessible from the python-sdk-dev module

unit() 🔗

Run unit tests.

Return Type
Container !
Example
Function PythonSdkDevTestSuite.unit is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.unit is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.unit is not accessible from the python-sdk-dev module
Function PythonSdkDevTestSuite.unit is not accessible from the python-sdk-dev module

PythonSdkDev 🔗

The Python SDK’s development module.

container() 🔗

Container to run commands in

Return Type
Container !
Example
Function PythonSdkDev.container is not accessible from the python-sdk-dev module
Function PythonSdkDev.container is not accessible from the python-sdk-dev module
Function PythonSdkDev.container is not accessible from the python-sdk-dev module
Function PythonSdkDev.container is not accessible from the python-sdk-dev module

build() 🔗

Build the Python SDK client library package for distribution.

Return Type
Container !
Arguments
NameTypeDefault ValueDescription
versionString !"0.0.0"

The version for the distribution package

Example
Function PythonSdkDev.build is not accessible from the python-sdk-dev module
Function PythonSdkDev.build is not accessible from the python-sdk-dev module
Function PythonSdkDev.build is not accessible from the python-sdk-dev module
Function PythonSdkDev.build is not accessible from the python-sdk-dev module

docs() 🔗

Preview the reference documentation.

Return Type
PythonSdkDevDocs !
Example
Function PythonSdkDev.docs is not accessible from the python-sdk-dev module
Function PythonSdkDev.docs is not accessible from the python-sdk-dev module
Function PythonSdkDev.docs is not accessible from the python-sdk-dev module
Function PythonSdkDev.docs is not accessible from the python-sdk-dev module

format() 🔗

Format source files.

Return Type
Directory !
Arguments
NameTypeDefault ValueDescription
paths[String ! ] ![]

List of files or directories to check

Example
Function PythonSdkDev.format is not accessible from the python-sdk-dev module
Function PythonSdkDev.format is not accessible from the python-sdk-dev module
Function PythonSdkDev.format is not accessible from the python-sdk-dev module
Function PythonSdkDev.format is not accessible from the python-sdk-dev module

generate() 🔗

Generate the client bindings for the core API.

Return Type
Changeset !
Arguments
NameTypeDefault ValueDescription
introspectionJsonFile !-

Result of the introspection query

Example
Function PythonSdkDev.generate is not accessible from the python-sdk-dev module
Function PythonSdkDev.generate is not accessible from the python-sdk-dev module
Function PythonSdkDev.generate is not accessible from the python-sdk-dev module
Function PythonSdkDev.generate is not accessible from the python-sdk-dev module

lint() 🔗

Check for linting errors.

Return Type
String !
Arguments
NameTypeDefault ValueDescription
paths[String ! ] null

List of files or directories to check

Example
Function PythonSdkDev.lint is not accessible from the python-sdk-dev module
Function PythonSdkDev.lint is not accessible from the python-sdk-dev module
Function PythonSdkDev.lint is not accessible from the python-sdk-dev module
Function PythonSdkDev.lint is not accessible from the python-sdk-dev module

publish() 🔗

Publish Python SDK client library to PyPI.

Return Type
Container !
Arguments
NameTypeDefault ValueDescription
tokenSecret !-

The token for the upload

versionString !"0.0.0"

The version for the distribution package to publish

urlString !""

The URL of the upload endpoint (empty means PyPI)

Example
Function PythonSdkDev.publish is not accessible from the python-sdk-dev module
Function PythonSdkDev.publish is not accessible from the python-sdk-dev module
Function PythonSdkDev.publish is not accessible from the python-sdk-dev module
Function PythonSdkDev.publish is not accessible from the python-sdk-dev module

supportedVersions() 🔗

Supported Python versions.

Return Type
[String ! ] !
Example
Function PythonSdkDev.supportedVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.supportedVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.supportedVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.supportedVersions is not accessible from the python-sdk-dev module

test() 🔗

Run the test suite.

Return Type
PythonSdkDevTestSuite !
Arguments
NameTypeDefault ValueDescription
versionString null

Python version to test against

disableNestedExecBoolean !false

Disable nested execution for the test runs

Example
Function PythonSdkDev.test is not accessible from the python-sdk-dev module
Function PythonSdkDev.test is not accessible from the python-sdk-dev module
Function PythonSdkDev.test is not accessible from the python-sdk-dev module
Function PythonSdkDev.test is not accessible from the python-sdk-dev module

testPublish() 🔗

Test the publishing of the Python SDK client library to TestPyPI.

Return Type
Container !
Arguments
NameTypeDefault ValueDescription
tokenSecret !-

TestPyPI token

versionString !"0.0.0"

The version for the distribution package to publish

Example
Function PythonSdkDev.testPublish is not accessible from the python-sdk-dev module
Function PythonSdkDev.testPublish is not accessible from the python-sdk-dev module
Function PythonSdkDev.testPublish is not accessible from the python-sdk-dev module
Function PythonSdkDev.testPublish is not accessible from the python-sdk-dev module

testVersions() 🔗

Run the test suite for all supported versions.

Return Type
[PythonSdkDevTestSuite ! ] !
Example
Function PythonSdkDev.testVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.testVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.testVersions is not accessible from the python-sdk-dev module
Function PythonSdkDev.testVersions is not accessible from the python-sdk-dev module

typecheck() 🔗

Run the type checker (mypy).

Return Type
String !
Example
Function PythonSdkDev.typecheck is not accessible from the python-sdk-dev module
Function PythonSdkDev.typecheck is not accessible from the python-sdk-dev module
Function PythonSdkDev.typecheck is not accessible from the python-sdk-dev module
Function PythonSdkDev.typecheck is not accessible from the python-sdk-dev module

withContainer() 🔗

Replace container.

Return Type
PythonSdkDev !
Arguments
NameTypeDefault ValueDescription
ctrContainer !-

An OCI-compatible container, also known as a Docker container.

Example
Function PythonSdkDev.withContainer is not accessible from the python-sdk-dev module
Function PythonSdkDev.withContainer is not accessible from the python-sdk-dev module
Function PythonSdkDev.withContainer is not accessible from the python-sdk-dev module
Function PythonSdkDev.withContainer is not accessible from the python-sdk-dev module

withDirectory() 🔗

Mount a directory on the base container.

Return Type
PythonSdkDev !
Arguments
NameTypeDefault ValueDescription
sourceDirectory !-

The directory to add

Example
Function PythonSdkDev.withDirectory is not accessible from the python-sdk-dev module
Function PythonSdkDev.withDirectory is not accessible from the python-sdk-dev module
Function PythonSdkDev.withDirectory is not accessible from the python-sdk-dev module
Function PythonSdkDev.withDirectory is not accessible from the python-sdk-dev module