利用GitLab API来获取仓库中某个文件的内容

相比于SVN的集中化版本控制方式，Git属于分布式版本控制系统，更适合代码的分支化管理。但是在下载Git项目的时候，不能像SVN那样只拉取指定的目录或文件，而是要下载整个repo。个人觉得Git的这个特点，在有些时候还是不太方便的。最近在查看GitLab的Help文档的时候，发现GitLab提供了很多GitLab API，利用GitLab API是可以实现对仓库中某个文件内容的获取的。

实现方法
通过GET /projects/:id/repository/files这个API来获取GitLab上指定项目id的repo里的某个文件信息（下例中项目id值为12），然后再用python代码对返回的json结果稍作处理，提取出里面content字段对应的内容，即为文件内容。

#coding:utf-8

import requests
import base64

# url结构说明：
# http://Gitlab服务器地址/GitLab提供的API访问路径?private_token=xxxxxxxxxxxxx&参数名1=参数值1&参数名2=参数值2[&...参数名n=参数值n]
# 参数说明：file_path指定项目中文件的路径；ref指定分支
url = "http://my.gitlab.com/api/v3/projects/12/repository/files?private_token=4S3JrHunQH7RTTCg9e8J&file_path=mydir/myfile&ref=master"

# 获取请求该url的结果，并转换为json
result = requests.get(url)
data = result.json()

# 由于content内容是base64编码过的，所以需要先作解码处理，不然返回的是一堆字母
print base64.b64decode(data['content'])

需要注意的是，GitLab API并不是随意可以访问的，是在验证访问权限之后才返回对应结果。访问权限的验证是通过private_token来实现的。每个GitLab账号都对应有一个private_token值，通过传递这个参数，GitLab服务器就能判断对应的这个账号具有什么样的访问权限。如果没有权限，会返回401 Unauthorized。

private_token的信息可以在登录GitLab之后，[Profile Settings] -> [Account]界面查看。