Skip to main content

A set of tools to integrate upstream open source projects into Fedora operating system.

Project description

Pack It! Build Status

This project provides tooling and automation to integrate upstream open source projects into Fedora operating system.

What and why?

  • Our intent is to bring downstream and upstream communities closer: provide feedback from downstream to upstream. (e.g. "Hello <upstream project Y>, your newest release doesn't work in Fedora rawhide, it breaks <Z>, here is a link to logs.")

  • We want to only merge, build and compose components which integrate well with the rest of the operating system. The biggest impact of such behavior will be on Fedora rawhide and when working on a new release.

  • Automatically pull and validate new upstream releases. This can be a trivial thing to do, why should maintainers waste their times on work which can be automated.

  • Developing in dist-git is cumbersome. Editing patch files and moving tarballs around is not fun. Why not working with the source code itself? With source git, you'll have an upstream repository and the dist-git content stuffed in a dedicated directory.

  • Let's use modern development techniques such as pull requests, code review, modern git forges, automation and continuous integration. We have computers to do all the mundane tasks. Why we, as humans, should do such work?

  • We want dist-git to be "a database of content in a release" rather a place to do actual work. On the other hand, you'll still be able to interact with dist-git the same way. We are not taking that away. Source git is meant to be the modern, better alternative.

DevConf.cz "Auto-maintain your package" talk.

Ehm, what's source-git?

Content of source-git repository is equivalent to dist-git, but uses upstream format: source files instead of tarballs, git commits instead of patches.

You can host this repository, or the specific git branch, anywhere you want. If you open a pull request, you will receive feedback on the changes:

  • Does the package build with the changes?
  • Do all the package tests pass?
  • How about tests of the dependant packages?
  • Are the changes good to be included in Fedora?

The goal of packit is to provide automation and tooling to interact with source-git repositories so you don't have to touch dist-git ever again. Our plan is to center development experience around upstream repositories and source-git.

Upstream repositories and source-git repositories are pretty much the same thing. Creating source-git only makes sense when the upstream does not accept downstream spec file or adding spec file to such a project doesn't make sense.

For more info on source-git, please read the detailed design doc.

Plan and current status

Work has begun on the MVP.

  • E2E workflow for getting upstream releases into Fedora
    • Bring new upstream releases into Fedora rawhide as dist-git pull requests. (propose-update command included in in 0.1.0 release)
    • Build the change once it's merged.
    • Send new downstream changes back to upstream. (so the spec files are in sync)
    • Packit can create bodhi updates.
    • Ability to propose updates also to stable releases of Fedora.
    • Build RPMs in COPR and integrate the results into Github.
  • source-git
    • Packit can create a SRPM from a source-git repo.
    • You can release to rawhide from source-git using packit.
    • Packit can create a source-git repository.
    • Packit helps developers with their source-git repositories.
  • Packit as a service
    • Packit reacts to Github webhooks.
    • Have a github app for packit.
    • Deployment.

Workflows covered by packit

Configuration

Configuration file for packit is described in a separate document: docs/configuration.md.

TL;DR

specfile_path: packit.spec
synced_files:
  - packit.spec
upstream_name: packit
package_name: packit
dist_git_url: https://src.fedoraproject.org/rpms/packit.git

Requirements

Packit is written in python 3 and is supported only on 3.6 and later.

When packit interacts with dist-git, it uses fedpkg, we suggest installing it:

sudo dnf install -y fedpkg

Installation

On Fedora:

$ dnf install --enablerepo=updates-testing packit

Or

$ pip3 install --user packitos

(packit project on PyPI is NOT this packit project)

You can also install packit from master branch, if you are brave enough:

$ pip3 install --user git+https://github.com/packit-service/packit.git

Candidates for early adoption

Please, open a PR if you want to be on the list, or just let us know.

  • Identity team (@pvoborni)
  • Plumbers & shells (@msekletar @lnykryn @siteshwar)
  • pykickstart (@dcantrell @larskarlitski)
  • python-operator-courier (Ralph Bean)
  • @thrix
  • youtube-dl (Till Mass)
  • anaconda (@jkonecny12)
  • greenboot (@LorbusChris)
  • rebase-helper (@nforro)
  • ABRT

Resources

Project details


Release history Release notifications | RSS feed

This version

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

packitos-0.1.0.tar.gz (160.6 kB view details)

Uploaded Source

Built Distribution

packitos-0.1.0-py2.py3-none-any.whl (30.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file packitos-0.1.0.tar.gz.

File metadata

  • Download URL: packitos-0.1.0.tar.gz
  • Upload date:
  • Size: 160.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.20.0 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2

File hashes

Hashes for packitos-0.1.0.tar.gz
Algorithm Hash digest
SHA256 1960be572cad63edd46c77d73de6f1efad5286daa275e9879383b6667c7e8f93
MD5 e6cbfc8ae70d6fbd8c53a6ec84327bc9
BLAKE2b-256 9c7c5a1ca6170fdd04033835ef89ae20004951c0775c7c9c7c0acdd9b14ddfa6

See more details on using hashes here.

File details

Details for the file packitos-0.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: packitos-0.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 30.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.20.0 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.2

File hashes

Hashes for packitos-0.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 920d114cc905d82e5f81792a291a2238372425511eea0826217e52eb58f76918
MD5 cd4659413c5d8bc2fb79e92be16bb435
BLAKE2b-256 2ab8ff2f540ce7d30724f160ac57a8a5975a3cb1520273e16ca7d27077685a9f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page