.TH REPA "1" "December 2013" "repa 0.2" "User Commands" .SH NAME .PP repa - maintain code submissions to Tizen projects .SH SYNOPSIS .PP .B repa [] [] .SH DESCRIPTION .PP \fIRepa\fR is a generic tool for maintaining code submissions to Tizen projects. It allows to list submissions, group them into submission groups, accept or reject them. Submission is a code in the git tree(s) tagged with sumbit tag. Submission includes code from one or multiple projects(so called group submission). Submission group is a temporary group of submissions, created for testing purposes. .PP \fIRepa\fR commands: .PP .RS 2 1. \fBlist\fR - list submissions and submission groups .RE .RS 2 2. \fBinfo\fR - show detailed info about submission or submission group .RE .RS 2 3. \fBaccept\fR - accept submissions .RE .RS 2 4. \fBreject\fR - reject submissions .RE .RS 2 5. \fBgroup\fR - group submissions into submission group .RE .RS 2 6. \fBrmgroup\fR - remove submission group .RE .RS 2 7. \fBdiff\fR - show the difference between projects .RE .\" =========================================================================== .\" Global options .\" =========================================================================== .SH GLOBAL OPTIONS .RE .B \-\-version .RS 2 Print \fIrepa\fR version and exit. .RE .PP .B \-h, \-\-help .RS 2 Print short help text and exit. .RE .PP .B \-s, \-\-section SECTION .RS 2 Config section to use .RE .PP .B \-p, \-\-project PROJECT .RS 2 Target OBS project. .RE .PP .B \-c, \-\-colorize .RS 2 Turn on colorized output .RE .\" =========================================================================== .\" Commands descriptions .\" =========================================================================== .SH COMMANDS .PP .\" .\" The "list" command description .\" .SS \fBlist\fR [\-\-help] [\-\-processes ] [\-\-showurls] .RS 2 List submissions in the following format: Example of output: submit/tizen/20140327.041126 broken source sdbd .RS 0 submit/tizen/20140327.052722 package build failed emulator-yagl .RS 0 submit/tizen/20140327.055105 package building libav zlib .RS 0 submit/tizen/20140327.080733 image building bluez .RS 0 submit/tizen/20140328.063916 ready connman .RS 0 submit/tizen/20140328.080409 ready sdbd .RS 0 .RE .\" .\" The "list" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 .B \-h, \-\-help .RS 2 Print short help text about the "list" command and exit. .RE .PP .B \-\-processes PROCESSES .RS 2 Use PROCESSES to specify the amount of python processes to run in parallel. Usage of this option can significantly speed up repa list. Note, that this parameter can also be specified in \fIrepa\fR configuration file. .RE .PP .B \-\-showurls .RS 2 Show OBS and download urls in the output. It's switched off by default. Note, that this parameter can also be specified in \fIrepa\fR configuration file. .RE .PP .\" .\" The "info" command description .\" .SS \fBinfo\fR [\-\-help] \-\-project .RS 2 Show detailed information about submission Download Url: url of prerelease directory on download server OBS Url: url of prerelease OBS project Images: list of image names and their build statuses Package build failures: list of failed package builds .PP Example of output: .RS 0 Submission: submit/tizen/20140328.213722 .RS 0 Download Url: http://download.tizen.org/prerelease/tizen/ivi/ivi/tizen_20140328.8/tizen_20140328.8.20140328.213722/ .RS 0 OBS Url: https://build.tizen.org/project/show?project=home:prerelease:Tizen:IVI:submit:tizen:20140328.213722 .RS 0 Images: ivi-min-mbr-i586 success ivi-min-efi-i586 success ivi-mbr-i586-emul success ivi-mbr-i586 success ivi-efi-i586 success ivi-mbr-i586-JJ failed Package build failures: wifi-direct-manager failed .RE .\" .\" The "info" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 \-h, \-\-help .RS 2 Print short help text about the "info" command and exit. .RE .\" .\" The "accept" command description .\" .SS \fBaccept\fR [options] .RS 2 Accept submissions and submission groups. Acceptance is done by creating Submit Requests in OBS for every submission and immediately accepting them. .\" .\" The "accept" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 \-h, \-\-help .RS 2 Print short help text about the "accept" command and exit. .RE .PP \-comment COMMENT .RS 2 Add acceptance comment to created SRs. .RE .\" .\" The "reject" command description .\" .SS \fBreject\fR [options] .RS 2 Reject submissions and submission groups. Rejection is done by creating Submit Requests in OBS for every submission and immediately rejecting them. .\" .\" The "reject" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 \-h, \-\-help .RS 2 Print short help text about the "reject" command and exit. .RE .PP \-comment COMMENT .RS 2 Add rejection comment to created SRs. .RE .\" .\" The "group" command description .\" .SS \fBgroup\fR [options] .RS 2 Group submissions into submit group. Submit group is a temporary by its nature. It's created for testing purposes. Internally submit group is an OBS project with aggregated packages from groupped submissions. It's a way to test, accept or or reject multiple submissions at once. Note! No package builds are performed in group projects. The grouping function aggregates binaries only and is intended only for image testing. .\" .\" The "group" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 \-h, \-\-help .RS 2 Print short help text about the "group" command and exit. .RE .PP \-comment COMMENT .RS 2 Add comment to created submit group. It will be shown by list command. .RE .PP \-f, \-\-force .RS 2 Force group creation for submissions without binary packages. Useful when grouping failed submissions for rejection. .RE .\" .\" The "rmgroup" command description .\" .SS \fBrmgroup\fR [options] .RS 2 Remove submit group. .\" .\" The "rmgroup" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 \-h, \-\-help .RS 2 Print short help text about the "rmgroup" command and exit. .RE .PP .\" .\" The "diff" command description .\" .SS \fBdiff\fR [\-\-help] .RS 2 Show the difference between manifest of target project and manifest of in the following format: .RS 0 Example of output: $ repa -p Tizen:IVI diff Tizen:Common ivi_0140508.2_ia32.xml common_20140507.5_ia32.xml platform/core/appfw/aul-1 3644ad5459 e4f2b22012 submit/tizen/20140502.084937 pending .RS 0 platform/core/appfw/shortcut 502c7807b3 27bbf892e0 submit/tizen/20140430.020549 pending .RS 0 platform/core/connectivity/nfc-manager-neard ea952dc454 88793ab1ff .RS 0 platform/core/connectivity/smartcard-service e45ae0bdfb 7d5da70551 submit/tizen/20140506.101200 pending .RS 0 platform/core/messaging/msg-service c988cc8b55 a9eed6a734 submit/tizen/20140502.105814 pending .RS 0 platform/core/system/tlm 3ddbc6bc14 dc72779317 submit/tizen/20140430.130050 .RS 0 platform/framework/web/crosswalk 42dcc1327b 4280e52757 submit/tizen/20140506.123703 pending .RS 0 Status 'pending' means that submission is pending for the target project. In colorized mode pending submissions are colorized and 'pending' status is not shown. .RE .\" .\" The "diff" command's options .\" .RS 2 \fBOPTIONS\fR .RS 2 .B \-h, \-\-help .RS 2 Print short help text about the "diff" command and exit. .RE .SH CONFIGURATION FILE .RS 2 Configuration file has an INI-file syntax. \fIrepa\fR looks for config files in two locations: global /etc/repa.conf and local ~/.repa.conf. Values from global configuration file are overwritten by values from local configuration file. Command line options have highest priority and overwrite options from configuration files. .RE .RS 2 Example: .RE .RS 2 [general] .RE .RS 2 apiurl = https://api.tizen.org .RE .RS 2 apiuser = your_user_name .RE .RS 2 apipasswd = your_password .RE .RS 2 processes = 20 .RE .RS 2 project = Tizen:IVI .RE .RS 2 color = off .RE .RS 2 showurls = off .RE .RS 2 Mandatory options: apiurl, apiuser, apipasswd and project .RE .RS 2 Some options (project, processes, colorize, showurls) can be overridden by commandline options (--project, --processes, --colorize, --showurls) .RE .SH BUGS Please, report bugs to Ed Bartosh . .SH COPYRIGHT Copyright (C) Intel Corporation 2013 .SH LICENCE This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation. . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. .SH AUTHORS Repa is developed and maintained by Ed Bartosh .