- reorganize source to build a python module
[opensuse:osc.git] / README
1 osc -- opensuse-commander with svn like handling
2
3 >>> BUG: at the moment, 'up' overwrites files with
4          local modifications.
5
6
7 Please send patches to poeml@suse.de, or work directly on
8 https://forgesvn1.novell.com/svn/opensuse/trunk/buildservice/src/clientlib/python/osc/
9
10
11 INSTALLATION:
12 Create a symlink 'osc' in your path pointing to osc.py.
13 The program needs the package pyxml installed.
14
15 For authentication, put your account data into your ~/.netrc file, like this
16 line:
17         machine api.opensuse.org login $login password $pass 
18
19
20
21
22 USAGE EXAMPLES:
23
24 osc ls                          # list projects
25 osc ls Apache                   # list packages in a project 
26 osc ls Apache subversion        # list files of package of a project
27
28 # check out 
29 osc co Apache                   # entire project
30 osc co Apache subversion        # a package
31 osc co Apache subversion foo    # single file
32
33 # update working copy
34 osc up
35 osc up <directory>
36
37 # check in
38 osc ci                          # current dir
39 osc ci <dir>
40 osc ci file1 file2 ...
41
42 # show status
43 osc st
44 osc st <directory>
45
46 # initialize a source directory to be a 
47 # working copy of project <prj> package <pac>
48 osc init <prj> <pac>
49
50 # schedule file foo to be added / deleted
51 osc add foo
52 osc rm foo
53
54 # add all unknown files and remove all missing files
55 osc addremove
56
57 # show diff
58 osc diff [file]
59
60 # show build results (xml)
61 osc results
62 osc results [platform]
63
64 # show logfile (must be run from workingdir)
65 osc log <platform> <arch>
66
67 # show platforms
68 osc platforms
69 # show platforms used by project Apache
70 osc platforms Apache
71
72 # show various xml meta
73 osc meta Apache
74 osc meta Apache subversion
75 osc id username
76