ABF Console Client

From Rosalab Wiki
Revision as of 13:50, 19 September 2012 by Anton.kirilenko (Talk | contribs)

Jump to: navigation, search

Intro

Our team (or just me) is about to start the development of the long-awaited project, console client for ABF!

Firstly we have to make up the list of features. All the demands and proposals are welcome in this mailing list (rosa-devel) or here.

Naming

The name of the tool is not defined yet. You can write you ideas here.

Possible variants:

  1. abf
  2. abfcc
  3. ... (add here)

Feature List

Here is the list of the proposed features.

<DONE> abf get PROJECT [-g GROUP] [-b BRANCH]

clone git repository, project group is set to GROUP or default

with -b BRANCH - checkout

<DONE> abf build [PROJECT] [-t PLATFORM] [-b BRANCH] [-p] [-a ARCHES]

Without parameters - build current project for default distribution from proper git branch; For example, build from latest_rosa2012.1 branch to rosa2012.1/main)

With PROJECT - select the project to operate on.

With BRANCH- build the project from that branch.

With PLATFORM - build the project to that platform.

If something is not specified - resolve it automatically. For example,

abf build mock-urpm -t rosa2012lts

will build mock-urpm from branch latest_rosa2012lts.

With -p - automatic publishing.

-a ARCHES - coma-separated list of arches to build. "i586,x86_64" by default

abf rebuild [PROJECT]

Execute the last executet abf build ... command for the project specified or to the current project if possible.

<DONE> abf buildstatus [ID]

Get the status of the build task with ID. If ID not set and you are inside the repository directory - get the id of the last project build.

abf localbuild

Build the project from cwd using mock. A set of parameters will be available later.

abf sync

Check and cleanup package sources and patches using current spec as base.

(delete all sources and patches from working directory if they are not listed in spec; inform if any listed patches/sources are missing; create proper file used to store tarballs on file server)

abf backport SRC_BRANCH [DST_BRANCH]

Copy all the files from SRC_BRANCH to DST_BRANCH, or to the current brunch if not specified.

<DONE> abf put -m "commit message"

Commit changes (git commit -am "message") and push (git push origin branch)

abf uploadsrpm SRPM_PATH [GROUP] [-h] [-n NAME] [-d DESCRIPTION]

Create a new project in group GROUP or in your default group and upload the files from srpm file.

-h - makes project hidden.

-n NAME - set the project name. If not specified - get from srpm

-d DESCRIPTION - project description.


abf attach GROUP/PRJ PLAT_TARGET/REPO_TARGET [PLAT_ORIG/REPO_ORIG]

abf detach GROUP/PRJ PLAT_TARGET/REPO_TARGET

Attach the project to the repository, or detach it from repository.

Attaching with PLAT_ORIG/REPO_ORIG will detach project from one repo and attach to another.


For example, two commands:

abf attach import/mc rosa2012lts/contrib abf attach import/mc rosa2012lts/main

equals:

abf move import/mc rosa2012lts/contrib rosa2012lts/main

Workflow

   When you start abf for the first time, it will ask you for your username, 
   password and some other things (if needed), and store it in ~/.abf . Later 
   the password will be stored using python-keyring or python-keyring-kde.
   There will be configuration files for every  in ~/.abf: