Knowing your system – Part 7 – Contributing to Exherboe

The exherbo contribution mechanism

Basically everything regarding exherbo is discussed and managed via the #exherbo IRC channel on irc.freenode.org.

Before contributing, you should first read the topic of the channel, the zebrapig patchbot documentation, the exheres for smarties tutorial (You do not have to read the whole thing, but always keep it around), and you can also keep the contributing guide around.

Using zebrapig

Zebrapig is exherbo's IRC patchbot. You can use three commands to interact with it:

  • !pq <patch_url> ::<repository> => Use this to submit the patch available at the given URL (use git format-patch --stdout -M -C -C -1 | wgetpaste -r
    to get an URL for your git commit) to the repository you specified.
  • !pd <pattern> => Use this to mark all the patches matching the given pattern as done, useful when you want to
    resubmit an updated version of your patch.
  • pl <pattern> => Don't ever use it in the channel, only use it in a private query with zebrapig. It will list all
    patches matching this pattern (which is optional).

A special use-case is to submit your personal repository, you'll submit it as a patch, given its git URL and specifying ::unavailable-unofficial as the repository.

Everything submitted to the bot will be reviewed by developers who'll tell you what's wrong in your patch and how you could improve it. You're expected to be quite present in the channel if you start submitting stuff. Once your patch is ready, it will be pushed to the repository and available to everyone.

What I love about this mechanism is that it's really simple, handy and powerful.

My personal work flow for contributing

When I want to contribute to a repository, for a version bump or any bug fix, I proceed in 7 steps:

  • If I do not have a copy of the repository locally I clone it, otherwise I pull new changes from upstream

  • I write my patch and commit it

  • I upload my patch with git pe HEAD~<number_of_commits> | wgetpaste -r -s poundpython (I'll explain this command later)

  • I put a copy of my patch in my autopatch directory (which I'll explain after):

    mkdir -p /etc/paludis/autopatch/<repository>
    curl <patch_url> > /etc/paludis.autopatch/<repository>/my.patch
    
  • I sync the repository so that the autopatch gets applied: cave sync <repository>

  • I try my patch, compiling the related packages

  • If everything succeeds, I submit my patch, otherwise, I get back to step 2 to fix my patch

The command which I run to upload my patch is a git alias, git pe means git format-patch -M -C --find-copies-harder --stdout and takes as an argument the commits to publish, HEAD~3 means 3 commits for example, I put -s poundpython as extra args for wgetpaste since gist.github.com which is the default fails quite often for me.

The other interesting part of it is how I manage the autopatch system. I have a paludis hook placed in /etc/paludis/hooks/sync_post which cause every patch located in /etc/paludis/autopatch/<repository>/ to be applied each time I sync the said repository.

Next time I'll explain how I contribute to upstream projects using nearly the same scheme, pointing out even more how intuitive and integrated this process is in my every day work.

Blog

À lire également

Clever Cloud at VivaTech 2025: demonstration of Clever AI, new partnerships and support for startups

At VivaTech 2025, Clever Cloud is highlighting a number of strategic announcements and innovations in line with its vision of a sovereign, open and resilient cloud. The team will be present in various pavilions, unveiling Clever AI for the first time, presenting a partnership with Grist, an open source data platform, signing a partnership for development in North Africa and stepping up its support for the startup ecosystem.
Company

Grist Labs and Clever Cloud Announce Strategic Partnership to Deliver Sovereign, Scalable Data Solutions in Europe

Grist Labs, creators of the modern, open-source data tool, and Clever Cloud, a leading European Platform-as-a-Service (PaaS) cloud service provider, today announced a strategic partnership to deliver secure, sovereign hosting and streamlined distribution of Grist services across Europe.
Company Press

What is native cloud?

The world of software development is changing at breakneck speed. In an economic environment where digital technology plays an increasingly central role, companies are looking to create applications that are ever more responsive, scalable and resilient.
Company