Skip to main content

Scriptworker Readme

https://firefox-ci-tc.services.mozilla.com/api/github/v1/repository/mozilla-releng/scriptworker/main/badge.svg https://coveralls.io/repos/github/mozilla-releng/scriptworker/badge.svg?branch=master Documentation Status

Scriptworker implements the TaskCluster worker model, then launches a pre-defined script.

This worker was designed for Releng processes that need specific, limited, and pre-defined capabilities.

Free software: MPL2 License

Usage

Credentials can live in ./scriptworker.yaml, ./secrets.json, ~/.scriptworker.

  • Launch: scriptworker [config_path]

Testing

Without integration tests install tox, then

NO_CREDENTIALS_TESTS=1 uv run tox -e py311

Without any tests connecting to the net, then NO_TESTS_OVER_WIRE=1 uv run tox -e py311

With integration tests, first create a client in the Taskcluster UI with the scopes:

queue:cancel-task:test-dummy-scheduler/*
queue:claim-work:test-dummy-provisioner/dummy-worker-*
queue:create-task:lowest:test-dummy-provisioner/dummy-worker-*
queue:define-task:test-dummy-provisioner/dummy-worker-*
queue:get-artifact:SampleArtifacts/_/X.txt
queue:scheduler-id:test-dummy-scheduler
queue:schedule-task:test-dummy-scheduler/*
queue:task-group-id:test-dummy-scheduler/*
queue:worker-id:test-dummy-workers/dummy-worker-*

Then generate a no priviledge personal access token in Github for the scriptworker_github_token (to avoid rate limiting) and create a ./secrets.json or ~/.scriptworker that looks like:

{
    "integration_credentials": {
        "clientId": "...",
        "accessToken": "...",
    }
    "scriptworker_github_token": "..."
}

then to run all tests: uv run tox

Metadata

Release files for scriptworker 63.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for scriptworker 63.5.0
File Size Uploaded
scriptworker-63.5.0.tar.gz 103.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for scriptworker 63.5.0
File Interpreter ABI Platform
scriptworker-63.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 186.0 kB

Release files / scriptworker-63.5.0.tar.gz

Download URL scriptworker-63.5.0.tar.gz
Size 103.3 kB
Tags Source
SHA-256 checksum
How to use checksums
dfbb2d1a0d9a87187b56e5ac2c5929f548c95b8112d6f88c0ffac66d024ab1cb
BLAKE2b-256 checksum
How to use checksums
762a811489dd2f205883a2712784cfed4ecd78ee98b1dd273d03af403b20926c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.

Transparency log

Release files / scriptworker-63.5.0-py3-none-any.whl

Download URL scriptworker-63.5.0-py3-none-any.whl
Size 82.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e26f14e679534f950d603f6e677bf7bce7dac73f8e8c6b3bd707c998844eea7c
BLAKE2b-256 checksum
How to use checksums
f92a7dacbbad8605267aad9a65e24ad553ce9b0e992307b0cfbc5e8cda384c0b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

63.5.0 This release

2 release files

63.4.5

2 release files

63.4.2

2 release files

63.4.1

2 release files

63.2.0

2 release files

63.1.0

2 release files

63.0.1

2 release files

62.7.0

2 release files

62.5.0

2 release files

62.4.0

2 release files

62.2.0

2 release files

62.1.0

2 release files

62.0.0

2 release files

61.3.0

2 release files

61.1.0

2 release files

61.0.0

2 release files

60.8.0

2 release files

60.7.1

2 release files

60.7.0

2 release files

60.6.1

2 release files

60.5.0

2 release files

60.4.0

2 release files

60.3.0

2 release files

60.2.0

2 release files

60.1.0

2 release files

60.0.0

2 release files

49.1.1

2 release files

49.0.0

2 release files

48.3.0

2 release files

48.2.0

2 release files

48.1.0

2 release files

48.0.0

2 release files

47.0.2

2 release files

47.0.1

2 release files

47.0.0

2 release files

46.0.1

2 release files

46.0.0

2 release files

45.0.0

2 release files

44.2.0

2 release files

44.1.0

2 release files

44.0.0

2 release files

43.7.0

2 release files

43.5.0

2 release files

43.4.0

2 release files

43.3.0

2 release files

43.2.0

2 release files

43.1.0

2 release files

43.0.0

2 release files

42.2.0

2 release files

42.1.0

2 release files

40.0.0

2 release files

38.2.0

2 release files

38.1.0

2 release files

38.0.0

2 release files

37.0.3

2 release files

37.0.1

2 release files

37.0.0

2 release files

36.0.5

2 release files

36.0.2

2 release files

36.0.1

2 release files

36.0.0

2 release files

35.3.0

2 release files

35.2.0

2 release files

35.1.0

2 release files

34.2.0

2 release files

34.0.0

2 release files

33.0.1

2 release files

33.0.0

2 release files

32.2.1

2 release files

32.2.0

2 release files

32.1.1

2 release files

32.0.3

2 release files

32.0.2

2 release files

32.0.1

2 release files

32.0.0

2 release files

31.1.0

2 release files

31.0.0

2 release files

30.0.0

2 release files

29.1.0

2 release files

29.0.2

2 release files

29.0.1

2 release files

29.0.0

2 release files

27.1.0

2 release files

27.0.0

2 release files

26.0.4

2 release files

26.0.2

2 release files

26.0.1

2 release files

26.0.0

2 release files

25.0.0

2 release files

23.6.2

2 release files

23.6.1

2 release files

23.6.0

2 release files

23.5.0

2 release files

23.4.0

2 release files

23.3.0

2 release files

23.2.1

2 release files

23.2.0

2 release files

23.1.0

2 release files

23.0.9

2 release files

23.0.7

2 release files

23.0.6

2 release files

23.0.5

2 release files

23.0.4

2 release files

23.0.3

1 release file

23.0.2

2 release files

23.0.1

2 release files

23.0.0

2 release files

22.1.0

2 release files

22.0.1

2 release files

20.0.1

2 release files

20.0.0

2 release files

19.0.0

2 release files

18.0.1

2 release files

18.0.0

2 release files

17.2.2

2 release files

17.2.1

2 release files

17.2.0

1 release file

17.1.0

2 release files

17.0.1

2 release files

17.0.0

2 release files

16.2.1

2 release files

16.2.0

2 release files

16.1.0

2 release files

16.0.1

2 release files

16.0.0

2 release files

15.0.4

2 release files

15.0.2

2 release files

15.0.1

2 release files

15.0.0

2 release files

14.0.0

2 release files

12.0.1

2 release files

12.0.0

2 release files

11.1.0

1 release file

11.0.0

2 release files

10.6.1

2 release files

10.6.0

2 release files

10.5.0

2 release files

10.4.0

2 release files

10.3.0

1 release file

10.2.0

1 release file

10.1.0

1 release file

10.0.0

1 release file

9.0.0

1 release file

8.1.1

1 release file

8.1.0

1 release file

8.0.0

1 release file

7.0.0

1 release file

6.0.2

1 release file

6.0.1

1 release file

6.0.0

1 release file

5.2.3

1 release file

5.2.2

1 release file

5.2.1

1 release file

5.2.0

1 release file

5.1.5

1 release file

5.1.4

1 release file

5.1.3

1 release file

5.1.2

1 release file

5.1.1

1 release file

5.1.0

1 release file

5.0.2

1 release file

5.0.1

1 release file

5.0.0

1 release file

4.2.0

1 release file

4.1.4

1 release file

4.1.3

1 release file

4.1.2

1 release file

4.1.1

1 release file

4.1.0

1 release file

4.0.1

1 release file

4.0.0

1 release file

3.1.2

1 release file

3.1.1

1 release file

3.1.0

1 release file

3.0.0

1 release file

2.6.0

1 release file

2.5.0

1 release file

2.4.0

1 release file

2.3.0

1 release file

2.2.0

1 release file

2.1.1

1 release file

2.1.0

1 release file

2.0.0

1 release file

0.9.0

1 release file

0.8.2

1 release file

0.8.1

1 release file

0.8.0

1 release file

0.7.2

1 release file

0.7.1

1 release file

0.7.0

1 release file

0.6.0

1 release file

0.5.0

1 release file

0.4.0

1 release file

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page