qcloudhive 0.1.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in qcloudhive.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,122 @@
+PATH
+  remote: .
+  specs:
+    qcloudhive (0.1.0)
+      cocoapods
+      colorize
+      git
+      gitlab
+      httparty (~> 0.14.0)
+      json (~> 2.0.2)
+      nokogiri
+      parseconfig
+      rake (~> 10.0)
+      terminal-table
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (2.3.5)
+    activesupport (4.2.8)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    claide (1.0.1)
+    cocoapods (1.2.0)
+      activesupport (>= 4.0.2, < 5)
+      claide (>= 1.0.1, < 2.0)
+      cocoapods-core (= 1.2.0)
+      cocoapods-deintegrate (>= 1.0.1, < 2.0)
+      cocoapods-downloader (>= 1.1.3, < 2.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-stats (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.1.2, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored (~> 1.2)
+      escape (~> 0.0.4)
+      fourflusher (~> 2.0.1)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.5.5)
+      nap (~> 1.0)
+      ruby-macho (~> 0.2.5)
+      xcodeproj (>= 1.4.1, < 2.0)
+    cocoapods-core (1.2.0)
+      activesupport (>= 4.0.2, < 5)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+    cocoapods-deintegrate (1.0.1)
+    cocoapods-downloader (1.1.3)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.0)
+    cocoapods-stats (1.0.0)
+    cocoapods-trunk (1.1.2)
+      nap (>= 0.8, < 2.0)
+      netrc (= 0.7.8)
+    cocoapods-try (1.1.0)
+    colored (1.2)
+    colorize (0.8.1)
+    diff-lcs (1.3)
+    escape (0.0.4)
+    fourflusher (2.0.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.0.3)
+    git (1.3.0)
+    gitlab (3.6.1)
+      httparty
+      terminal-table
+    httparty (0.14.0)
+      multi_xml (>= 0.5.2)
+    i18n (0.8.1)
+    json (2.0.2)
+    mini_portile2 (2.1.0)
+    minitest (5.10.1)
+    molinillo (0.5.7)
+    multi_xml (0.6.0)
+    nanaimo (0.2.3)
+    nap (1.1.0)
+    netrc (0.7.8)
+    nokogiri (1.7.0.1)
+      mini_portile2 (~> 2.1.0)
+    parseconfig (1.0.8)
+    rake (10.5.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    ruby-macho (0.2.6)
+    terminal-table (1.7.3)
+      unicode-display_width (~> 1.1.1)
+    thread_safe (0.3.6)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unicode-display_width (1.1.3)
+    xcodeproj (1.4.2)
+      CFPropertyList (~> 2.3.3)
+      activesupport (>= 3)
+      claide (>= 1.0.1, < 2.0)
+      colored (~> 1.2)
+      nanaimo (~> 0.2.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.14)
+  qcloudhive!
+  rake (~> 10.0)
+  rspec
+
+BUNDLED WITH
+   1.14.6

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 stonedong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,273 @@
+
+# hive iOS多模块管理工具
+
+腾讯云终端团队，目前需要维护的产品线很多，保守估计目前有5个产品线。而在众多产品线中有非常多的公用模块，这里就涉及到这些共用模块的维护问题，同时还有众多产品线源码管理的问题。我们希望尽可能的复用各个模块，也希望脱离原始的手工维护的噩梦，能够有一个较为先进的代码和产品管理工具。于是hive这个工具就诞生了。
+
+基于工具链：repo+git+cocoapods进行多模块管理和维护。
+
+
+
+## Install
+
+### 工具链搭建
+
+#### repo
+
+参考:[https://github.com/esrlabs/git-repo](https://github.com/esrlabs/git-repo)
+
+~~~
+mkdir ~/bin
+PATH=~/bin:$PATH
+git clone http://git.code.oa.com/stonedong/git-repo.git
+cp git-repo/repo ~/bin/repo
+chmod a+x ~/bin/repo
+~~~
+
+同时需要将~/bin目录添加到环境变量PATH中，请编辑文件~/.bashrc添加以下内容
+~~~
+export PATH=$PATH:~/bin
+~~~
+
+安装过程中出现问题可以参考：
+http://git.code.oa.com/stonedong/git-repo.git
+
+关于repo的更多用法请参考：[Repo command reference](http://source.android.com/source/using-repo.html)
+
+
+#### Git
+
+使用Xcode自带的Git。
+
+#### Cocoapods
+
+> 如果您当前的ruby版本低于2.2.0，请跟随文章[《MAC Ruby版本需要升级至2.2.2以上》](http://www.jianshu.com/p/8b13987f392a)升级您的ruby。
+
+~~~
+[sudo] gem install cocoapods
+~~~
+
+### hive 安装
+
+~~~
+git clone http://git.code.oa.com/qcloud-terminal/hive.git
+cd hive
+gem build qcloudhive.gemspec
+sudo gem install qcloudhive-0.1.0.gem
+~~~
+
+如果您当前在开发网环境下，运行gem命令的时候，请加上代理：
+
+~~~
+sudo gem install qcloudhive-0.1.0.gem --http-proxy http://dev-proxy.oa.com:8080
+~~~
+
+如果在安装过程中出现权限问题，尤其是MAC OS 10.11以上的系统版本：
+![](https://ww3.sinaimg.cn/large/006tNbRwgy1feivtwjt0sj31kw07gtay.jpg)
+
+请按照以下方法关闭系统的保护：
+
+附关闭方法：重启，开机按住Command + R，以Recovery分区启动，然后选择以下方式：图形化操作在Security Configuration中关闭Enforce System Integrity Protection命令行操作
+
+~~~
+csrutil disable
+~~~
+
+## Usage
+
+
+## 支持命令集
+
+在使用之前请在Home目录下面建立.hiveconfig配置文件，内容为：
+
+~~~
+[CodeOA]
+private_token = 您自己的git.code.oa.com上的private_token
+team          = 您自己的团队名称例如[qcloud-terminal]
+~~~
+
+> 以.开头的文件在linux系统中为隐藏文件，创建文件可使用命令 touch ~/.hiveconfig。编辑文件推荐使用atom。安装了atom的命令行版本后，可以运行atom ~/.hiveconfig来编辑改文件
+
+
+命令以以下方式运行：
+
+~~~
+hive [sub commnad namespace] [sub command] [parameters]
+~~~
+
+支持的命令集：
+
+|子命令空间|子命令|释义|支持参数| and more|
+|:--|:--|:--|:--|:--|
+|module|add|添加一个子模块到当前项目中|-------|该命令会检测codeoa上是否存在相关git仓库，不存在则创建对应的Git仓库，如果存在则将其添加到对应当前项目中，并检查其在cocoapods specs上的依赖关系，并以同样的相对路径将依赖引入到当前工程|
+| |||-n name |子模块名称（require）|
+| |||-p path|子模块在工程中的相对路径（option）|
+| |release|发布当前模块到cocoapods specs|-------|---------------------------------------|
+| |||-n name |子模块名称（require）|
+| |dislink|删除对于某个模块的源码引用|-------|hive开发模式是方便在源码开发调试和pods发布版本之间切换的模式，使用该名后，将模块的源码引用从项目中移除|
+| |||-n name |子模块名称（require）|
+|manifest| push|提交本地对于repo的配置文件manifest的修改|无||
+|framework|build|根据名称将当前项目中所有的模块打包成一个framework|-------|---------------------------------------|
+| |||-n name |子模块名称（require）|
+|project|init|初始化项目|-------|该命令会根据对应的名字创建一个新的项目包括：CodeOA上的Git仓库，用于存储repo配置，本地对应的目录。如果CodeOA上已经存在对应的仓库，则不会创建，直接Checkout。|
+| |||-n name |子模块名称（require）|
+|product|init|创建Demo工程|------|该命令回在当前目录下，根据对应的名称创建一个崭新的Demo工程|
+| |||-n name |子模块名称（require）|
+| |update|更新Demo产品|------|该命令会在所有产品下面运行pod update命令|
+|repo|status|各子模块状态检查|------||
+| |request|将当前所在的模块提交Merge Request|------||
+|feature|commit|在有修改的模块当中调用git commit -m |------||
+| |||-m message |提交Commit Message（require）|
+| |push|推送本地的修改到服务器|------||
+
+### Checkout一个项目：
+
+在配置好工具链之后，就可以Checkout项目进行开发了。以QCloudSDK为例：
+
+~~~
+hive project init -n name
+~~~
+
+Checkout后记得将当前的项目切到正在开发的分支上，例如切到主分支：
+
+~~~
+repo start master --all
+~~~
+
+### Crate a hive 项目
+
+~~~
+hive project init -n name
+~~~
+
+
+
+### 创建子模块命令
+
+~~~
+hive module add -n name
+~~~
+
+> 新版本不用指定--project-name 会自动从url中提取PATH部分作为projectname
+
+
+### 同步配置文件manifest
+
+~~~
+hive manifest push
+~~~
+
+### 打包Framework命令
+
+运行该命令，将会按照指定的名称，将产品目录下面所有的podspec合成并打包成一个framework，输出到当前目录
+
+~~~
+hive framework  build [-n framework-name]
+~~~
+
+
+### 添加已经存在的子模块到manifest命令
+
+ ~~~
+ hive module add  -n[name]  -p [local relevete path]
+ ~~~
+
+ 添加完成后，需要进行拉取代码的话请使用命令
+
+ ~~~
+ repo sync
+ ~~~
+
+ > 该命令目前不会解决子模块的依赖问题，当引入一个模块之后，需要手动的将其依赖的其他子模块引入到工程之中！！！！！！！！。自动支持依赖将会在后续版本中支持。
+
+### 创建DemoAPP命令
+
+> 创建完成完成Demo APP不会自动添加到manifest里面，如果需要添加到manifest里面请调用add-module子命令
+
+ ~~~
+ hive product create  -n[name]
+ ~~~
+
+## 开发模式简介
+
+首先hive构建的是一整套组件化开发的基础工具链。所谓组件化开发，就是将程序按照功能打散成一个个组件。然后通过组件之间组合构建出一个产品，这个产品可能是APP也可能像云这样是Framework。同时还解决了一个协作的问题，每个组件都是一个git库，每个组件都有可能被多人开发，而一个产品会涉及到多个组件的调用。这种使用我们按照单个组件的维护看，我们使用git-flow的模式。master为发布分支，其他分支为开发分支。而从整体产品的角度看，则是所有组件的库统一切到一个分支。则构成了当前产品的开发环境。
+
+比如COS产品，涉及到QCloudCore和QCloudHTTPMock模块，当两个模块都切到master分支的时候，就构成了COS产品的一个发布环境，当都切到check分支的时候，就构成了产品特性为**的开发环境。这里需要强调的是，master分支是不能提交更改的。只能通过merge-request的方式来合并其他分支的修改。
+
+在开发的过程中，我们强烈建议引入CR，因此我们使用merge request的方式来强制CR。
+
+
+### 从零创建一个项目
+
+首先需要创建一个git repo用来保存manifest文件。这里以创建QCloudSDK项目为例：
+
+~~~
+hive project init -n QCloudSDK
+~~~
+
+project init命令会自动去git.code.oa.com上检查是否存在对应的项目，如果不存在则会调用接口创建该项目。
+
+> 注意，腾讯云的终端同学，项目情使用QCLOUD前缀
+
+建好之后便可添加依赖的模块或者创建demo项目
+
+比如使用下述命令引入一个模块QCloudFileUtils,同样如果该模块不存在，则会新建该模块
+
+~~~
+hive module add -n  QCloudFileUtils
+~~~
+
+使用下述命令创建一个Demo
+
+~~~
+hive product init -n XXXX
+~~~
+
+demo会建立在当前目录下面，需要注意的是Demo不会添加到整个项目的依赖中，需要手工添加。
+
+
+### 使用已有项目
+
+通用如果你是使用已经存在的项目则可以直接
+
+~~~
+hive project init -n QCloudSDK
+~~~
+
+#### 同步项目
+
+当项目已经check到本地，需要下载远端的修改，执行下述名。
+~~~
+repo sync
+~~~
+
+> 在同步完成后，子模块的分支会切换到具体的commit版本上去，此时需要运行`repo start [project name] --all` 来重新切换分支
+
+在同步的过程中会发生git的错误，当出现错误的时候请到对应的子模块的目录下面进行操作，清除相关错误：
+
+1. conflict冲突问题
+2. checkout错误
+3. 合并commit出错
+
+修正完错误之后，再次运行repo sync命令
+
+#### 开发
+
+在开发代码之前需要首先需要将需求涉及到的模块切到对应分支，比如现在我们有A，B，C三个模块，开发需求upload，现在需要修改A，B模块：
+
+~~~
+repo start upload A B
+~~~
+
+之后进行代码开发
+
+#### 提交
+
+在提交之前使用,使用下述命令来检查各个模块的状态：
+
+~~~
+hive repo status
+~~~
+
+![](https://ww4.sinaimg.cn/large/006tNc79gy1fdy37qsaw9j30p10l1tcs.jpg)
+
+然后在各个模块中执行对应的操作之后，进行提交

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "qcloudhive"
+
+# 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