Skip to content
The Command Line Interface to work with an Open Build Service
Python Shell Perl
Latest commit b6f7d1b Jun 30, 2016 @adrianschroeter adrianschroeter explicit "osc add" of a directory offers to create an archive for upl…
…oading it

Question: what can be a trigger to update it?
          checking for mtimes in directories where an .obscpio exists?
Failed to load latest commit information.
dist Allow osc to be called as isc and iosc Jun 24, 2015
docs sphinx documentation, initial commit Feb 15, 2016
fuse allow loading module from working copy if osc is not installed Oct 20, 2009
osc explicit "osc add" of a directory offers to create an archive for upl… Jun 30, 2016
tests tests.common: can also be a file-like object May 29, 2016
.gitignore Ignore *junit-xml-results Nov 18, 2013
.travis.yml Add Travis CI build for Python 3.3, 3.4, 3.5-dev Aug 16, 2015
AUTHORS It's all for the fame, isn't it? Aug 18, 2011
COPYING - add license (bnc#699224) Apr 4, 2012
NEWS explicit "osc add" of a directory offers to create an archive for upl… Jun 30, 2016
PROJ_PACK.txt fix whitespace Feb 28, 2010
README README: replaced mentioning of svn version with git version May 24, 2015
TODO fix links that point into the wiki Jul 27, 2010 changed commit 22b272f a bit May 16, 2015 fish shell completion: help arguments Sep 5, 2014
osc.ico optional support for py2exe May 14, 2009
osc.png - added 'osc bugowner' as a more intelligent version of 'osc maintai… Oct 22, 2009 added a simple way to verify osc code base with the python security s… Apr 8, 2015 sphinx documentation, initial commit Feb 15, 2016


osc -- opensuse-commander with svn like handling

Patches can be submitted via
 * mail to
 * Bugzilla:
 * or the official Git repository on Github:


RPM packages are here (rpm-md repository):

To install from git, do

        python build
        python install
        # create a symlink 'osc' in your path pointing to
        ln -s /usr/bin/osc

Alternatively, you can directly use from the source dir
(which is easier if you develop on osc).

The program needs the cElementTree python module installed. On SUSE, the
respective package is called python-elementtree (before 10.2: python-xml).
For local building, you will need python-urlgrabber in addition. Those are
standard package on SUSE Linux since a while. If your version is too old, you
can find python-elementtree and python-urlgrabber here:


When you use it for the first time, it will ask you for your username and
password, and store it in ~/.oscrc.

CONFIGURATION MIGRATION (only affects versions >= 0.114):

Version 0.114 got some cleanups for the configfile handling and therefore some
options are now deprecated, namely:
* apisrv
* scheme

One new option was added:
* apiurl = <protocol>://<somehost> # use this as the default apiurl. If this
option isn't specified the default ( is used.

So far osc still has some backward compatibility for these options but it might
get removed in the future that's why it issues a deprecation warning in case
one of those options is still in use.

The new configuration scheme looks like the following:
 # entry for an apiurl
 user = <username>
 password = <password>

'''Before starting the migration please save your ~/.oscrc file!'''

If the migration doesn't work for whatever reason feel free to send me an email
or ask on the opensuse-buildservice mailinglist or in the #opensuse-buildservice
irc channel.

=== Migration case I (apisrv only) ===
The apisrv option is used to specify the default apihost. If apisrv isn't
specified at all the default ("") is used.
The current [general] section looks like this:
 apisrv = <somehost>
 # or
 apisrv = <protocol>://<somehost>

apisrv got superseded by the new apiurl option which looks like this:
 apiurl = <protocol>://<somehost>

If apisrv has no "<protocol>" https is used. Make sure all apiurl sections have
the new format which is described above. Afterwards apisrv can be removed.

=== Migration case II (scheme only) ===
The current [general] section looks like this:
 scheme = <protocol>

This means every apiurl section which don't have the new format which is
described above for instance
 user = <username>
 password = <password>

has to be converted to
 user = <username>
 password = <password>

Afterwards the scheme option can be removed from the [general] section (it
might be the case that some sections already have the correct format).

=== Migration case III (apisrv and scheme) ===
The current [general] section looks like this:
 apisrv = <somehost>
 scheme = <protocol>

Both options can be removed if all apiurl sections have the new format which is
described above. So basically just adjust all apiurl sections (it might be the
case that some sections already have the correct format).


Osc now can store passwords in keyrings instead of ~/.oscrc. To use it,
you need python-keyring and either python-keyring-kde or -gnome.

If you want to switch to using a keyring you need to delete apiurl section
from ~/.oscrc and you will be asked for credentials again, which will be then
stored in the keyring application.

WORKING COPY INCONSISTENT (only affects version >= 0.130)

osc's working copy handling was rewritten in 0.130. Thus some
consistency checks were added. As a result osc might complain
that some old working copies are in an inconsistent state:
 Your working copy '.' is in an inconsistent state.
 Please run 'osc repairwc .' (Note this might _remove_
 files from the .osc/ dir). Please check the state
 of the working copy afterwards (via 'osc status .')
To fix this simply run "osc repairwc ." as suggested in the
error message. Note that "osc repairwc ." might need to contact
the api in order to fetch some missing files. Also it might remove
some files from the storedir (.osc/) but it won't touch any locally
modified files.
If it DOES NOT fix the problem please create a bug report and attach
your working copy to the bug (if possible).

(online at )

To list existing content on the server
 osc ls                                # list projects
 osc ls Apache                         # list packages in a project
 osc ls Apache subversion              # list files of package of a project

Check out content
 osc co Apache                         # entire project
 osc co Apache subversion              # a package
 osc co Apache subversion foo          # single file

Update a working copy
 osc up
 osc up [pac_dir]                      # update a single package by its path
 osc up *                              # from within a project dir, update all packages
 osc up                                # from within a project dir, update all packages
                                       #   AND check out all newly added packages

If an update can't be merged automatically, a file is in 'C' (conflict)
state, and conflicts are marked with special <<<<<<< and >>>>>>> lines.
After manually resolving the problem, use
 osc resolved foo

Upload change content
 osc ci                                # current dir
 osc ci <dir>
 osc ci file1 file2 ...

Show the status (which files have been changed locally)
 osc st
 osc st <directory>
 osc st file1 file2 ...

Mark files to be added or removed on the next 'checkin'
 osc add file1 file2 ...
 osc rm file1 file2 ...

Adds all new files in local copy and removes all disappeared files.
 osc addremove

Generates a diff, to view the changes
 osc diff                              # current dir
 osc diff file1 file2 ...

Shows the build results of the package
 osc results
 osc results [repository]

Shows the log file of a package (you need to be inside a package directory)
 osc log <repository> <arch>

Shows the URLs of .repo files which are packages sources for Yum/YaST/smart
 osc repourls [dir]

Triggers a package rebuild for all repositories/architectures of a package
 osc rebuildpac [dir]

Shows available repository/build targets
 osc repository

Shows the configured repository/build targets of a project
 osc repository <project>

Shows meta information
 osc meta Apache
 osc meta Apache subversion
 osc id username

Edit meta information
(Creates new package/project if it doesn't exist)
 osc editmeta Apache
 osc editmeta Apache subversion

Update package meta data with metadata taken from spec file
 osc updatepacmetafromspec <dir>

There are other commands, which you may not need (they may be useful in scripts):
 osc repos
 osc buildconfig
 osc buildinfo

Locally build a package (see 'osc help build' for more info):
 osc build <repo> <arch> specfile [--clean|--noinit]

Update a package to a different sources (directory foo_package_source):
 cp -a foo_package_source foo; cd foo; osc init <prj> <pac>; osc addremove; osc ci; cd $OLDPWD; rm -r foo


Putting the following in the file ~/.w3m/passwd will make
w3m know the credentials for the buildservice servers:

  port 80
  realm Authentication required
  login foo
  password bar

  port 80
  realm openSUSE Build Service
  login foo
  password bar

chmod 0600 ~/.w3m/passwd

NOTES about the testsuite

A new test suite has been created and should run via doing
# cd tests
# python

Something went wrong with that request. Please try again.