bigkeeper 0.7.3

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/big_keeper.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "big_keeper/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "bigkeeper"
+  spec.version       = BigKeeper::VERSION
+  spec.authors       = ["mmoaay"]
+  spec.email         = ["mmoaay@sina.com"]
+
+  spec.summary       = %q{Efficiency improvement for iOS modular development.}
+  spec.description   = %q{Efficiency improvement for iOS modular development, iOSer using this tool can make modular development easier.}
+  spec.homepage      = "https://github.com/BigKeeper/big-keeper"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "gli", "~> 2.16"
+  spec.add_runtime_dependency "big_stash", "~> 0.1"
+  spec.add_runtime_dependency "cocoapods"
+  spec.add_runtime_dependency "plist"
+  spec.add_runtime_dependency "colorize"
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "gli", "~> 2.16"
+  spec.add_development_dependency "big_stash", "~> 0.1"
+  spec.add_development_dependency "cocoapods"
+  spec.add_development_dependency "plist"
+  spec.add_development_dependency "colorize"
+  spec.add_development_dependency "rubocop", "~> 0.50.0"
+end

data/bin/big

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# require "bundler/setup"
+require "big_keeper"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docs/en-US/README.md

@@ -0,0 +1,50 @@
+[中文](../zh-CN/README.md)
+
+---
+
+# bigkeeper - All in home project
+
+[![Build Status](https://travis-ci.org/BigKeeper/bigkeeper.svg?branch=master)](https://travis-ci.org/BigKeeper/bigkeeper)
+[![Maintainability](https://api.codeclimate.com/v1/badges/c6dc4161e84fcec9a890/maintainability)](https://codeclimate.com/github/BigKeeper/big-keeper/maintainability)
+[![Gem Version](https://badge.fury.io/rb/bigkeeper.svg)](https://rubygems.org/gems/bigkeeper)
+[![Language: Ruby](https://img.shields.io/badge/language-Ruby-da212f.svg)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/license-MIT-000000.svg)](https://github.com/BigKeeper/big-keeper/blob/master/LICENSE)
+[![Gitter](https://img.shields.io/gitter/room/BigKeeper/BigKeeper.svg)](https://gitter.im/Big-Keeper/Lobby)
+
+bigkeeper is an efficiency improvement for iOS&Android modular development, iOSer&Android using this tool can make modular development easier.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'bigkeeper'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install bigkeeper
+
+## Usage
+
+Run `big` to learn how to use bigkeeper.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/BigKeeper/bigkeeper.
+
+## License
+
+![](https://upload.wikimedia.org/wikipedia/commons/thumb/f/f8/License_icon-mit-88x31-2.svg/128px-License_icon-mit-88x31-2.svg.png)
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/docs/zh-CN/BIGKEEPER_FILE.md

@@ -0,0 +1,62 @@
+# Bigkeeper 文件
+
+首先，我们在主项目 Podfile 所在的目录加入 **Bigkeeper** 文件。
+
+## 配置版本
+
+```
+version '2.8.8'
+```
+
+版本号的用途有：
+
+- feature 和 hotfix 流程里面做为分支名前缀的一部分，方便后期通过版本号匹配分支；
+- release 流程里面做为发布版本号，影响范围包括业务模块和主项目。
+
+## 配置主项目
+
+```
+home 'BigKeeperMain', :git => 'git@github.com:BigKeeper/BigKeeperMain.git', :pulls => 'https://github.com/BigKeeper/BigKeeperMain/pulls'
+```
+
+这个配置包含三个部分：
+
+- 主项目的名字；
+- 主项目的 git 远程仓库地址；
+- 主项目的 pull request / merge request 页面地址，完成某个 feature / hotfix 时，会自动打开这个页面，让开发者提交 pull request / merge request。
+
+## 配置业务模块
+
+```
+modules do
+  pod 'BigKeeperModular', :git => 'git@github.com:BigKeeper/BigKeeperModular.git', :pulls => 'https://github.com/BigKeeper/BigKeeperModular/pulls'
+end
+```
+
+这个配置包含可以配置多个业务模块，建议是把当前所有非第三方库都加入到这个配置里面：
+
+- 业务模块在 Podfile 中的名字；
+- 业务模块的 git 远程仓库地址；
+- 业务模块的 pull request / merge request 页面地址，完成某个 feature / hotfix 时，会自动打开这个页面，让开发者提交 pull request / merge request。
+
+## 配置用户自定义信息
+
+```
+user 'perry' do
+  pod 'BigKeeperModular', :path => '../BigKeeperModular'
+end
+```
+
+如果用户需要配置一些自定义信息，比如业务模块在本地的路径，就可以增加一个这样的配置。
+
+这个配置同样支持对指定的用户名（上述配置用户名为 perry）配置多个业务模块，目前支持的是：
+
+- 配置业务模块的本地路径，通过这个路径，我们就可以在主工程直接对业务模块做一些 CocoaPods 和 git 相关的操作。
+
+> 注：
+>
+> 1. 默认用户名是 git global config 的 user.name；
+>
+> 2. 默认我们会把本地路径配置成 `../{业务模块在 Podfile 中的名字}` 的形式，因为大部分情况下，我们会把项目都放在同级目录下，这也是我们推荐的；
+>
+> 3. 另外，在使用 bigkeeper 相关功能时，如果某些业务模块并没有 clone 到本地，bigkeeper 会根据之前配置的业务模块远程 git 地址 clone 业务模块仓库到**主项目同级目录下**。

data/docs/zh-CN/FEATURE&HOTFIX.md

@@ -0,0 +1,121 @@
+# feature - 功能开发流程 & hotfix - 线上修复流程
+
+> 注：hotfix 除了基础分支是 **master**，其他操作和 feature 一致，所以我们这里以 feature 为例说明。
+
+直接在命令行执行 `big feature --help` 可以查看其提供的所有功能：
+
+```
+NAME
+    feature - Feature operations
+
+
+SYNOPSIS
+    big [global options] feature delete
+    big [global options] feature finish
+    big [global options] feature list
+    big [global options] feature pull
+    big [global options] feature push
+    big [global options] feature start
+    big [global options] feature switch
+    big [global options] feature update
+
+COMMANDS
+    delete - Delete feature with name
+    finish - Finish current feature
+    list   - List all the features
+    pull   - Pull remote changes for current feature
+    push   - Push local changes to remote for current feature
+    start  - Start a new feature with name for given modules and main project
+    switch - Switch to the feature with name
+    update - Update modules for the feature with name
+```
+
+功能列表如下：
+
+- start：
+  开始一个新的 feature，输入参数依次为：
+  - feature 的名字;
+  - 开发该 feature 需要改动的业务模块名。可以多个，用空格隔开；如果不指定，取 **Bigkeeper 文件中所有的业务模块名**。
+- finish：结束当前 feature；
+- switch：切换到一个已经存在的 feature，输入参数为 feature 名；
+- update：
+  更新一个 feature 需要改动的业务模块，输入参数依次为：
+  - feature 的名字;
+  - 开发该 feature 需要改动的业务模块名。可以多个，用空格隔开；如果不指定，取 **Bigkeeper 文件中所有的业务模块名**。
+- pull：拉取当前 feature 主项目和业务模块的远程 git 仓库更新；
+- push：提交并推送当前 feature 主项目和业务模块的本地变更到远程 git 仓库，输入参数为提交信息；
+- delete：根据 featue 名删除主项目和业务模块所有相关分支；（PS：慎用，因为会删除本地和远程所有相关分支）
+- list：显示当前的 feature 列表。
+
+## 各个流程的使用场景
+
+- 如果需要开发新的功能，使用 bigkeeper feature start；
+- 开发功能过程中如果发现某个模块其实不用改动，使用 bigkeeper feature update 来把这个模块从这个 feature 移除；
+- 使用 bigkeeper feature pull 来同步主项目和相关业务模块远端变更；
+- 使用 bigkeeper feature push 来推送主项目和相关业务模块变更到远端；
+- 使用 bigkeeper feature switch 来切换 feature，比如：两个功能并行开发的时候，就可以用这个命令互相切换了；
+- 功能开发完成，需要提交 PR 时，使用 bigkeeper feature finish 结束开发；
+- 如果开发过程中突然有新的功能需要紧急开发，直接使用 bigkeeper feature start 进行新功能开发，旧功能未提交的内容我们会保存在 stash 中。
+
+## feature 的工作区
+
+![](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.002.jpeg)
+
+feature 的工作区主要由两部分组成：
+
+- 主项目；
+- 相关业务模块，我们把 Podfile 中引用方式为 `:path => {业务模块本地路径}` 的模块做为相关业务模块。
+
+主项目和每个相关业务模块又有各自的工作区，由三个部分组成：
+
+- 当前代码区改动；
+- stash 缓存区，当用户需要切换新的 feature 时，对于用户来不及提交的改动，我们会缓存到各个项目的 stash 中，（PS：所以代码突然不见了不要担心，都在 git 的 stash 里面），而当用户切换回某个 feature 时，我们会把和该 feature 分支同名的 stash 恢复回来，从而使用户可以继续开发之前未完成的部分，因为需要通过 feature 的分支名来匹配 stash，而 git stash 又没有提供给 stash 命名的功能，所以我们实现了 [bigstash](https://github.com/BigKeeper/bigstash) 来完成这个功能；
+- git。
+
+## 工作区缓存流程
+
+![stash 当前工作区](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.003.jpeg)
+
+## master／develop 分支状态检查流程
+
+![检查 master／develop 分支状态](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.004.jpeg)
+
+## 切换分支流程
+
+![切换分支](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.005.jpeg)
+
+## 同步业务模块与主项目分支流程
+
+![同步业务模块与主项目分支](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.006.jpeg)
+
+## finish 业务模块 feature／hotfix 流程
+
+![finish 业务模块 feature／hotfix](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.007.jpeg)
+
+## 从 feature／hotfix 移除模块流程
+
+![从 feature／hotfix 移除模块](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.008.jpeg)
+
+## feature start 流程
+
+![start](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.009.jpeg)
+
+## feature finish 流程
+
+![finish](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.010.jpeg)
+
+## feature switch 流程
+
+![switch](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.011.jpeg)
+
+## feature update 流程
+
+![update](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.012.jpeg)
+
+## feature pull 流程
+
+![pull](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.013.jpeg)
+
+## feature push 流程
+
+![push](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.014.jpeg)

data/docs/zh-CN/PODFILE.md

@@ -0,0 +1,43 @@
+# podfile - podfile版本控制流程
+
+直接在命令行执行  `big podfile --help` 可以查看其提供的所有功能
+
+```
+NAME
+    podfile - Podfile operation
+
+SYNOPSIS
+    big [global options] podfile [command options] detect
+    big [global options] podfile [command options] lock
+    big [global options] podfile [command options] upgrade
+
+COMMAND OPTIONS
+    --pod, --podfile=arg - (default: none)
+
+COMMANDS
+    detect  - Detect podname should be locked.
+    lock    - Lock podname should be locked.
+    upgrade - Update module version
+
+```
+
+全局参数如下：
+
+- -pod  --podfile ：podfile文件路径
+
+功能列表如下：
+
+- detect：
+    检测当前同步到本地的项目工程中podfile，得到未锁定的第三方库。
+    如果存在，提示需要指定版本。
+    如果不存在，提示无需指定版本的第三方库。
+
+- lock:
+    检测到存在需指定代版本的三方库后，执行lock指令对所有需要锁定的库进行锁定。
+
+- upgrade:
+    检测配置文件中指定业务库，有无最新可更新版本。
+
+  ## podfile lock 流程
+
+    ![](../../resources/readme/big-keeper-readme.011.png)

data/docs/zh-CN/README.md

@@ -0,0 +1,107 @@
+[English](../en-US/README.md)
+
+---
+
+# bigkeeper
+
+[![Build Status](https://travis-ci.org/BigKeeper/bigkeeper.svg?branch=master)](https://travis-ci.org/BigKeeper/bigkeeper)
+[![Maintainability](https://api.codeclimate.com/v1/badges/c6dc4161e84fcec9a890/maintainability)](https://codeclimate.com/github/BigKeeper/big-keeper/maintainability)
+[![Gem Version](https://badge.fury.io/rb/bigkeeper.svg)](https://rubygems.org/gems/bigkeeper)
+[![Language: Ruby](https://img.shields.io/badge/language-Ruby-da212f.svg)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/license-MIT-000000.svg)](https://github.com/BigKeeper/big-keeper/blob/master/LICENSE)
+[![Gitter](https://img.shields.io/gitter/room/BigKeeper/BigKeeper.svg)](https://gitter.im/Big-Keeper/Lobby)
+
+bigkeeper 是一个 **iOS&Android 模块化项目**效率提升工具，使用这个工具后，开发者**在主项目内**即可完成**包括其他业务模块在内**所有代码的编写和管理。
+
+> 注：目前只支持依赖 CocoaPods 管理的模块化工程。
+
+我们借鉴 CocoaPods 的做法，开发团队只需要在主项目中加入一个 Bigkeeper 文件，然后利用我们提供的 `bigkeeper` 工具，即可更便捷的实现**代码分支**和**业务模块**的管理；另外，通过我们提供的工具，也能帮助开发者养成更规范的日常开发习惯，减轻项目管理者的负担。
+
+## 应用场景
+
+在模块化项目的过渡阶段，我们往往会碰到业务拆分不是那么彻底的情况（PS：比如主项目中仍然存在业务相关代码），这样就会导致一系列问题：
+
+- 开发者开发一个 feature 时需要维护多个项目的分支，同时还要频繁修改主项目的 `Podfile`;
+- 项目管理者需要花很大精力去和团队成员同步项目管理规范流程，尤其对于新人，挑战很大；
+- 开发过程中如果碰到突发情况需要开新分支处理问题时对当前工作区的保存操作会很繁琐（PS：因为涉及到多个项目）；
+- 日常开发过程中类似 commit、pull、push 等操作比较繁琐（PS：因为涉及到多个项目）。
+
+bigkeeper 的出现就是为了解决这些问题。
+
+> 注：也有很多人认为直接做一个完整的组件化项目更合理，而不需要采用这样曲折的方案，但是很多时候我们并没有这么多的精力直接去做这些事情，bigkeeper 存在的价值也是为了帮助开发团队在 **iOS&Android 模块化项目过渡阶段**能更轻松的往前走。
+
+## 安装
+
+- 当作 Ruby Gem 使用：
+  在项目的 Gemfile 中加入下面这行：
+
+  ```ruby
+  gem 'bigkeeper'
+  ```
+
+  然后执行：
+
+    $ bundle
+
+- 直接安装：
+
+    $ gem install bigkeeper
+
+## 使用方法
+
+> 注：每个流程我们都提供详细的流程图来让你了解我们都做了些什么，为了方便你更好的了解我们的流程，我们提供了一个流程参考图，如下：
+>
+> ![](../../resources/keynote/big-keeper-readme-feature/big-keeper-readme-feature.001.jpeg)
+
+- [Bigkeeper 文件配置](BIGKEEPER_FILE.md)
+- `bigkeeper` 工具使用：
+
+  直接在命令行执行 `bigkeeper` 可以查看其提供的所有功能：
+
+  ```
+  NAME
+      big - Efficiency improvement for iOS&Android modular development, iOSer&Android using this tool can make modular development easier.
+
+  SYNOPSIS
+      big [global options] command [command options] [arguments...]
+
+  GLOBAL OPTIONS
+      --help         - Show this message
+      -p, --path=arg - (default: ./)
+      -u, --user=arg - (default: mmoaay)
+
+      -v, --ver=arg  - (default: Version in Bigkeeper file)
+
+  COMMANDS
+      feature - Feature operations
+      help    - Shows a list of commands or help for one command
+      hotfix  - Hotfix operations
+      podfile - Podfile operation
+      release - Release operations
+      version - Version
+  ```
+
+  全局参数如下：
+
+  - -p, --path：主项目所在的目录，默认是执行 bigkeeper 命令的当前目录；
+  - -v, --ver：版本号，如果没有指定的话，会以主项目 [Bigkeeper 文件](BIGKEEPER_FILE.md)中指定的版本为准。
+  - -u, --user：用户名，默认是 git global config 的 user.name，会显示在命令提示信息中，比如上述提示信息中的默认用户名是 mmoaay
+
+  功能列表如下：
+
+  - [feature](FEATURE&HOTFIX.md)：功能开发流程；
+  - [hotfix](FEATURE&HOTFIX.md)：线上修复流程；
+  - [release](RELEASE.md)：发布流程；
+  - [podfile](PODFILE.md)：Podfile 操作流程；
+  - version：查看 bigkeeper 当前版本号；
+  - help：查看 bigkeeper 帮助文档。
+
+## 其他
+
+- [一些建议](RECOMMEND.md)
+
+## 协议
+
+![](https://upload.wikimedia.org/wikipedia/commons/thumb/f/f8/License_icon-mit-88x31-2.svg/128px-License_icon-mit-88x31-2.svg.png)
+
+bigkeeper 基于 MIT 协议进行分发和使用，更多信息参见协议文件。