GNOME/OSC plugins

From openSUSE

Introduction

OSC (the Build_Service client) provides a very easy way to add plugins (see Build_Service/osc_plugins), so we are taking advantage for this to write several plugins to help us with our day-to-day work. Other sources of information for writing OSC plugins are:

• Plugin that demonstrates raw HTTP requests via the BS API

Downloading

The plugins we are writing are contained in a package called osc-plugins-gnome, which can be downloaded from the openSUSE:Tools project of the build service.

What the plugins do

So far, these are the plugins we have available:

• createspec: Creates a basic RPM .spec file to be used when packaging new software
• gnome: Coordinate and facilitate mass version updates, for both packages and repository maintainers
• linkdereference: Similar to what osc checkout -u does (it was written before osc checkout acquired -u, and is probably obsolete now)
• linksame: When two packages are identical, convert one to a link to the other
• listpatches: List a package's patches
• mawbuild: A convenient wrapper around osc build (still needs some work, although I (maw) use it daily to good effect)
• mergefrom: A broken plugin that you probably shouldn't ever use
• mybranches: Lists your current branch repositories and, optionally, the packages contained therein
• nukebranch: Deletes a branched package
• pacversion: Prints a package's version
• patchlint: Checks packages for their conformance to our patch guidelines
• pendingreqs: Lists potential submit requests between repositories (and needs a lot of work)
• speclint: Checks an RPM .spec file
• submitreqaccept: A wrapper around osc submitreq accept <id>
• submitreqdiff: A wrapper around osc submitreq show -d <id>
• submitreqlist: Lists pending submit requests for a repository

To get more information on these commands, after installing them, run:

osc $command --help

Hacking on the plugins

We keep our source in Git.

• Rodrigo's GIT branch: http://www.gnome.org/~rodrigo/git/osc-plugins.git
• Michael's GIT branch: git://gitorious.org/osc-plugins/mainline.git
• Vincent's GIT branch: http://www.vuntz.net/git/osc-plugins.git

When hacking on the plugins, the easiest way to test them is to create symlinks from $HOME/.osc-plugins to the plugins in your working directory. That way you don't need to go through the hassle of installing them.

Invitation to contribute

When working on packages, do you ever find yourself doing something repetititive or tedious and saying to yourself, "Self, this is ridiculous! The computer should be doing this for me!"?

Here's a good chance to do something about it. So far, only members of the GNOME team are working on the plugins, but there is little that's GNOME-specific about them, and we welcome contributions from people of all stripes. Feel free to jump in!