github.com/kekek/gb@v0.4.5-0.20170222120241-d4ba64b0b297/README.md (about)

     1  # gb
     2  
     3  ### Build status
     4  Unix:
     5  [![travis-cs status](https://travis-ci.org/constabulary/gb.svg "travis-ci status")](https://travis-ci.org/constabulary/gb)
     6  
     7  Windows:
     8  [![Build status](https://ci.appveyor.com/api/projects/status/rjttg1agmp2sra3h/branch/master?svg=true)](https://ci.appveyor.com/project/davecheney/gb/branch/master)
     9  
    10  [![codecov.io](https://codecov.io/github/constabulary/gb/branch/master/graph/badge.svg)](https://codecov.io/github/constabulary/gb)
    11  
    12  `gb` is a proof of concept replacement build tool for the [Go programming language](https://golang.org).
    13  
    14  I gave a talk about `gb` and the rational for its creation at GDG Berlin in April 2015, [video](https://www.youtube.com/watch?v=c3dW80eO88I) and [slides](http://go-talks.appspot.com/github.com/davecheney/presentations/reproducible-builds.slide#1).
    15  
    16  ## Project based
    17  
    18  `gb` operates on the concept of a project. A gb project is a workspace for all the Go code that is required to build your project.
    19  
    20  A gb project is a folder on disk that contains a subdirectory named <code>src/</code>. That's it, no environment variables to set. For the rest of this document we'll refer to your <code>gb</code> project as <code>$PROJECT</code>.
    21  
    22  You can create as many projects as you like and move between them simply by changing directories.
    23  
    24  ## Installation
    25  
    26      go get github.com/constabulary/gb/...
    27  
    28  ## Read more
    29  
    30  gb has its own site, [getgb.io](http://getgb.io/), head over there for more information.
    31  
    32  ## Contributing
    33  
    34  ### Contribution guidelines
    35  
    36  We welcome pull requests, bug fixes and issue reports.
    37  
    38  Before proposing a large change, please discuss your change by raising an issue.
    39  
    40  ### Road map
    41  
    42  #### Completed
    43  
    44  - [Cross Compilation](https://github.com/constabulary/gb/milestones/cross-compilation)
    45  - Tag handling, unify -tags, ENVVARS and GOOS/GOARCH into a single format for binary names and pkg cache
    46  - gb test improvements, test output, test flag handling
    47  - [Race detector support](https://github.com/constabulary/gb/issues/96)
    48  
    49  #### Todo
    50  
    51  - 0.4 series: gb vendor updates and bug fixes
    52  - 0.5 series: new package resolver (replace go/build)
    53  
    54  ### Big ticket items 
    55  
    56  Big ticket items that are not on the road map yet
    57  
    58  - Package BuildID support (make stale detection work like the Go 1.5)
    59  - `gccgo` toolchain support.