2014-05-29

GitLab API (gitlab gem)を使ってみました

今年の新人研修で課題の提出場所に GitLabを使ってみました。生徒の人数分 x 課題数のリポジトリーが作られるので、課題結果を自分の環境にcloneするのを手動で行っているとたいへんです。そこで、GitLab APIを使い、簡単なツールを作ってみました。

GitLab APIには gitlab gem があり、簡単に使う事ができます。しかし、いざ自分のやりたいプログラムを書こうと思ったら・・・・

APIドキュメントはあるが、内容は今ひとつ
サンプルコードが少ない
ネット上 (英語の情報を含め)にも情報が少ない

という事で、gitlab gem の RSpecコードなどを見ながら勉強しました。また、APIの設計があまりオブジェクト指向的でなく、最初は戸惑いました。

以下のコードは、あるグループに所属する全員のレポジトリーの一覧を表示し、そのリポジトリをアクセスするために自分のアカウントを管理者として登録し、全リポジトリーを clone するコードです。

PRIVATE_TOKEN は管理者(root)アカウントの PRIVATE_TOKEN を指定して下さい。

#!/usr/bin/env ruby
require 'gitlab'

GUEST_LEVEL       = 10
MASTER_LEVEL      = 40
GITLAB_SERVER_URL = 'http://GITLAB_SERVER'
GITLAB_API_URL    = "#{GITLAB_SERVER_URL}/api/v3"
PRIVATE_TOKEN     = 'xxxXXXXXXXXXXxxXXXXn'
GROUP_NAME        = 'student'
MY_NAME           = 'yuumi3'


def get_group_members(gitlab_root, group_id)
  gitlab_root.group_members(group_id).select{|e| e.access_level == GUEST_LEVEL}.map(&:username)
end

def add_member_to_projects(gitlab_member, user_id)
  gitlab_member.projects.each do |project|
    unless gitlab_member.team_members(project.id).find {|m| m.id == user_id}
      gitlab_member.add_team_member(project.id, user_id, MASTER_LEVEL)
      puts " add users to #{project.path_with_namespace}"
    end
    
  end
end

def list_all_projects(gitlab_member)
  gitlab_member.projects.each do |project|
    puts "  #{project.path_with_namespace}"
  end
end

def clone_all_projects(gitlab_member)
  gitlab_member.projects.each do |project|
    unless File.exists?(project.path_with_namespace)
      cmd = "git clone git@#{GITLAB_SERVER_URL}:#{project.path_with_namespace} #{project.path_with_namespace}"
      puts "  #{cmd}"
      system cmd
    end
  end
end


gitlab_root = Gitlab.client(endpoint: GITLAB_API_URL, private_token: PRIVATE_TOKEN)
username_to_id  = Hash[*gitlab_root.users.map {|u| [u.username, u.id]}.flatten]
groupname_to_id = Hash[*gitlab_root.groups.map {|u| [u.name, u.id]}.flatten]

members = get_group_members(gitlab_root, groupname_to_id[GROUP_NAME])

# 生徒のrepository一覧
members.each do |member|
  gitlab_member = Gitlab.client(endpoint: GITLAB_API_URL, private_token: PRIVATE_TOKEN, sudo: member)
  list_all_projects(gitlab_member)
end

# 生徒のrepositoryに私を管理者として追加
members.each do |member|
  gitlab_member = Gitlab.client(endpoint: GITLAB_API_URL, private_token: PRIVATE_TOKEN, sudo: member)
  add_member_to_projects(gitlab_member, username_to_id[MY_NAME])
end

# 生徒のrepositoryをclone
members.each do |member|
  gitlab_member = Gitlab.client(endpoint: GITLAB_API_URL, private_token: PRIVATE_TOKEN, sudo: member)
  clone_all_projects(gitlab_member)
end

2008-04-17

ActiveState Komodo Edit 日本語メニュー

開発ツール

Komodo Edit4.3 用日本語拡張モジュールが出てました → http://komodonoko.com/node/44 ありがとうございます！

日本語化されるのは、メニューやツールチップのみで、エラーメッセージやヘルプは日本語化されません。

インストル手順は、ダウンロードしたファイルを展開し出来た komodo-ja.txt に書かれています。
私の場合、インストール＆再起動後 locale_switcher-2.1.xpi が有効になりませんでしたが、再度 locale_switcher-2.1.xpi をインストール＆再起動したら日本語化できまました。

追記

日本語メニューの一部がエラーになってますね。

2008-04-09

Komodo Edit で Perl/HTML を書く

Perl 開発ツール

Perl のお仕事で Komodo Edit を使っています。 Perl コードのチェック機能では未定変数が分かったりと文法以上の事も調べてくれるので便利です。

今日は、HTML を Komodo Edit で書いているのですが、Preview Tabを ON にすると、HTMLを保存した際に表示イメージを再表示してくれるので HTML作成作業がはかどります。また、CSSの補完機能はCSSの属性名に明るくない私には大助かりです。

2008-04-05

NetBeans を試してみた

Ruby 開発ツール

基本情報：

- 名前、バージョン： NetBeans 6.01
- 形態： OSS
- Platform: Windows,Mac OS X,Linux ... (Javaが動作するOS)
- 入手先： http://download.netbeans.org/netbeans/6.0/final/
- 日本語の情報：http://ja.netbeans.org/index.html
- その他： Ruby(MRI), JRubyの利用が可能

評価

インストール

簡単

日本語

日本語メニュー： ○
ソースコードの日本語表示：○
日本語入力： ○
日本語HELP： ○
Ruby/Railsのメソッド説明： ×

起動時間など

それほど遅くない

補完機能など

rubyシンタクスやメソッドの補完が出来る、引数やメソッドのドキュメントが表示される
文法チェックあり

その他機能

リファクタリング機能として名前の変更機能があり、その名前を参照している部分も変更してくれる
SVN等との連携機能があるが、リポジトリーブラウズ機能がないので使いにくい
ジェネレータ (script/generate相当) 説明あり
サーバー起動 (script/server相当)
rake の実行アシスト機能あり
gem 管理

感想

IDEというと、大きい、起動遅い・・・という印象がありますが裏切られました。まず、インストールファイルが20Mbyte しかありません！起動もEclipseに比べるとかなり早いです。

以前評価した時は JRuby でしか実行できなかったのですが、今は普通のRuby (MRI)でも実行できます。

補完機能はかなり良いレベルまで来てますね。初期のEclipseでJavaの開発をするイメージかな？メソッド等の説明が表示されるのでですが、それが日本語になれば最高かも。
また、リファクタリング機能として名前の変更機能があり、参照している部分も変更されるのは素晴らしいですね。

日本語化もほぼ出来ていて、IDEとしての完成度がかなり高くなっています。 IDEが好きな人にはお勧めです。

2008-04-03