- 投稿日:2020-10-09T20:28:41+09:00
Qiitaの記事をZenn形式のMarkdownで保存して管理する
概要
Zenn で記事を GitHub に管理しているのですが、ここに昔 Qiita で書いた記事も加えたくて、Qiita の記事を Zenn 形式で保存するコマンドを作りました。
インストール
GO111MODULE=on go get -u github.com/ikawaha/qiita-zenn
使い方
Zenn と連係しているレポジトリの
articles
の配下で以下を実行します。$ qiita-zenn -user ikawaha -verbose https://qiita.com/api/v2/users/ikawaha/items?page=1 Goa v3 のテストをシュッとする 人生で何度目かのダブル配列TRIEを書いた 形態素解析器 kagome のユーザー辞書の使い方 goa でデザイン・ファーストをシュッとする golang で string のポインタを取得する Luceneで使われてるFSTを実装してみた(正規表現マッチ:VMアプローチへの招待) メモ:golang で []byte と string の読み込みを透過的に扱う試行錯誤 Elasticsearch CheatSheet Pure Go な形態素解析器で実行バイナリに辞書埋め込んだヤツを作ってみた(3) 完結編 json を pretty print するのに echo '{"apple": "red", "lemon": "yellow"}' | python -m json.tool は冗長じゃないですか?なので go でコマンド用意しました 【kagome】形態素解析のラティスをグラフで表示できるようにしてみた golang のリファクタリングには gofmt が使える golang で string を []byte にキャストするとメモリコピーが走ります Elasticsearch で 文字の正規化を icu_normalizer でおこなう goをソースからコンパイルしてgodocが見つからない デフォルトのElasticsearchは常にクラスタを組みたがっているので気をつける,というかクラスタ設定とめとく pythonクライアントで始める「はじめてのElasticsearch」 Travis CI で goxc を使うとなぜかgo1.3のときだけビルドがこける travis setup releases で Validation Failed になるときの解消法 全裸改善:形態素解析器 kagome に go-bindata を使ったらビルド時間とバイナリのサイズが劇的に改善,『全裸で形態素解析スクリプト』もビルドでこけなくなるはず! https://qiita.com/api/v2/users/ikawaha/items?page=2 go-bindata でコンパイル時にリソースを埋め込んじゃおう! Pure Go で辞書同梱な形態素解析器 kagome を公開してみました Go で利用できるプロファイリングツール pprof の読み方 Go でフォルダに含まれる特定の拡張子のファイルだけ列挙するには path/filepath を使う Pure Go な形態素解析器で実行バイナリに辞書埋め込んだヤツを作ってみた (2) 未知語処理編 Pure Go な形態素解析器で実行バイナリに辞書埋め込んだヤツを作ってみた (1) Go で euc-jp や sjis の csv ファイルを読み込むには変換用のリーダーを1つかませるだけでよかった Go で DoubleArray を実装して Common Prefix Search する Go でスライスの拡張をレシーバでおこなう(スライスのレシーバを作ろうとしてはまったこと ) Go でファイルを1行ずつ読み込む(csv ファイルも) Go でグラフを plot するパッケージを試した Go で機械学習(の手習い) https://qiita.com/api/v2/users/ikawaha/items?page=3画像はディレクトリ
img
に保存されますが、記事中のリンクを変更しているわけではありません。記事中のリンクは変更しなくても参照できるので問題ないでしょう。もしリンクが切れてしまったら画像を元に差し替えが必要かも知れません。$ ls img/ qiita-6fd4071187640f6bf66d.md qiita-c4859421d67a27e9ffc6.md qiita-1235a6c93c969591f517.md qiita-73c0a1d975680276b2c7.md qiita-c654f746cfe76b888a27.md qiita-228ee3f481e9636b3065.md qiita-79fdd69c524310db065e.md qiita-e0c2b3ed0fedb12f4847.md qiita-235371a7b1066ba5ea6c.md qiita-8a01c5739401e26e8794.md qiita-e3b35f09fb49e9217924.md qiita-28186d965780fab5533d.md qiita-8a94b728105e03a76468.md qiita-ea1ca5ee90296307c4bc.md qiita-2d58f58e4ab12918e8c9.md qiita-8c2b3bd56ff427e9d2d0.md qiita-edb4e18960ae6e4babc3.md qiita-3c3994559dfeffb9f8c9.md qiita-9ebe3e1104fb80706d99.md qiita-f0a046428f907bf9ba98.md qiita-540c2af34b1c381c37c1.md qiita-adb24788f818dc9835f9.md qiita-f43a78f171836f1ec86b.md qiita-5d21f16218bb13eeb286.md qiita-b57ce0d934f080cb8f72.md qiita-f9e8b6ad2cae1eb593f7.md qiita-61dac34ebfe2f8fa5c61.md qiita-be95304a803020e1b2d1.md qiita-fdcf3ccf13f23a860390.md qiita-6638ee8b6978aef50d65.md qiita-c02d84cfd00f8f442500.md qiita-ff27ac03e22b7f36811b.md記事は公開しない状態で作成されます。また、絵文字は決め打ちになっています。
Zenn の手元のプレビューで見れていれば問題ないでしょう。
これで Qiita で書いた記事もより管理しやすくなりそうです ╭( ・ㅂ・)و ̑̑ グッ !
Happy hacking!
- 投稿日:2020-10-09T16:00:06+09:00
冷やかしで作った翻訳コマンド(TUI)が便利過ぎるのでガチ使い!
GAS をラップした翻訳ツール (TUI command) を Go 言語で書きました。
対象読者
以下に該当する方にとっては読む価値があるかもしれません。
- 英語(や他の外国語)が苦手で翻訳ツールが手放せない
- ターミナルで作業する時間が長い
- translate-shell よりシンプルで視認性の良いコマンドを探している
- GAS (Google Apps Script) に興味がある
- Golang (Go 言語) の TUI ツールの実装に興味がある
目次
1. はじめに
英語が苦手な僕は、ドキュメントを読むときも書くときも、辞書サイトや翻訳サイトが手放せません。
普段、ターミナルで作業をすることが多いんですが、Web ブラウザとターミナルソフトの間を行ったり来たりしているので、それはそれはストレスが溜まります。そんなある日、GAS (Google Apps Script) を触ったことがなかった僕は、後学のためにちょっと試してみようと思い、LanguageApp をラップしたお手軽翻訳コマンドを作ってみたんです。
最初は洒落で作り始めたつもりだったんですが、意外にもこれが便利に使えることがわかったので、記事にして紹介したいと思います。
コマンドは以下のリポジトリで公開しています。
類似するものに translate-shell というツールがあります。使っている方も多いと思いますが、本稿の後半で go-tran と translate-shell の違いについても触れています。
2. go-tran の概要
対応OS
Linux と Windows で動作確認しています。
(Mac でも動くと思います)対話型インターフェス
tran コマンドを引数なしで実行すると、対話型シェルが起動します。
翻訳する
デフォルトでは、実行環境のカレント・ロケールの言語へ翻訳されるので、あとは翻訳したい外国語を入力するだけです。
以下は、英語、フランス語、イタリア語、スペイン語、韓国語、中国語を日本語へ翻訳する例です。
上記画像ではプロンプトが:ja>
となっています。
これは(Source):(Target)>
の形式になっていて、変換元 (Source) の言語が自動 (Auto) で、変換先 (Target) の言語が日本語 (ja) という意味です。例えば、日本語から英語へ翻訳する場合はja:en>
と表示されます。言語を切り替える
変換先の言語を切り替えるには、2 桁の言語コード (ISO639-1) を入力します。
以下は、ターゲットの言語を切り替えながら、日本語を英語 (en)、フランス語 (fr)、イタリア語 (it)、スペイン語 (es)、韓国語 (ko)、中国語 (zh) へ翻訳する例です。
言語コードが分からない場合
言語コードが分からない場合は l (エル) コマンド (l: Language codes) で調べられます。
l コマンドは、入力した文字列が ISO639-1 コードと同じか、ISO 言語名称 (英名) に部分一致したものの一覧を表示します。どちらにも引っかからなかった場合は、内部で英語に変換してから再検索をかけるため、例えば日本語で入力した名称でも、目的の言語コードを比較的簡単に見つけることができます。
以下は「 l コマンドで "nor" を含むもの、"nese" を含むもの、"ドイツ語"、"クルド語"、"ズールー語" を検索し、その一覧は表示できたが、"カンブリア語" は見つからなかった」という例です。
バッチ・インターフェス
コマンドライン引数にファイル名を指定したり、コマンドの標準入力へパイプやリダイレクトで繋いだ場合はバッチ・コマンドとして実行されます。
ファイルの指定
引数にファイルのパス名を渡して go-tran を実行すると、そのファイルを翻訳してくれます。これも変換先の言語(デフォルト値)は実行環境のカレント・ロケールにより決まります。
パイプやリダイレクト
標準入力がターミナルではない場合、go-tran はバッチモードで実行されます。
例えば、僕の Ubuntu 環境は man が日本語で表示されるようになっているのですが、日本語のマニュアルが用意されていないコマンドもあります。普段あまり使わないコマンドほど日本語化されていなかったりしますよね。これまでは、知らない英単語に出くわしたときはわざわざ Web ブラウザを開いて調べていました。
でもこれからは man を go-tran にリダイレクトするだけで済みます。
3. go-tran の使い方
インストール
Go の環境がある場合
install go-tran$ go get github.com/y-bash/go-tran $ cd $GOPATH/src/github.com/y-bash/go-tran $ go install ./...Go の環境がなく、ソースコードのみ取得する場合
get source code$ git clone https://github.com/y-bash/go-tran.git
もし、Go の環境はないけどバイナリを使ってみたいという方がいたら、方法を考えますので、気軽に声をかけてくださいね。
対話型で使う
起動する
実行ファイルは tran という名前です。
$ tran Welcome to the GO-TRAN! ...
コマンドの説明
入力した文字は概ね以下のように判断されます。
文字列 説明 1 文字 コマンドとして判断。 2 文字 Target 言語の切り替え。 3 文字以上 入力したテキストを現在のモードに従って翻訳。 コマンドの種類は以下のとおりです。
コマンド 説明 例 h ヘルプを表示します。 l [str] 言語コードと名称の一覧を表示します。
(言語コードは ISO639-1)
- str を指定した場合
マッチする言語コードの一覧を表示- str を省略した場合
すべてのコード (184 件) を表示
- コード、名称に "en" を含むもの
l en
- 名称に "nor" を含むもの
l nor
- 名称に英名 "Welsh" を含むもの
l ウェールズ語
s [str] 変換元の言語 (Source) を切り替えます。
- str を指定した場合
マッチする言語へ切り替え- str を省略した場合
Auto (自動モード)へ切り替え
※通常は Auto で問題なし
- 英語へ
s en
- スペイン語へ
s spanish
- ポルトガル語へ
s ポルトガル語
- Auto(自動モード) へ
s
[t] code
t [str]変換先の言語 (Target) を切り替えます。
- t を省略した場合
2 桁のコード (ISO639-1) で
指定した言語へ切り替え- t の後に str を指定した場合
マッチする言語へ切り替え- t の後の str を省略した場合
実行環境のカレント・ロケール
へ切り替え
- カレント・ロケールへ
t
- 英語へ
t en
- ラテン語へ
t ラテン語
- C 言語へ
c
q 終了 キー操作
主なキーバインドは以下のとおりです。
(bash 互換です)カーソル移動
キー 説明 代替キー Ctrl-a 行頭へ移動 Home Ctrl-e 行末へ移動 End Ctrl-b 1文字後退 ← Ctrl-f 1文字前進 → 文字削除
キー 説明 代替キー Ctrl-h カーソル位置の手前の文字を削除 Back
spaceCtrl-d カーソル位置の文字を削除 Delete Ctrl-k カーソル位置から行末まで削除 Ctrl-u 行頭からカーソル位置の手前まで削除 履歴操作
入力したコマンドやテキストはヒストリに保存されるので、キー操作でそれを辿ることができます。
キー 説明 代替キー Ctrl-p 入力履歴を遡る ↑ Ctrl-n 入力履歴を進む ↓ Ctrl-r 入力履歴のインクリメンタルサーチ バッチコマンドとして使う
書式
コマンドの書式は以下のとおりです。
formattran [options] [path...]オプション
オプションは以下のとおりです。
option 説明 例 -h ヘルプを表示します。 $ tran -h
-l 言語コードと名称の一覧 (184件) を表示します。
(言語コードは ISO639-1)$ tran -l
-s code 変換元の言語 (Source) を
言語コード(ISO639-1)で指定します。
省略した場合は自動判別。$ tran -s en
-t code 変換先の言語 (Target) を
言語コード(ISO639-1)で指定します。
省略した場合はカレント・ロケールへ変換。$ tran -t en
パス
path の指定方法は以下のとおりです。
path 説明 例 指定 指定したファイルを翻訳して標準出力へ出力します。 $ tran a.txt b.txt
省略
- 標準入力がターミナルの場合
対話型で起動- 標準入力がパイプやリダイレクトの場合
翻訳した結果を標準出力へ出力
- ss コマンドの man を翻訳
$ man ss|tran|less
- Go のコンパイルエラーを翻訳
$ go build . 2>&1|tran
- ファイルをリダイレクト
$ tran < a.txt
※セル内の "|" は全角文字です。
コピペの際はご注意ください。使用例
難しい英単語を取り急ぎ確認
$ echo "penpineappleapplepen" | tran ペンパイナッポーアップルペン日本語のファイルを英語にする
$ tran -t en Japanese.txt this is a pen.日本語のファイルをラテン語にして保存
$ tran -t la Japanese.txt > Latin.txt自動翻訳の結果を日本語に還元して、しっくりくるか確認
$ echo "僕はりんごが大好きです" | tran -t en | tran りんごが大好きstrings.Builder (Golang) のソースコードの全コメント行を日本語にする
$ grep '^\s*//' ./builder.go | sed -e 's/^\s*..\s*//' | tran Copyright 2017 The GoAuthors。全著作権所有。 このソースコードの使用は、BSDスタイルによって管理されています LICENSEファイルにあるライセンス。 Builderは、Writeメソッドを使用して文字列を効率的に構築するために使用されます。 ...カレントディレクトリ配下の全ログファイルのエラー行を日本語にする
$ find . -name '*.log' | xargs grep 'error:' | tran ./tool/vim/src/auto/config.log:conftest.c:154:12:エラー: 'GETACLCNT'が宣言されていません(この関数での最初の使用) ./tool/vim/src/auto/config.log:conftest.c:154:26:エラー: 'NULL'が宣言されていません(この関数での最初の使用) ...4. translate-shell との比較
実は僕が translate-shell のことを知ったのは、 go-tran を作り始めた後でした。
機能もほとんど似ており、コマンド名も同じtrans
だったので驚きました。
(最初は go-trans という名前だったんです)しかも、translate-shell は品詞などの付加情報を表示してくれたり、単語に複数の意味がある場合はそれを表示してくれたりと高機能です。
でも、少し使ってみると、go-tran には go-tran の良さがあることが次第にわかってきました。
translate-shell のメリット
translate-shell は、翻訳結果だけでなく以下のような付加情報も表示してくれます。
- 変換元の言語
- 変換先の言語
- 品詞(単語の場合)
- 複数の意味(単語の場合)
辞書のように使えるため、英作文などでは使い勝手が良いかもしれませんね。
とはいってもがっつり英文ドキュメントを書かなければならない場合はもっとしっかりした辞書が必要になると思います。go-tran のメリット
translate-shell に対する go-tran のアドバンテージは以下のとおりです。
- シンプル
余計な情報を出力しないため見やすいです。
品詞などの付加情報は時として邪魔になります。- カラー表示
カラー表示なので、見たい箇所を瞬時に判別できます。- 言語コードの検索機能
go-tran なら言語コードを簡単に見つけられます。
translate-shell では言語コードを記憶しておくか、ドキュメントを見なければならないでしょう。- bash ライクなキーバインド
go-tran は文字編集がしやすいです。
translate-shell は標準入力を単に読み取っているだけのようで、文字編集に難があります。- ヒストリ機能
go-tran は前に入力したコマンドやテキストを再表示し、それを編集して実行することができます。
これも translate-shell にはない機能です。- Windows ネイティブ対応
go-tran は Windows のコマンドプロンプトで実行できます。
translate-shell では Cygwin などの UNIX 互換環境が必要なようです。5. 作り方は簡単
GAS (Google Apps Script) で作る Web API も、Go で作るクライアントもとても簡単です。
GAS で Web API を作る
tanabee さんの大人気記事を参考にさせていただきました。
参考にさせていただいたコードに、以下の処理を追記しています。
- json で返却
- GET/POST に対応
- 例外処理
- 例外メッセージを英語で出力
コードは以下のとおりです。
Translate.gs// 共通処理 // param e イベント function process(e) { let body // レスポンスボディ try { const p = e.parameter // リクエスト・パラメータ const s = LanguageApp.translate(p.text, p.source, p.target) // 翻訳 body = {code: 200, text: s} // レスポンス・ボディの作成 } catch (e) { // param e 例外 // 翻訳に失敗した try { const msg = LanguageApp.translate(e.toString(), "", "en") // エラーメッセージを英語へ body = {code: 400, message: msg} // レスポンス・ボディの作成 } catch (e) { // param e 例外 // これに失敗するということは内部エラー body = {code: 500, message: e.toString()} // レスポンス・ボディの作成 } } let resp = ContentService.createTextOutput() // レスポンス resp.setMimeType(ContentService.MimeType.JSON) // MIME タイプを JSON 形式にして resp.setContent(JSON.stringify(body)) // レスポンス・ボディを JSON 形式の文字列に変換 return resp; // レスポンスを返却 } // GET // param e イベント function doGet(e) { return process(e) // 共通処理の呼び出し } // POST // param e イベント function doPost(e) { return process(e) // 共通処理の呼び出し }上記コードで process(e) と 2 つの catch(e) で同名の変数を使っているのが気になる方は変数名を変更してください。
なお、スクリプトを修正した後に Project version を New にしないとプロダクトに反映されないということを知らなかったため、これで 20 分くらい悩みました。
Go でクライアントを作る
GAS で作った Web API をラップするクライアント側の関数(Go 言語)のは以下のとおりです。
tran.gopackage tran import ( "encoding/json" "errors" "io/ioutil" "net/http" "net/url" "strings" ) const gURL = "https://script.google.com/macros/s/@@script@@/exec" // @@script@@ 要修正 // レスポンスの JSON をマップする構造体 type TransData struct { Code int `json:"code"` // レスポンス・ステータス Text string `json:"text"` // 翻訳結果 Message string `json:"message"` // エラーメッセージ } // 翻訳 func Translate(text, source, target string) (string, error) { // パラメータの作成 v := url.Values{} v.Add("text", text) // 変換元の文字列 v.Add("srouce", source) // 変換元の言語 (ISO639-1) v.Add("target", target) // 変換先の言語 (ISO639-1) // 翻訳 API へ POST でリクエスト resp, err := http.PostForm(gURL, v) if resp != nil { defer resp.Body.Close() } if err != nil { return "", err } // レスポンス・ボディをバッファへ読み込む buf, err := ioutil.ReadAll(resp.Body) if err != nil { return "", err } // レスポンス・ボディ (JSON 形式) を構造体へマップ var td TransData if err := json.Unmarshal(buf, &td); err != nil { return "", err } // レスポンス・ステータスの検査 if td.Code != 200 { // エラー処理 (プレフィクスの "Exception: " を取り除く) msg := td.Message prefix := "exception:" if strings.HasPrefix(strings.ToLower(msg), prefix) { msg = string(msg[len(prefix):]) msg = strings.TrimSpace(msg) } return "", errors.New(msg) } // 正常処理 return td.Text, nil // 構造体から変換後の文字列を取り出して返却 }難しいことは何もしておらず、一番シンプルな方法で HTTP リクエスト (POST) を投げているだけなんですが、以下の点は注意してくださいね。
- 上記コードの
@@script@@@
の箇所は、それぞれの GAS プロジェクトに合わせて修正する必要があります。- エラーが発生した際、メッセージのプレフィクス "Exception: " を取り除く処理を行っていますが、これは状況によっては不要な処理だと思います。
これ以外のコードについては、こちら をご覧ください。
6. go-tran の課題
現時点で以下のような課題がありますが、改善はそれほど難しくないと思います。
レスポンス・タイム
現在、サーバ側は GAS の無料プランを使っているということもあり、トラフィックが集中した際のアクセス制限でレスポンスが悪くなることが考えられます。
これについては、コマンドの config 設定でユーザ固有の URL を指定できるようにしようと考えています。そうすれば、利用者が自分の Google Account に GAS スクリプトを登録する負担は増えますが、それと引き換えに他人のことを気にせずにコマンドを使うことができるようになるはずです。バッチの出力形式
ログファイルやドキュメントを翻訳する場合はやはり原文と比較しながら見たいですよね。
これについては、変換元と変換先を行ごとに交互に出力するオプションを用意する予定です。おそらく対応は難しくないでしょう。7. おわりに
本稿では、Go 言語で翻訳ツール (TUI コマンド) を作ったという話と、そのコマンドの使い方を紹介しました。作り方についても簡単に紹介しました。また、既に似たツールが存在することを知り、最初はがっかりするも次第に自作コマンドも悪くないと思うようになったということを書きました。
GAS の翻訳 API は簡単に使える上に、皆に知れ渡っています。
最初は、そんな API を使ったプロダクトなんて特に面白いこともできないだろうと思っていましたが、実際に作ってみると意外にも便利なものを作ることができました(オレオレ仕様なのであたりまえなのですが…)。また自作してみることで、人気ツールのメリットとデメリットの両方が見えるようになりました。
世に知れ渡ったソリューションは星の数ほどあります。
でも今回の経験は、そういったものの中にも、
- コモディティ化したように見えるが、まだ誰も気づいていない使い道がある
- デファクトスタンダードになっているが、まだ誰も気づいていない改善点がある
そういったことを改めて認識する機会となりました。
それでは!
- 投稿日:2020-10-09T16:00:06+09:00
冷やかしで作った翻訳コマンド(TUI)が便利すぎるのでガチ使い!
GAS をラップした翻訳ツール (TUI command) を Go 言語で書きました。
- 【2020 年 10 月 12 日追記】
対象読者
以下に該当する方にとっては読む価値があるかもしれません。
- 英語(や他の外国語)が苦手で翻訳ツールが手放せない
- ターミナルで作業する時間が長い
- translate-shell よりシンプルで視認性の良いコマンドを探している
- GAS (Google Apps Script) に興味がある
- Golang (Go 言語) の TUI ツールの実装に興味がある
目次
1. はじめに
英語が苦手な僕は、ドキュメントを読むときも書くときも、辞書サイトや翻訳サイトが手放せません。
普段、ターミナルで作業をすることが多いんですが、Web ブラウザとターミナルソフトの間を行ったり来たりしているので、それはそれはストレスが溜まります。そんなある日、GAS (Google Apps Script) を触ったことがなかった僕は、後学のためにちょっと試してみようと思い、LanguageApp をラップしたお手軽翻訳コマンドを作ってみたんです。
最初は洒落で作り始めたつもりだったんですが、意外にもこれが便利に使えることがわかったので、記事にして紹介したいと思います。
コマンドは以下のリポジトリで公開しています。
類似するものに translate-shell というツールがあります。使っている方も多いと思いますが、本稿の後半で go-tran と translate-shell の違いについても触れています。
2. go-tran の概要
対応OS
Linux と Windows で動作確認しています。
(Mac でも動くと思います)対話型インターフェス
tran コマンドを引数なしで実行すると、対話型シェルが起動します。
翻訳する
デフォルトでは、実行環境のカレント・ロケールの言語へ翻訳されるので、あとは翻訳したい外国語を入力するだけです。
以下は、英語、フランス語、イタリア語、スペイン語、韓国語、中国語を日本語へ翻訳する例です。
上記画像ではプロンプトが:ja>
となっています。
これは(Source):(Target)>
の形式になっていて、変換元 (Source) の言語が自動 (Auto) で、変換先 (Target) の言語が日本語 (ja) という意味です。例えば、日本語から英語へ翻訳する場合はja:en>
と表示されます。言語を切り替える
変換先の言語を切り替えるには、2 桁の言語コード (ISO639-1) を入力します。
以下は、ターゲットの言語を切り替えながら、日本語を英語 (en)、フランス語 (fr)、イタリア語 (it)、スペイン語 (es)、韓国語 (ko)、中国語 (zh) へ翻訳する例です。
言語コードが分からない場合
言語コードが分からない場合は l (エル) コマンド (l: Language codes) で調べられます。
l コマンドは、入力した文字列が ISO639-1 コードと同じか、ISO 言語名称 (英名) に部分一致したものの一覧を表示します。どちらにも引っかからなかった場合は、内部で英語に変換してから再検索をかけるため、例えば日本語で入力した名称でも、目的の言語コードを比較的簡単に見つけることができます。
以下は「 l コマンドで "nor" を含むもの、"nese" を含むもの、"ドイツ語"、"クルド語"、"ズールー語" を検索し、その一覧は表示できたが、"カンブリア語" は見つからなかった」という例です。
バッチ・インターフェス
コマンドライン引数にファイル名を指定したり、コマンドの標準入力へパイプやリダイレクトで繋いだ場合はバッチ・コマンドとして実行されます。
ファイルの指定
引数にファイルのパス名を渡して go-tran を実行すると、そのファイルを翻訳してくれます。これも変換先の言語(デフォルト値)は実行環境のカレント・ロケールにより決まります。
パイプやリダイレクト
標準入力がターミナルではない場合、go-tran はバッチモードで実行されます。
例えば、僕の Ubuntu 環境は man が日本語で表示されるようになっているのですが、日本語のマニュアルが用意されていないコマンドもあります。普段あまり使わないコマンドほど日本語化されていなかったりしますよね。これまでは、知らない英単語に出くわしたときはわざわざ Web ブラウザを開いて調べていました。
でもこれからは man を go-tran にリダイレクトするだけで済みます。
3. go-tran の使い方
インストール
Go の環境がある場合
install go-tran$ go get -u github.com/y-bash/go-tran $ cd $GOPATH/src/github.com/y-bash/go-tran $ go install ./...Go の環境がなく、ソースコードのみ取得する場合
get source code$ git clone https://github.com/y-bash/go-tran.git
もし、Go の環境はないけどバイナリを使ってみたいという方がいたら、方法を考えますので、気軽に声をかけてくださいね。
対話型で使う
起動する
実行ファイルは tran という名前です。
$ tran Welcome to the GO-TRAN! ...
コマンドの説明
入力した文字は概ね以下のように判断されます。
文字列 説明 1 文字 コマンドとして判断。 2 文字 Target 言語の切り替え。 3 文字以上 入力したテキストを現在のモードに従って翻訳。 コマンドの種類は以下のとおりです。
コマンド 説明 例 h ヘルプを表示します。 l [str] 言語コードと名称の一覧を表示します。
(言語コードは ISO639-1)
- str を指定した場合
マッチする言語コードの一覧を表示- str を省略した場合
すべてのコード (184 件) を表示
- コード、名称に "en" を含むもの
l en
- 名称に "nor" を含むもの
l nor
- 名称に英名 "Welsh" を含むもの
l ウェールズ語
s [str] 変換元の言語 (Source) を切り替えます。
- str を指定した場合
マッチする言語へ切り替え- str を省略した場合
Auto (自動モード)へ切り替え
※通常は Auto で問題なし
- 英語へ
s en
- スペイン語へ
s spanish
- ポルトガル語へ
s ポルトガル語
- Auto(自動モード) へ
s
[t] code
t [str]変換先の言語 (Target) を切り替えます。
- t を省略した場合
2 桁のコード (ISO639-1) で
指定した言語へ切り替え- t の後に str を指定した場合
マッチする言語へ切り替え- t の後の str を省略した場合
実行環境のカレント・ロケール
へ切り替え
- カレント・ロケールへ
t
- 英語へ
t en
- ラテン語へ
t ラテン語
- C 言語へ
c
q 終了 キー操作
主なキーバインドは以下のとおりです。
(bash 互換です)カーソル移動
キー 説明 代替キー Ctrl-a 行頭へ移動 Home Ctrl-e 行末へ移動 End Ctrl-b 1文字後退 ← Ctrl-f 1文字前進 → 文字削除
キー 説明 代替キー Ctrl-h カーソル位置の手前の文字を削除 Back
spaceCtrl-d カーソル位置の文字を削除 Delete Ctrl-k カーソル位置から行末まで削除 Ctrl-u 行頭からカーソル位置の手前まで削除 履歴操作
入力したコマンドやテキストはヒストリに保存されるので、キー操作でそれを辿ることができます。
キー 説明 代替キー Ctrl-p 入力履歴を遡る ↑ Ctrl-n 入力履歴を進む ↓ Ctrl-r 入力履歴のインクリメンタルサーチ バッチコマンドとして使う
書式
コマンドの書式は以下のとおりです。
formattran [options] [path...]オプション
【2020 年 10 月 12 日】-a オプションと -e オプションを追記
オプションは以下のとおりです。
option 説明 例 -a ユーザの GAS プロジェクトに登録する
スクリプトを表示します。登録した
スクリプトの URL を設定ファイルに
記載することで自分専用の API サーバを
呼び出すことができます。
このオプションはバッチモード専用です。$ tran -a
-e 原文と翻訳文を 1 行ごとに交互に出力します。
このオプションはバッチモード専用です。```$tran -e english.txt -h ヘルプを表示します。
このオプションはバッチモード専用です。$ tran -h
-l 言語コードと名称の一覧 (184件) を表示します。
(言語コードは ISO639-1)
このオプションはバッチモード専用です。$ tran -l
-s code 変換元の言語 (Source) を
言語コード(ISO639-1)で指定します。
省略した場合は自動判別。$ tran -s en
-t code 変換先の言語 (Target) を
言語コード(ISO639-1)で指定します。
省略した場合はカレント・ロケールへ変換。$ tran -t en
パス
path の指定方法は以下のとおりです。
path 説明 例 指定 指定したファイルを翻訳して標準出力へ出力します。 $ tran a.txt b.txt
省略
- 標準入力がターミナルの場合
対話型で起動- 標準入力がパイプやリダイレクトの場合
翻訳した結果を標準出力へ出力
- ss コマンドの man を翻訳
$ man ss|tran|less
- Go のコンパイルエラーを翻訳
$ go build . 2>&1|tran
- ファイルをリダイレクト
$ tran < a.txt
※セル内の "|" は全角文字です。
コピペの際はご注意ください。使用例
難しい英単語を取り急ぎ確認
$ echo "penpineappleapplepen" | tran ペンパイナッポーアップルペン日本語のファイルを英語にする
$ tran -t en Japanese.txt this is a pen.日本語のファイルをラテン語にして保存
$ tran -t la Japanese.txt > Latin.txt自動翻訳の結果を日本語に還元して、しっくりくるか確認
$ echo "僕はりんごが大好きです" | tran -t en | tran りんごが大好きstrings.Builder (Golang) のソースコードの全コメント行を日本語にする
$ grep '^\s*//' ./builder.go | sed -e 's/^\s*..\s*//' | tran Copyright 2017 The GoAuthors。全著作権所有。 このソースコードの使用は、BSDスタイルによって管理されています LICENSEファイルにあるライセンス。 Builderは、Writeメソッドを使用して文字列を効率的に構築するために使用されます。 ...カレントディレクトリ配下の全ログファイルのエラー行を日本語にする
$ find . -name '*.log' | xargs grep 'error:' | tran ./tool/vim/src/auto/config.log:conftest.c:154:12:エラー: 'GETACLCNT'が宣言されていません(この関数での最初の使用) ./tool/vim/src/auto/config.log:conftest.c:154:26:エラー: 'NULL'が宣言されていません(この関数での最初の使用) ...設定ファイル【2020 年 10 月 12 日追記】
Version 1.0.1 でサポートした設定ファイルの使い方について説明します。
設定ファイルのパス
設定ファイルのパスは以下のとおりです。
(OS により異なります)
OS パス POSIX $HOME/.config/y-bash/config.toml Windows %AppData%\y-bash\tran\config.toml 設定できる項目
テーブル キー 説明 初期値 [default] source 変換元の言語コード (ISO639-1) のデフォルト値。 "" [default] target 変換先の言語コード (ISO639-1) のデフォルト値。 初回起動時のカレント・ロケール。 [api] endpoint GAS (Google Apps Script) プロジェクトの URI。ユーザが作成した GAS プロジェクトの URI を設定することにより自分専用の API サーバを指定できる。なお、GAS に設定するスクリプトは -a オプションで表示可能。
【例】 tran -aこれまでどおり。 [api] limit_n_chars 1 度の API コールで送信する文字数の最大値。変換元テキストの文字数がこの値を超える場合、API は複数回に分けてコールされる。 4000 [colors] info インフォメーションメッセージの文字色 "#80a0d0" [colors] info ステータス変更メッセージの文字色 "#60c060" [colors] error エラーメッセージの文字色 "#d04040" [colors] result 変換されたテキストの文字色 "#ffc864" 4. translate-shell との比較
実は僕が translate-shell のことを知ったのは、 go-tran を作り始めた後でした。
機能もほとんど似ており、コマンド名も同じtrans
だったので驚きました。
(最初は go-trans という名前だったんです)しかも、translate-shell は品詞などの付加情報を表示してくれたり、単語に複数の意味がある場合はそれを表示してくれたりと高機能です。
でも、少し使ってみると、go-tran には go-tran の良さがあることが次第にわかってきました。
translate-shell のメリット
translate-shell は、翻訳結果だけでなく以下のような付加情報も表示してくれます。
- 変換元の言語
- 変換先の言語
- 品詞(単語の場合)
- 複数の意味(単語の場合)
辞書のように使えるため、英作文などでは使い勝手が良いかもしれませんね。
とはいってもがっつり英文ドキュメントを書かなければならない場合はもっとしっかりした辞書が必要になると思います。go-tran のメリット
translate-shell に対する go-tran のアドバンテージは以下のとおりです。
- シンプル
余計な情報を出力しないため見やすいです。
品詞などの付加情報は時として邪魔になります。- カラー表示
カラー表示なので、見たい箇所を瞬時に判別できます。- 言語コードの検索機能
go-tran なら言語コードを簡単に見つけられます。
translate-shell では言語コードを記憶しておくか、ドキュメントを見なければならないでしょう。- bash ライクなキーバインド
go-tran は文字編集がしやすいです。
translate-shell は標準入力を単に読み取っているだけのようで、文字編集に難があります。- ヒストリ機能
go-tran は前に入力したコマンドやテキストを再表示し、それを編集して実行することができます。
これも translate-shell にはない機能です。- Windows ネイティブ対応
go-tran は Windows のコマンドプロンプトで実行できます。
translate-shell では Cygwin などの UNIX 互換環境が必要なようです。5. 作り方は簡単
GAS (Google Apps Script) で作る Web API も、Go で作るクライアントもとても簡単です。
GAS で Web API を作る
tanabee さんの大人気記事を参考にさせていただきました。
参考にさせていただいたコードに、以下の処理を追記しています。
- json で返却
- GET/POST に対応
- 例外処理
- 例外メッセージを英語で出力
コードは以下のとおりです。
Translate.gs// 共通処理 // param e イベント function process(e) { let body // レスポンスボディ try { const p = e.parameter // リクエスト・パラメータ const s = LanguageApp.translate(p.text, p.source, p.target) // 翻訳 body = {code: 200, text: s} // レスポンス・ボディの作成 } catch (e) { // param e 例外 // 翻訳に失敗した try { const msg = LanguageApp.translate(e.toString(), "", "en") // エラーメッセージを英語へ body = {code: 400, message: msg} // レスポンス・ボディの作成 } catch (e) { // param e 例外 // これに失敗するということは内部エラー body = {code: 500, message: e.toString()} // レスポンス・ボディの作成 } } let resp = ContentService.createTextOutput() // レスポンス resp.setMimeType(ContentService.MimeType.JSON) // MIME タイプを JSON 形式にして resp.setContent(JSON.stringify(body)) // レスポンス・ボディを JSON 形式の文字列に変換 return resp; // レスポンスを返却 } // GET // param e イベント function doGet(e) { return process(e) // 共通処理の呼び出し } // POST // param e イベント function doPost(e) { return process(e) // 共通処理の呼び出し }上記コードで process(e) と 2 つの catch(e) で同名の変数を使っているのが気になる方は変数名を変更してください。
なお、スクリプトを修正した後に Project version を New にしないとプロダクトに反映されないということを知らなかったため、これで 20 分くらい悩みました。
Go でクライアントを作る
GAS で作った Web API をラップするクライアント側の関数(Go 言語)のは以下のとおりです。
tran.gopackage tran import ( "encoding/json" "errors" "io/ioutil" "net/http" "net/url" "strings" ) const gURL = "https://script.google.com/macros/s/@@script@@/exec" // @@script@@ 要修正 // レスポンスの JSON をマップする構造体 type TransData struct { Code int `json:"code"` // レスポンス・ステータス Text string `json:"text"` // 翻訳結果 Message string `json:"message"` // エラーメッセージ } // 翻訳 func Translate(text, source, target string) (string, error) { // パラメータの作成 v := url.Values{} v.Add("text", text) // 変換元の文字列 v.Add("srouce", source) // 変換元の言語 (ISO639-1) v.Add("target", target) // 変換先の言語 (ISO639-1) // 翻訳 API へ POST でリクエスト resp, err := http.PostForm(gURL, v) if resp != nil { defer resp.Body.Close() } if err != nil { return "", err } // レスポンス・ボディをバッファへ読み込む buf, err := ioutil.ReadAll(resp.Body) if err != nil { return "", err } // レスポンス・ボディ (JSON 形式) を構造体へマップ var td TransData if err := json.Unmarshal(buf, &td); err != nil { return "", err } // レスポンス・ステータスの検査 if td.Code != 200 { // エラー処理 (プレフィクスの "Exception: " を取り除く) msg := td.Message prefix := "exception:" if strings.HasPrefix(strings.ToLower(msg), prefix) { msg = string(msg[len(prefix):]) msg = strings.TrimSpace(msg) } return "", errors.New(msg) } // 正常処理 return td.Text, nil // 構造体から変換後の文字列を取り出して返却 }難しいことは何もしておらず、一番シンプルな方法で HTTP リクエスト (POST) を投げているだけなんですが、以下の点は注意してくださいね。
- 上記コードの
@@script@@@
の箇所は、それぞれの GAS プロジェクトに合わせて修正する必要があります。- エラーが発生した際、メッセージのプレフィクス "Exception: " を取り除く処理を行っていますが、これは状況によっては不要な処理だと思います。
これ以外のコードについては、こちら をご覧ください。
6. go-tran の課題
現時点で以下のような課題がありますが、改善はそれほど難しくないと思います。
レスポンス・タイム
現在、サーバ側は GAS の無料プランを使っているということもあり、トラフィックが集中した際のアクセス制限でレスポンスが悪くなることが考えられます。
これについては、コマンドの config 設定でユーザ固有の URL を指定できるようにしようと考えています。そうすれば、利用者が自分の Google Account に GAS スクリプトを登録する負担は増えますが、それと引き換えに他人のことを気にせずにコマンドを使うことができるようになるはずです。
【2020 年 10 月 12 日追記】
この問題は version 1.0.1 で解消されました。設定ファイルにユーザ専用の GAS プロジェクトの URI を設定することができます。詳細は こちら をご覧ください。バッチの出力形式
ログファイルやドキュメントを翻訳する場合はやはり原文と比較しながら見たいですよね。
これについては、原文と翻訳文を行ごとに交互に出力するオプションを用意する予定です。おそらく対応は難しくないでしょう。
【2020 年 10 月 12 日追記】
この問題は version 1.0.1 で解消されました。-e オプションをつけて実行することで原文と翻訳文を交互に出力できます。詳細は こちら をご覧ください。文字数制限
GAS の LanguageApp に 大量の文章を投入するとエラーが発生することがわかりました。これについては、API に 1 度に投入する文字数の最大値を config 設定できるようにし、大量の文章が投入された場合は分割して翻訳するようにプログラムを修正する予定です。
【2020 年 10 月 12 日追記】
この問題は version 1.0.1 で解消されました。設定ファイルの limit_n_chars (初期値は 4000)で設定できます。詳細は こちら をご覧ください。7. おわりに
本稿では、Go 言語で翻訳ツール (TUI コマンド) を作ったという話と、そのコマンドの使い方を紹介しました。作り方についても簡単に紹介しました。また、既に似たツールが存在することを知り、最初はがっかりするも次第に自作コマンドも悪くないと思うようになったということを書きました。
GAS の翻訳 API は簡単に使える上に、皆に知れ渡っています。
最初は、そんな API を使ったプロダクトなんて特に面白いこともできないだろうと思っていましたが、実際に作ってみると意外にも便利なものを作ることができました(オレオレ仕様なのであたりまえなのですが…)。また自作してみることで、人気ツールのメリットとデメリットの両方が見えるようになりました。
世に知れ渡ったソリューションは星の数ほどあります。
でも今回の経験は、そういったものの中にも、
- コモディティ化したように見えるが、まだ誰も気づいていない使い道がある
- デファクトスタンダードになっているが、まだ誰も気づいていない改善点がある
そういったことを改めて認識する機会となりました。
それでは!
- 投稿日:2020-10-09T00:10:06+09:00
【Go 1.13】unexpected directory layout:がでた時の対処
追記
コメントにて指摘いただきました。
go mod
コマンドを用いると、go mod init モジュール名
で指定したモジュールからインポートできることが確認できました。$ go mod init hoge ---main.go package main import "hoge/sample" | (省略) ---これで動くと思います。
Goにて開発をしていて、ファイルを用いてパッケージを分けようとしたら起きたエラー。
とりあえず解決したので、すぐさまメモ。。。環境
バージョン go version go1.13.14 linux/amd64 centos 7 ディレクトリ構造 ./ | |--sample/ | | | |--sample.go | |--main.go実際のコード
main.gopackage main import "./sample" func main() { a := sample.Foo("test") sample.PrintFoo(a) }sample.gopackage sample import "fmt" func Foo(s string) string { return "aaa " + s + " bbb" } func PrintFoo(s string) { fmt.Println(s) }[root@marny ---]# go build -o practice unexpected directory layout: import path: _/develop/go/src/test/marny/sample root: /develop/go/src dir: /develop/go/src/test/marny/sample expand root: /develop/go expand dir: /develop/go/src/test/marny/sample separator: /どういったエラーなのか
unexpected directory layout:
というエラーは、どうやらimportしているパッケージのパスの指定がダメですよーというエラーらしい。僕自身、centos7(vbox)にsambaでwindowsとつなげて編集していたので、ソースコード上でのエラーはありませんでした、、、、
解決
僕の場合、$GOPATHを
/develop/go
と指定しています。GOPATHの仕様で、binやらsrcやらを生成して、Goの開発をするのですが、ここでエラーが起きている。どうすれば解決するか、というと、main.goのimport
./sample
を$GOPATH/src
から見た相対パスに変更すれば、解決します。よって、
main.gopackage main import "test/marny/sample" func main() { a := sample.Foo("test") sample.PrintFoo(a) }これで、解決すると思います。
GOPATHめんどくさいね。