Go SDK の大幅な改善
Transloadit では、プログラミング言語 Go を高く評価しています。シンプルさだけでなく、効率的なシステムを構築できる点も魅力です。実際、AWS 上のマシンクラスターを管理するコアコンポーネントの一つは Go で書かれています。再開可能なファイルアップロードのための当社のオープンプロトコル tus のリファレンスサーバー実装である tusd も同様です。そのため、2014年に公式 Transloadit Go SDK を初めてリリースしたときは、とてもうれしく思いました。
しかし、SDK の誕生からまもなく3年を迎えるにあたり、本格的に刷新することにしました。そして本日、その成果として Go SDK v1.0 のリリースを発表できることを誇りに思います。バージョン 1.0 では、API インターフェースを全面的に見直し、ドキュメントを充実させ、Go の context パッケージに対応しました。このパッケージは、処理が応答しなくなるのを防ぐためのリクエストタイムアウトの設定に役立ちます。
さっそくコードを見ながら、簡単な例を紹介します。
-
まず、Go 1.7 以降がインストールされていることを確認してください。まだの場合は、ダウンロードしてください。その後、次のコマンドを実行するだけでパッケージをインストールできます。
go get -u gopkg.in/transloadit/go-sdk.v1インストールはこれで完了です。残りの手順はコードで進めます。
-
次に、デフォルト設定に API 認証情報を追加して、新しい Client インスタンスを作成します。
options := transloadit.DefaultConfig options.AuthKey = "AUTH_KEY" options.AuthSecret = "AUTH_SECRET" client := transloadit.NewClient(options) -
続いて、Assembly 構造体を作成し、アップロードするファイルを追加して、その処理方法を設定します。
assembly := transloadit.NewAssembly() assembly.AddFile("image", "./path/to/your/file") assembly.AddStep("resize", map[string]interface{}{ "robot": "/image/resize", "width": 75, "height": 75, "resize_strategy": "pad", "background": "#000000", }) -
処理設定を指定したら、Transloadit に送信し、必要な処理の実行を開始します。
info, err := client.StartAssembly(context.Background(), assembly) -
最後に、実行が完了して結果を取得できるようになるまで待ちます。
info, err = client.WaitForAssembly(context.Background(), info) fmt.Printf("You can view the result at: %s\n", info.Results["resize"][0].SSLURL)
これで完了です。新しい Go SDK を使って、初めての Assembly を正常に実行できました。さらに詳しく知りたい場合は、次の資料をご覧ください。
- サンプル: https://github.com/transloadit/go-sdk/tree/master/examples
- ソースコード: https://github.com/transloadit/go-sdk
- ドキュメント: https://godoc.org/gopkg.in/transloadit/go-sdk.v1
追伸:現在、できる限り優れた開発体験をお届けするため、SDK の改善に一層力を入れています。今後もこのような発表をお楽しみに!
