class List(CommandDescription, OscCommand):
"""List projects, packages and files.
Examples:
osc list api:// # list all projects
osc list api://project # list all packages in project
osc list api://project/package # list all files in package
"""
cmd = 'list'
args = '(api://project?/package?)?'
use_wc = True
opt_verbose = Option('v',
'verbose',
'verbose listing (for files only)',
action='store_true')
opt_expand = Option('e',
'expand',
'expand a source link',
action='store_true')
opt_revision = Option('r',
'revision',
'list revision (for files only)',
default='latest')
opt_deleted = Option('D',
'deleted',
'show deleted projects or packages',
action='store_true')
opt_meta = Option('M',
'meta',
'list package\'s meta files',
action='store_true')
func = call(list.list)
class ReviewList(CommandDescription, Review, ReviewGlobalOptions):
"""List reviews.
By default only requests with state review will be listed.
Examples:
osc review list api://
osc review list api://project
osc review list api://project/package
"""
cmd = 'list'
args = 'api://tgt_project?/tgt_package?'
opt_state = Option('s',
'state',
('list only requests which have a review with state '
'STATE'),
choices=['new', 'accepted', 'revoked', 'declined'],
action='append',
default=['new'])
opt_interactive = Option('i',
'interactive',
'start an interactive request shell',
action='store_true')
func = call(ReviewController.list)
func_defaults = {'shell_cls': ReviewShell}
class RequestList(CommandDescription, Request):
"""List requests.
By default open requests for a specific project or package will be
listed.
Examples:
osc request list api://
osc request list api://project
osc request list api://project/package
"""
cmd = 'list'
args = 'api://project?/package?'
opt_user = Option('U', 'user', 'list only requests for USER')
opt_group = Option('G', 'group', 'list only requests for GROUP')
opt_state = Option('s',
'state',
'list only requests with state STATE',
choices=[
'new', 'review', 'accepted', 'revoked', 'declined',
'superseded'
],
action='append',
default=['new', 'review'])
opt_interactive = Option('i',
'interactive',
'start an interactive request shell',
action='store_true')
func = call(RequestController.list)
func_defaults = {'shell_cls': RequestShell}
class RequestSkip(ShellCommand, RequestShellUI):
"""Skip the current request.
Example:
skip
"""
cmd = 'skip'
func = call(RequestShellUI.controller.skip)
class RequestDiff(ShellCommand, RequestShellUI):
"""Display the diff for the current request.
Example:
diff
"""
cmd = 'diff'
func = call(RequestShellUI.controller.diff)
class RequestCreate(CommandDescription, Request):
"""Create a new request.
Example:
osc request create --submit api://src_project/src_package api://tgt_project
[--message MESSAGE]
osc request create --delete api://project/<package> [--message MESSAGE]
osc request create --role role user api://project/<package>
etc.
It is also possible to specify multiple options at the same time (also
multiple options of the same name are supported).
"""
cmd = 'create'
opt_message = Option('m', 'message', 'specify a message')
opt_submit = Option('',
'submit',
'create new submit action',
oargs=('api://src_project/src_package@rev? '
'api://tgt_project/tgt_package?'),
nargs=2,
action='append',
default=[])
opt_changedevel = Option('',
'changedevel',
'create new changedevel action',
oargs=('api://src_project/src_package '
'api://tgt_project/tgt_package?'),
nargs=2,
action='append',
default=[])
opt_role = Option('',
'role',
'create new role action',
oargs='role user api://project/package?',
nargs=3,
action='append',
default=[])
opt_grouprole = Option('',
'grouprole',
'create new grouprole action',
oargs='role group api://project/package?',
nargs=3,
action='append',
default=[])
opt_delete = Option('',
'delete',
'create new delete action',
oargs='api://project/package?',
nargs=1,
action='append',
default=[])
func = call(RequestController.create)
class RequestSupersede(CommandDescription, Request, ChangeStateOptions):
"""Supersede a request with another (existing) request.
Example:
osc request supersede api://reqid api://supersede_id [--message MESSAGE]
"""
cmd = 'supersede'
args = 'api://reqid api://supersede_id'
func = call(RequestController.change_request_state)
func_defaults = {'method': 'supersede'}
class RequestSupersede(ShellCommand, RequestShellUI, ChangeStateOptions):
"""Supersede a request with another (existing) request.
Example:
supersede [--message MESSAGE]
"""
cmd = 'supersede'
args = 'supersede_id'
opt_message = Option('m', 'message', 'specify a message')
func = call(RequestShellUI.controller.change_request_state)
func_defaults = {'method': 'supersede'}
class RequestRevoke(ShellCommand, RequestShellUI, ChangeStateOptions):
"""Revoke a specific request.
If no message is specified $EDITOR is opened.
Example:
revoke [--message MESSAGE]
"""
cmd = 'revoke'
func = call(RequestShellUI.controller.change_request_state)
func_defaults = {'method': 'revoke'}
class RequestAccept(ShellCommand, RequestShellUI, ChangeStateOptions):
"""Accept a specific request.
If no message is specified $EDITOR is opened.
Example:
accept [--message MESSAGE]
"""
cmd = 'accept'
func = call(RequestShellUI.controller.change_request_state)
func_defaults = {'method': 'accept'}
class ReviewAdd(CommandDescription, Review, ReviewChangeStateOptions):
"""Add a new review to the request.
If no message is specified $EDITOR is opened.
Example:
osc review add api://reqid [--message MESSAGE] --user <user>
"""
cmd = 'add'
args = 'api://reqid'
func = call(ReviewController.add)
class ReviewRevoke(CommandDescription, Review, ReviewChangeStateOptions):
"""Revoke a specific review.
If no message is specified $EDITOR is opened.
Example:
osc review revoke api://reqid [--message MESSAGE] --user <user>
"""
cmd = 'revoke'
args = 'api://reqid'
func = call(ReviewController.change_review_state)
func_defaults = {'method': 'revoke'}
class ReviewRevoke(ShellCommand, ReviewShellUI, ChangeStateOptions):
"""Revoke a specific review.
If no message is specified $EDITOR is opened.
Example:
revoke [--message MESSAGE]
"""
cmd = 'revoke'
func = call(ReviewShellUI.controller.change_review_state)
func_defaults = {'method': 'revoke',
'item_selector_factory': ItemSelectorFactory}
class RequestDecline(CommandDescription, Request, ChangeStateOptions):
"""Decline a specific request.
If no message is specified $EDITOR is opened.
Example:
osc request decline api://reqid [--message MESSAGE]
"""
cmd = 'decline'
args = 'api://reqid'
func = call(RequestController.change_request_state)
func_defaults = {'method': 'decline'}
class Commit(CommandDescription, OscCommand):
"""Update project or package.
Examples:
osc commit # in a project or package wc
osc commit project # update project
osc commit package # update package
osc commit /path/to/wc/or/wc/file # update package
"""
cmd = 'commit'
args = '(wc_path)?'
opt_message = Option('m', 'message', 'specify a message')
func = call(WCCommitController().commit)
class Add(CommandDescription, OscCommand):
"""Adds a package or a file to a working copy.
Examples:
osc2 add /path/prj/pkg # adds pkg to the prj working copy
osc2 add /path/prj/pkg/file # adds file to the pkg working copy
"""
cmd = 'add'
args = '(wc_path)+'
opt_package_only = Option('',
'package-only',
'only add the package, but not its files',
action='store_true')
func = call(add)
class Update(CommandDescription, OscCommand):
"""Update project or package.
Examples:
osc update # in a project or package wc
osc update project # update project
osc update package # update package
"""
cmd = 'update'
args = '(wc_path)?'
opt_expand = Option('u',
'unexpand',
'do not expand a source link',
action='store_true')
opt_revision = Option('r', 'revision', 'list revision', default='latest')
func = call(WCUpdateController().update)
class Status(CommandDescription, OscCommand):
"""Status of package or package file.
Examples:
osc status # in a project or package wc
osc status project # update project
osc status package # update package
osc status /path/to/wc/or/wc/file # update package
"""
cmd = 'status'
args = '(wc_path)?'
opt_verbose = Option('v',
'verbose',
'also print unchanged states',
action='store_true')
func = call(status)
class Checkout(CommandDescription, OscCommand):
"""Checkout project, package, or file.
Examples:
osc2 checkout api://project # checkout project
osc2 checkout api://project/package # checkout package
osc2 checkout /path/to/project # revert all local
modifications in the project
working copy
osc2 checkout /path/to/project/package # revert all local
modifications in the package
working copy
osc2 checkout /path/to/project/package/file # revert the file file
"""
cmd = 'checkout'
args = '(api://project/package?|wc_path)*'
opt_expand = Option('u', 'unexpand', 'do not expand a source link',
action='store_true')
opt_revision = Option('r', 'revision', 'list revision',
default='latest')
func = call(WCCheckoutController().checkout)
class RequestShow(CommandDescription, Request):
"""Show request.
Prints more details than the list view.
Examples:
osc request show api://reqid
osc request show api://reqid --diff
"""
cmd = 'show'
args = 'api://reqid'
func = call(RequestController.show)
opt_diff = Option('d',
'diff',
'generate a diff for the request',
action='store_true')
opt_interactive = Option('i',
'interactive',
'start an interactive request shell',
action='store_true')
mutex_group = [opt_diff, opt_interactive]
func_defaults = {'shell_cls': RequestShell}
