portover
Migrate one config dialect to another, one directive at a time.
You're mid-migration at 2am, searching "jenkins post always github actions equivalent". portover is the tool — and the doc site — built for exactly that moment.
$ portover detect .
pip-to-uv: requirements.txt
jenkins-to-gha: Jenkinsfile
$ portover run jenkins-to-gha .
== jenkins-to-gha: Jenkinsfile (declarative pipeline) -> .github/workflows/*.yml
+ agent 1x
+ stages 4x
+ parallel 1x
! triggers 1x
Manual steps:
! [environment] API_TOKEN = credentials('api-token')
create repo secret API_TOKEN with the value of Jenkins credential 'api-token'
...
--- .github/workflows/ci.yml (dry run; pass --write to save) ---
Dry run by default. --write saves the output. Nothing is ever silently dropped:
every source directive is either mapped, flagged as a manual step with
instructions, or listed as unmapped so you know exactly what's left.
Migrations
| id | from | to |
|---|---|---|
pip-to-uv |
requirements.txt (pip) | pyproject.toml (uv) |
jenkins-to-gha |
Jenkinsfile (declarative) | .github/workflows/*.yml |
travis-to-gha |
.travis.yml (Travis CI) | .github/workflows/*.yml |
gitlab-ci-to-gha |
.gitlab-ci.yml (GitLab CI) | .github/workflows/*.yml |
circleci-to-gha |
.circleci/config.yml (CircleCI) | .github/workflows/*.yml |
azure-pipelines-to-gha |
azure-pipelines.yml (Azure Pipelines) | .github/workflows/*.yml |
bitbucket-to-gha |
bitbucket-pipelines.yml (Bitbucket) | .github/workflows/*.yml |
buildkite-to-gha |
Buildkite pipeline.yml | .github/workflows/*.yml |
drone-to-gha |
.drone.yml (Drone CI) | .github/workflows/*.yml |
flake8-to-ruff |
.flake8 / setup.cfg | ruff.toml |
Browse docs/ — one page per directive, generated from the mappings themselves, so the docs can never drift from the code.
Install
pip install portover # or: uv tool install portover
Zero dependencies, stdlib only, Python ≥ 3.11.
The design in one paragraph
A migration is a folder. A mapping is one small file in it that handles
exactly one source directive — -e, post { failure }, max-line-length —
with a matches(), an apply(), and a META block holding a real
before/after example. Mappings register themselves by existing (the folder is
scanned), the docs are generated from META, and the report the CLI prints is
the same data. Fix the mapping and the converter, the docs page, and the
report all update together.
Contributing
The contributor unit is one mapping for one directive — a ~40-line file
plus a test. If portover printed ? unmapped for something in your migration,
that's the file you get to write. See CONTRIBUTING.md.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file portover-0.8.0.tar.gz.
File metadata
- Download URL: portover-0.8.0.tar.gz
- Upload date:
- Size: 205.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
42ab3d14ef1dff22ff3579a59a9ffc036cd73360d9e0e8097bb1fafa226b47de
|
|
| MD5 |
de5eb958b9d117d0ecaec392c89634cc
|
|
| BLAKE2b-256 |
dcff34ee3746a3fc364c9d57a1841a0f7645c6c5afa0887e38f980db4f1fa800
|
Provenance
The following attestation bundles were made for portover-0.8.0.tar.gz:
Publisher:
release.yml on sophie-nguyenthuthuy/portover
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
portover-0.8.0.tar.gz -
Subject digest:
42ab3d14ef1dff22ff3579a59a9ffc036cd73360d9e0e8097bb1fafa226b47de - Sigstore transparency entry: 2391685527
- Sigstore integration time:
-
Permalink:
sophie-nguyenthuthuy/portover@70912c0efe5506f184c2b2cf1c8e8e37daf6c4f8 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/sophie-nguyenthuthuy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@70912c0efe5506f184c2b2cf1c8e8e37daf6c4f8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file portover-0.8.0-py3-none-any.whl.
File metadata
- Download URL: portover-0.8.0-py3-none-any.whl
- Upload date:
- Size: 239.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c409f580bcb0b04952e6f336be068ecf1d96efc2edb8b3295d23226606c017e1
|
|
| MD5 |
94fae19df1bfa02e6864898dbab98b49
|
|
| BLAKE2b-256 |
ddcaa106a486e98e2453c3d709cf1a037de7c469c41edd4db346d82b0c2d99b2
|
Provenance
The following attestation bundles were made for portover-0.8.0-py3-none-any.whl:
Publisher:
release.yml on sophie-nguyenthuthuy/portover
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
portover-0.8.0-py3-none-any.whl -
Subject digest:
c409f580bcb0b04952e6f336be068ecf1d96efc2edb8b3295d23226606c017e1 - Sigstore transparency entry: 2391686412
- Sigstore integration time:
-
Permalink:
sophie-nguyenthuthuy/portover@70912c0efe5506f184c2b2cf1c8e8e37daf6c4f8 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/sophie-nguyenthuthuy
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@70912c0efe5506f184c2b2cf1c8e8e37daf6c4f8 -
Trigger Event:
push
-
Statement type:
