https://github.com/octoprint/devtools

Various development & release tools for OctoPrint, powered by Fabric
https://github.com/octoprint/devtools

fabric mirror octoprint

Last synced: 9 months ago
JSON representation

Various development & release tools for OctoPrint, powered by Fabric

• Host: GitHub
• URL: https://github.com/octoprint/devtools
• Owner: OctoPrint
• License: mit
• Created: 2020-07-24T08:28:01.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2025-04-09T08:19:20.000Z (9 months ago)
• Last Synced: 2025-04-09T09:28:04.309Z (9 months ago)
• Topics: fabric, mirror, octoprint
• Language: Python
• Homepage:
• Size: 3.47 MB
• Stars: 0
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# 👷‍♀️ OctoPrint devtools

Various development & release tools for OctoPrint, powered by [Fabric](https://docs.fabfile.org/en/1.14/).

Provided as-is for documentationational purposes.

## Usage examples

It is recommended to create terminals for each DUT, and set `TARGET` (= DUT identifier) and `TAG` (= future release to be tested) in them correspondingly via `export`, e.g.

    export TAG=1.4.1rc3

    export TARGET=pi3

### Pre-release maintenance RC on test repo (test prep)

    fab sync_test_repo test_rc_maintenance:1.4.1rc3

or (with `TAG` set)

    fab sync_test_repo test_rc_maintenance

### Local test install

    fab test_wheel:python3.7,1.4.1rc3

or (with `TAG` set)

    fab test_wheel:python3.7

### Flash & provision one of the test pis

Target pi3, OctoPi 0.17.0

    fab flashhost_flash_and_provision:0.17.0,pi3

or (with `TARGET` set)

    fab flashhost_flash_and_provision:0.17.0

### Test update for maintenance RC

Target pi3, release channel maintenance, start version 1.4.1rc2, fake release 1.4.1rc3

    fab --set target=pi3 octopi_test_update_maintenance:maintenance,1.4.1rc3,version=1.4.1rc2

or (with `TARGET` and `TAG` set)

    fab octopi_test_update_maintenance:maintenance,version=1.4.1rc2

### Combined

Target pi3, OctoPi 0.17.0, release channel maintenance, start version 1.4.1rc2, fake release 1.4.1rc3 (`TARGET`

and `TAG` set)

    fab flashhost_flash_and_provision:0.17.0 octopi_test_update_maintenance:maintenance,version=1.4.1rc2

### Full example

One DUT (`pi3`), target 1.4.1rc4. Release on release test repo, check local sdist/wheel installation,

then run a release test matrix against OctoPi 0.15.0, 0.15.1, 0.16.0, 0.17.0 and various release channel and

start version combinations.

    export TARGET=pi3

    export TAG=1.4.1rc4

    fab sync_test_repo

    fab test_rc_maintenance

    fab test_sdist:python27

    fab test_wheel:python37

    fab flashhost_flash_and_provision:0.15.0 octopi_test_update_maintenance:stable,version=1.4.0

    fab flashhost_flash_and_provision:0.15.1 octopi_test_simplepip

    fab flashhost_flash_and_provision:0.15.1 octopi_test_update_maintenance:maintenance,version=1.4.1rc3

    fab flashhost_flash_and_provision:0.16.0 octopi_test_update_maintenance:maintenance

    fab flashhost_flash_and_provision:0.17.0 octopi_test_update_maintenance:maintenance

    fab flashhost_flash_and_provision:0.17.0 octopi_test_update_maintenance:maintenance,version=1.4.1rc3

    fab flashhost_flash_and_provision:0.17.0 octopi_test_update_maintenance:devel

## Testrig

Testrig files available in `./testrig`.

## License

MIT