my_help 0.4.5 → 0.5.0

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis/thesis.lot

@@ -0,0 +1,5 @@
+\addvspace {10\p@ }
+\addvspace {10\p@ }
+\addvspace {10\p@ }
+\contentsline {table}{\numberline {3.1}{\ignorespaces optparse とThor の比較. \relax }}{12}{table.caption.3}
+\addvspace {10\p@ }

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis/thesis.out.ps

@@ -0,0 +1,98 @@
+%!
+/pdfmark where{pop}
+{/globaldict where{pop globaldict}{userdict}ifelse/pdfmark/cleartomark load put}
+ifelse
+[
+/Title(�^^[)
+/Count -1
+/Action/GoTo/Dest(chapter.1)cvn
+/OUT pdfmark
+[
+/Title(�)
+/Action/GoTo/Dest(section.1.1)cvn
+/OUT pdfmark
+[
+/Title(^^L�^^@)
+/Count -2
+/Action/GoTo/Dest(chapter.2)cvn
+/OUT pdfmark
+[
+/Title(my\137help)
+/Count -2
+/Action/GoTo/Dest(section.2.1)cvn
+/OUT pdfmark
+[
+/Title(my\137help�^^a0)
+/Action/GoTo/Dest(subsection.2.1.1)cvn
+/OUT pdfmark
+[
+/Title(^^81^^P)
+/Action/GoTo/Dest(subsection.2.1.2)cvn
+/OUT pdfmark
+[
+/Title(option)
+/Count -2
+/Action/GoTo/Dest(section.2.2)cvn
+/OUT pdfmark
+[
+/Title(option�^^@)
+/Action/GoTo/Dest(subsection.2.2.1)cvn
+/OUT pdfmark
+[
+/Title(Command Line Interface)
+/Action/GoTo/Dest(subsection.2.2.2)cvn
+/OUT pdfmark
+[
+/Title(f&)
+/Count -8
+/Action/GoTo/Dest(chapter.3)cvn
+/OUT pdfmark
+[
+/Title(optparse^^85F^^86�.c)
+/Count -3
+/Action/GoTo/Dest(section.3.1)cvn
+/OUT pdfmark
+[
+/Title(optparse)
+/Action/GoTo/Dest(subsection.3.1.1)cvn
+/OUT pdfmark
+[
+/Title(Thor)
+/Action/GoTo/Dest(subsection.3.1.2)cvn
+/OUT pdfmark
+[
+/Title(c)
+/Action/GoTo/Dest(subsection.3.1.3)cvn
+/OUT pdfmark
+[
+/Title(Thor枡^^]^^98♀�^^8b)
+/Action/GoTo/Dest(section.3.2)cvn
+/OUT pdfmark
+[
+/Title(Thor元c�^^90)
+/Action/GoTo/Dest(section.3.3)cvn
+/OUT pdfmark
+[
+/Title(exes�^^8a痊^^80)
+/Action/GoTo/Dest(section.3.4)cvn
+/OUT pdfmark
+[
+/Title(libs�^^8a)
+/Action/GoTo/Dest(section.3.5)cvn
+/OUT pdfmark
+[
+/Title(溯ws)
+/Action/GoTo/Dest(section.3.6)cvn
+/OUT pdfmark
+[
+/Title(^^Y^�w0)
+/Action/GoTo/Dest(section.3.7)cvn
+/OUT pdfmark
+[
+/Title(>9�^^H�)
+/Action/GoTo/Dest(section.3.8)cvn
+/OUT pdfmark
+[
+/Title(�)
+/Action/GoTo/Dest(chapter.4)cvn
+/OUT pdfmark

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis/thesis.tex

@@ -0,0 +1,30 @@
+\documentclass[12pt,a4]{jreport}%chapterが使えるスタイル
+
+%setting format and calling packages
+\input{../thesis_pieces/usepackage}% pieces
+\input{../thesis_pieces/form00_style}% pieces
+\input{../thesis_pieces/tightlist_setting}% pieces
+%参考文献の設定============================================================
+\renewcommand{\bibname}{参考文献}
+
+%表紙=====================================================================
+\input{../split_files/informations/informations}
+
+%目次=====================================================================
+\tableofcontents
+
+% 表目次の表示==============================================================
+\listoftables
+
+% 図目次の表示==============================================================
+%\listoffigures
+
+%本文======================================================================
+\input{./.splits_location.tex}
+
+%参考文献===================================================================
+%\begin{thebibliography}{9}
+%\bibitem{}
+%\end{thebibliography}
+
+\end{document}

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis/thesis.toc

@@ -0,0 +1,22 @@
+\contentsline {chapter}{\numberline {第1章}はじめに}{3}{chapter.1}
+\contentsline {section}{\numberline {1.1}目的}{3}{section.1.1}
+\contentsline {chapter}{\numberline {第2章}基本的事項}{4}{chapter.2}
+\contentsline {section}{\numberline {2.1}my\_help}{4}{section.2.1}
+\contentsline {subsection}{\numberline {2.1.1}my\_helpの目的}{4}{subsection.2.1.1}
+\contentsline {subsection}{\numberline {2.1.2}使用法}{5}{subsection.2.1.2}
+\contentsline {section}{\numberline {2.2}option}{6}{section.2.2}
+\contentsline {subsection}{\numberline {2.2.1}optionの種類}{6}{subsection.2.2.1}
+\contentsline {subsection}{\numberline {2.2.2}Command Line Interface}{8}{subsection.2.2.2}
+\contentsline {chapter}{\numberline {第3章}研究内容}{9}{chapter.3}
+\contentsline {section}{\numberline {3.1}optparseとThorの比較}{9}{section.3.1}
+\contentsline {subsection}{\numberline {3.1.1}optparse}{9}{subsection.3.1.1}
+\contentsline {subsection}{\numberline {3.1.2}Thor}{10}{subsection.3.1.2}
+\contentsline {subsection}{\numberline {3.1.3}比較}{12}{subsection.3.1.3}
+\contentsline {section}{\numberline {3.2}Thor化に伴う書き換え（具体的な作業）}{14}{section.3.2}
+\contentsline {section}{\numberline {3.3}Thorによるサブコマンド}{14}{section.3.3}
+\contentsline {section}{\numberline {3.4}exeディレクトリの書き換え}{15}{section.3.4}
+\contentsline {section}{\numberline {3.5}libディレクトリ}{16}{section.3.5}
+\contentsline {section}{\numberline {3.6}その他オプション}{16}{section.3.6}
+\contentsline {section}{\numberline {3.7}変更後のオプション}{18}{section.3.7}
+\contentsline {section}{\numberline {3.8}コマンドの自動生成}{19}{section.3.8}
+\contentsline {chapter}{\numberline {第4章}総括}{21}{chapter.4}

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis_pieces/form00_style.tex

@@ -0,0 +1,25 @@
+%スタイル，パッケージの設定
+\usepackage[dvipdfmx]{graphicx}%図の挿入のためのパッケージ
+\usepackage{amsmath}
+\usepackage{setspace}
+\usepackage{amssymb}
+\usepackage{ascmac}
+\usepackage{framed}
+\usepackage{wrapfig}
+\usepackage{graphicx}
+\usepackage{lineno}
+
+%余白の設定
+\setlength{\textheight}{\paperheight}
+\setlength{\topmargin}{4.6truemm}
+\addtolength{\topmargin}{-\headheight}
+\addtolength{\topmargin}{-\headsep}
+\addtolength{\textheight}{-60truemm}
+\setlength{\textwidth}{\paperwidth}
+\setlength{\oddsidemargin}{-0.4truemm}
+\setlength{\evensidemargin}{-0.4truemm}
+\addtolength{\textwidth}{-50truemm}
+
+%行間
+\setstretch{1.4}
+

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis_pieces/tightlist_setting.tex

@@ -0,0 +1,2 @@
+%\tightlistの定義（箇条書きの際に必要）
+\def\tightlist{\itemsep1pt\parskip0pt\parsep0pt}

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/thesis_pieces/usepackage.tex

@@ -0,0 +1,25 @@
+%スタイル，パッケージの設定
+\usepackage[hyphens]{url}
+\usepackage[dvipdfmx]{graphicx}%図の挿入のためのパッケージ
+\usepackage{amsmath}
+\usepackage{setspace}
+\usepackage{amssymb}
+\usepackage{ascmac}
+\usepackage{framed}
+\usepackage{wrapfig}
+\usepackage{graphicx}
+\usepackage[subrefformat=parens]{subcaption}
+\usepackage{amsmath,amssymb}
+\usepackage{comment}
+\usepackage{lineno}
+\usepackage{here}
+\usepackage{ulem}
+\usepackage{bbm}
+\usepackage{braket}
+\usepackage{amsmath}
+\usepackage{mathtools}
+\usepackage{bookmark}
+\usepackage{framed}
+\usepackage{soul}
+\usepackage{longtable}
+\usepackage{booktabs}

data/docs/yagi/bachelor_thesis/translation/awesome_chapter2.ipynb

@@ -0,0 +1,84 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# CHAPTER 2 Be Easy to Use"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true
+   },
+   "source": [
+    "あなたのアプリをインストールした後、それを用いたユーザーが最初に体験するのは実際のコマンドラインインターフェイスでしょう。もしそのインターフェイスが難しく、直感的でなく、もしくは、とても、醜いならば、たくさんの自信を呼び起こすことはできないし、ユーザーはそれを使って明確で簡潔な目的を達成するのに苦労するでしょう。逆に、使いやすければ、あなたのインターフェイスはアプリケーションに観衆と鋭さを与えてくれるでしょう。\n",
+    "\n",
+    "幸運なことに、適切な道具と技術を知っていれば、コマンドラインインターフェイスの正確さを手に入れるのは簡単です。UNIXのコマンドラインは長く物語として名高い歴史を持っており、今やコマンドラインアプリを発動する方法についてのたくさんの慣例や慣用法があります。もしあなたのアプリがこれらの慣例に従うなら、ユーザーはより簡単な時間でそれを使えるでしょう。非常に複雑なアプリでさえ、簡潔で覚えやすいインターフェイスを持つことができると私たちはわかるでしょう。\n",
+    "\n",
+    "この章では、単純なバックアップスクリプトでも複雑なコマンドライン管理システムでも、型にはまった慣用的なコマンドラインインターフェイスの作成を信じられないほど簡単にする標準ライブラリとオープンソースコミュニティツールの使い方を学びます。私たちは、RubyのOptionParserクラスを用いたシンプルなコマンドラインインターフェイスの作り方を学びます。それから、オープンソースGLIライブラリを用いて組み立てる、もっと洗練されたコマンドスイートアプリケーションに取り組みます。しかし初めに、典型的なコマンドラインインターフェイスの要素の適切な名前に慣れる必要があります。コマンドラインインターフェイスのオプション、引数、そしてコマンドなどです。\n",
+    "\n",
+    "コマンドラインアプリケーションに動作の仕方を教えるとき、普通は、実行可能ファイルの名前以上のものを入力する必要があります。例えば、私たちはgrepにどのファイルを探して欲しいのか言わなければなりません。私たちが前の章で紹介したデータベースバックアップアプリ、db_backup.rbは動作するためにユーザーネームとパスワードとデータベースネームを必要とします。必要な情報をアプリに与える初期の方法は、図１、コマンドラインアプリ実行の基本的なパーツ、１４ページ、に描いてあるようにオプション経由か引数かです。この形式はオペレーティングシステムによって課されるのではなく、コマンドラインアプリのGNUスタンダードに基づいているということに留意してください。構文解析できたり、オプションや引数の受け入れができたりするコマンドラインインターフェイスの作り方を学ぶ前に、慣用語や慣習を少し深く調べる必要があります。オプションから始めて引数へと移っていきます。その後に、コマンドスイートの際立った特色であるコマンドについて議論していきましょう．\n",
+    "\n",
+    "オプションは，ユーザーがアプリの振る舞いを変更する方法です．ここで見せるlsの２つの発動を考えてみましょう．まず最初に，オプションを省いてデフォルトの振る舞いを見てみます．次に，リスティングフォーマットを変更するために-lのオプションを使います．\n",
+    "\n",
+    "オプションにはロングとショートの２つの形式があります．\n",
+    "\n",
+    "ショートフォームオプション　ショートフォームオプションはダッシュを先行させた１文字，例えば-lのような形です．ショートフォームオプションは次の例のように，シングルダッシュの後に結びつけることもできます．例えば，次の２行のコードは確かに同じ結果を引き起こします．\n",
+    "\n",
+    "ロングフォームオプション　ロングフォームオプションは２つのダッシュを先行させ，厳密に言うと２つ以上の文字で構成されています．しかし，ロングフォームオプションは普通，完全な単語（もしくはダッシュによって分けられた幾つかの単語）です．この理由は，オプションの意味を明確にするためです，ショートフォームオプションでは，１文字はよく記憶の手助けになります．ロングフォームオプションでは，そのオプションが何をするのかを表す単語にするという慣習があります．例えば，コマンドcurl —basic http://www.google.comでは，—basicは１つのロングフォームオプションです．ショートオプションとは違い，ロングオプションはつなげることができません．それぞれがコマンドライン上のスペースで区切られて，別々で入力されなければなりません．\n",
+    "\n",
+    "コマンドラインオプションは２つのタイプのうち１つにすることができます．スイッチはオプションを付けたり消したりするのに使われ，引数を受け取りませんでした．フラッグは，図２，スイッチとフラッグによるコマンドラインの発動，ページ１５のように引数を受け取ります．フラッグは決まって引数を要求しますが，厳密に言えば，そうする必要はありません．ただ引数を受け入れる必要があります．カジュアルなユーザーを喜ばせる，７１ページで，これについてさらにお話しします．\n",
+    "\n",
+    "一般的に，もしスイッチがロングフォームで（例えば—foo），いくつかの振る舞いをオンにするものならば，その振る舞いをオフにするno-が前に置かれたもう一つのスイッチもある（例えば—no-foo）．\n",
+    "\n",
+    "最後に，イコールによって引数を受け取るロングフォームのフラッグもあれば，一般的にイコールを使わないショートフォームのフラッグもあります．例えばHTTPを要求するcrulコマンドはHTTPリクエストメソッドを明示するためのショートフォームフラッグもロングフォームフラッグも提供します．-Xと—requestがそれぞれそうです．次の実行例はフラッグへの引数の適切な渡し方を教えてくれます．\n",
+    "\n",
+    "いくつかのアプリはロングフォームフラッグと引数の間でイコールを要求しないとは言え，あなたのアプリはいつもイコールを受け入れるべきで，なぜならこれは引数をフラッグに与える慣用的な方法だからです．私たちはこの章の後半でRubyによって提供されるツールとそのオープンソースエコシステムがこの慣習に従うのを保証しやすくすることがわかるでしょう．"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Ruby 2.3.3",
+   "language": "ruby",
+   "name": "ruby"
+  },
+  "language_info": {
+   "file_extension": ".rb",
+   "mimetype": "application/x-ruby",
+   "name": "ruby",
+   "version": "2.3.3"
+  },
+  "latex_envs": {
+   "LaTeX_envs_menu_present": true,
+   "autocomplete": true,
+   "bibliofile": "biblio.bib",
+   "cite_by": "apalike",
+   "current_citInitial": 1,
+   "eqLabelWithNumbers": true,
+   "eqNumInitial": 1,
+   "hotkeys": {
+    "equation": "Ctrl-E",
+    "itemize": "Ctrl-I"
+   },
+   "labels_anchors": false,
+   "latex_user_defs": false,
+   "report_style_numbering": false,
+   "user_envs_cfg": false
+  },
+  "toc": {
+   "nav_menu": {},
+   "number_sections": true,
+   "sideBar": true,
+   "skip_h1_title": false,
+   "toc_cell": false,
+   "toc_position": {},
+   "toc_section_display": "block",
+   "toc_window_display": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

data/docs/yagi/bachelor_thesis/translation/awesome_introduction.ipynb

@@ -0,0 +1,328 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Build Awesome Command Line Applications in Ruby"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## introduction\n",
+    "\n",
+    "グラフィカルユーザーインターフェース(GUI)はいろんな点で素晴らしいものです．\n",
+    "冷たくまたたくカーソルの殺伐とした輝きよりも，\n",
+    "GUIはとりわけ初心者にとても優しいものです．\n",
+    "でも，それには犠牲が伴います．GUIの熟練者になるには，奥義のようなキーボードショートカットを学ぶ必要があります．\n",
+    "そうだとしても，あなたは生産性と効率の限界にぶち当たります．\n",
+    "GUIはスクリプトして自動化しにくいことで悪名高いし，それができたとしても，あなたのスクリプトは移植しにくい傾向にあります．\n",
+    "\n",
+    "でも，これらすべては問題から外れています．私たちはソフトウェア開発者であり，プログラムを書いています．我々が仕事を終わらせるのに，コードを使うことよりも自然なものがあるでしょうか．次のコマンドシーケンスで考えてみましょう．\n",
+    "```bash\n",
+    "> cd ~/Projects/cli\n",
+    "> vi chapter2.md\n",
+    "```\n",
+    "あなたはこの２つのコマンドを曖昧だと感じるかもしれませんが，これらはファイルを編集するとても効果的な方法です．\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "私のキャリアの大半では，コマンドラインというとbashのようなUNIXシェルを意味していました． \n",
+    "bashシェルはいくつかの基本的な組み込みコマンドを提供してくれます．\n",
+    "さらには，UNIXシステムに同封されている他の基本的な（もしくは基本的ではない）コマンドへもアクセス可能にしてくれます．\n",
+    "これらのコマンドは単一目標のものであり，ユーザーとの相互作用を必要としません．\n",
+    "だけど，使いやすい（けど覚えにくい）ユーザーインターフェイスを伴っています．\n",
+    "これらの特性によって，無限に近い方法で，それらをつなぎ合わせることができます．\n",
+    "洗練された振る舞いの自動化，複雑な解析の実行，そして無数のテキストファイルの構文解析を，簡単にしかも間にあわせで可能にしてくれます．\n",
+    "これは私のキャリアの初期の頃の人生そのものでした．\n",
+    "そしてそれは良いものでした．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "1990年代半ば，Javaが人気になるに連れて，UNIXコマンドラインユーティリティーをつなぎ合わせて何かをするというアイデアは古代のものと見られるようになってしまいました．\n",
+    "Javaのプログラムはシンプルなテキストベースの形を避けて，RPCによって動かされるXMLの複雑な階層構造を使ったファイルベースのインプットアウトプット（I/O）やHTTP I/Oを推奨しました．\n",
+    "これのおかげでとても洗練されたシステムの構築が可能となりました．\n",
+    "これらのシステムを組み立てたり設定したりする複雑さを抽象化するGUIの道具が飛び出してきました．\n",
+    "コードを書いたり組み立てたりするという行為でさえ，もっと複雑な統合開発環境（IDEs）に飲み込まれてしまいました．\n",
+    "コマンドラインの単純さは道に迷い始めました．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "問題は，これらのツールがモデルに適していないタスクがたくさんあることです．シェルに移動して仕事を終えるのはとてつもなく簡単なんだけど．．．なので，私はIDEsや洗練されたGUIツールはコマンドラインの進歩であるという考えに賛成したことはありませんが，生活の事実と仲良くして，快適なパターンに住み着きました．Javaは「本当の」コードで，コマンドラインは（PerlやRubyも同様に）自動化したり，一度限りのスクリプトだったり，繰り返しのなんかを早く終わらせることを助けてくれる他のいろんなことのためのものでした．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "2000年代半ば，私はRuby，Rails，素晴らしいコミュニティがそれらのツールのまわりで築き上げられていたことに気づき始めました．驚くべきことに（そして嬉しいことに），ほとんど全てのことはコマンドラインで動かせたのです．Rubyのような動的言語はIDEsにうまく適応できません（IDEはそのような言語を理解できないと議論する人もいました）．そして発芽しつつある開発者のコミュニティは，一流のツール製作者のレーダーには写りませんでした．そのコミュニティはコマンドラインを取り入れ，全てをコマンドラインアプリケーションで作りました．Perlはこれを何年もしていましたが，「ポストJava」世界でのコマンドラインへの強い信奉にこの時私は初めて気づきました．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "もっと面白かったことは，これらのコマンドラインアプリの中に好みや磨きが入っていることです．ほとんどの機能はコマンドベースの機能ナビゲーションを備えた本格的なヘルプシステムを特色としていましたが，単純さと相互運用性という \"UNIXの方法\"には依然として忠実なままでした．gemを例にあげてみます．次の例はあなたのシステムに他のRubyのアプリケーションとライブラリをインストールするコマンドです．\n",
+    "\n",
+    "```\n",
+    ">$ gem help\n",
+    ">RubyGems is a sophisticated package manager for Ruby. This >\n",
+    "is a basic help message containing pointers to more information.\n",
+    "\n",
+    "> Usage:\n",
+    ">    gem -h/--help\n",
+    ">    gem -v/--version\n",
+    ">    gem command [arguments...] [options...]\n",
+    ">Examples:\n",
+    ">    gem install rake\n",
+    ">    gem list --local\n",
+    ">    gem build package.gemspec\n",
+    ">    gem help install\n",
+    ">Further help:\n",
+    ">    gem help commands          list all 'gem' commands\n",
+    ">    gem help examples          show some examples of usage\n",
+    ">    gem help platforms         show information about platforms\n",
+    ">    gem help <COMMAND>           show help on COMMAND\n",
+    ">                             (e.g. 'gem help install')\n",
+    ">gem server                   present a web page at\n",
+    ">                             http://localhost:8808/\n",
+    ">                             with info about installed gems\n",
+    ">  Further information:\n",
+    ">    http://rubygems.rubyforge.org\n",
+    "```"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "これは利用可能な完全なドキュメントのほんの小さな部分に過ぎず，全てそこにあるものです，コマンドラインのすぐ近くです．このツールを洗練されたものにするためにたくさんの考えが用いられていることは明らかです．これは一度限りのハッカーっぽいスクリプトではありません．Ruby on Railsの設計理念と同じように，プログラマーに対してのユーザー体験に\n",
+    "に与えられた明確な配慮でした．\n",
+    "これらのツールは誰かが寄せ集めた一度限りのスクリプトではなく，「本当の」仕事のために作られました．\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "これが私に教えてくれたことは，コマンドラインはJavaツールの業者が私たちに信じさせたような時代遅れのものなどではないということです．それはここにあります．開発の未来は，ボタンやツールバーを操作したり，アイコンをドラッグアンドドロップしてコードを作成するだけでなくなるでしょう．コマンドラインインターフェイス固有の能率，生産性というのはいつも良い開発者の道具箱の中にあるでしょう．彼らのコマンドラインツールから使いやすさや洗練を追い求める開発者もいれば，それを届けることに興味を持つ開発者もいます！"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "これがこの本の内容です．素晴らしいコマンドラインアプリケーションを届けること（そしてRubyでそれをするのがどれほど簡単かということ）．コマンドラインインターフェイスのポテンシャルを解放したいプログラマーや，簡単に理解できて使用できる実際のユーザーインターフェイスを備えた洗練された堅牢なアプリケーションを作りたいプログラマーのために．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true
+   },
+   "source": [
+    "### この本がどのように構成されているか\n",
+    "\n",
+    "次の10章の中で，私たちは，ユーザー入力，プログラム出力，コード構成からエラー処理，テスト，配布までコマンドラインアプリケーション開発の全ての詳細について議論します．２つの模範アプリケーションを組み立てたりより良くしたりすることでこれについて学びます．この本を通して，私たちは素晴らしいコマンドラインアプリケーションとは何かを学ぶためにだんだんそれらを良くしていきます．Rubyの素晴らしい構文と特徴，さらにはいくつかのオープンソースライブラリのおかげで，Rubyがそれをしやすくしてくれることがわかるでしょう．\n",
+    "\n",
+    "私たちが最初に学ぶことはー第１章，明確で簡潔な目的を持って，１ページーアプリケーションのコマンドラインに適したアプリケーションの種類です．その後に学ぶことはー第２章，使いやすく，１３ページーユーザーとシステムの対話が簡単にできる素晴らしいアプリケーションを作るナットとボルトです．このチャプターはコマンドラインアプリケーションのユーザーインターフェイスの全てとアプリの２つの主なスタイルを紹介します．シンプルなUNIXのようなスタイルともっと複雑なコマンドスイートスタイルです，gitやgemのようなコマンドによって例示されます．\n",
+    "\n",
+    "第３章，役に立つものに，３３ページでは，素晴らしいヘルプと使用方法の文書の提供の仕方を学びます．コマンドラインアプリはGUIと比べると発見したり学んだりするのが難しいので，これは正しいことを得るために最も重要なことの一つです．引き続いて第４章，他者とうまくやる，５３ページでは私たちのアプリと他のシステムとで相互運用できるようにする方法を学びます．\n",
+    "\n",
+    "この時点で，私たちは良いコマンドラインアプリの作り方を理解しているでしょう．第５章，カジュアルなユーザーを楽しませる，７１ページでは私たちは物事を次のレベルに引き上げ、アプリに磨きをかけることがいかに簡単かを学びます．この方向性は第６章，設定を簡単にする，８９ページにも続いていきます．そこでは様々な好みを持つユーザーにとって使いやすいものにする方法を学びます．\n",
+    "\n",
+    "第７章，苦しまずに頒布する，１０１ページでは他の人がそれを使えるように，Rubygemsでアプリケーションを配布するのに必要なものすべてを取り扱っています（Rubygemsがオプションではないしっかり管理された環境でのインストールについても取り扱います）．\n",
+    "\n",
+    "第８章，テストテストテスト，１１７ページではあなたのシステムを台無しにすることを避けるいくつかのテクニックを含むコマンドラインアプリのテストについての全てのことを学びます．アプリケーションをテストする能力には，リファクタリングする能力もあるため，管理や拡張が簡単です．第９章，管理を簡単に，１４１ページではコード編成に関連するいくつかの規則を扱います．さらにはコマンドラインアプリにとって最も役に立ついくつかのデザインパターンについて扱います．\n",
+    "\n",
+    "私たちは第10章，色，書式，インタラクティブ機能を追加する，１５３ページでコマンドラインアプリがすべきことについての限界に挑むことで終わります．着色，出力の書式について学びます．さらにはReadlineを使ったユーザーとの対話についても学びます．\n",
+    "\n",
+    "たくさんのオープンソースライブラリとオープンソースツールがRubyでコマンドラインアプリを作るのを手助けしてくれます．私たちはそのいくつかをとても詳しく見ていきます，OptionParser，GLI，そしてCucumberなどです．しかしあなたはこれらのツールだけで自らの限界を決める必要はありません．付録１，一般的なコマンドラインジェムとライブラリ，１７５ページでは他の人気のあるライブラリを調べますので，あなたにとって最適なツールを使用することができます．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true
+   },
+   "source": [
+    "### Who This Book is For\n",
+    "\n",
+    "この本は，Rubyに精通しており，気がつくとコマンドラインで物事を自動化する開発者とシステム管理者の両方を対象としています（またはそうできるようになりたいと思っている人）．\n",
+    "\n",
+    "- もしあなたが，気がつくと自動化タスクに直面しているが，コマンドライン周辺の様々な習慣や技術に精通していない開発者なら，この本はあなたを助けてくれるでしょう．あなたが持っているかもしれない問題は，遠い昔の全盛期に生きていたあなたが書いた 「クイックハック」スクリプトのメンテナンスです．この本はあなたの次のスクリプトを多くの時間を費やすことなく，長持ちする，洗練された，防弾の…ものにするツールと技術を与えてくれるでしょう．\n",
+    "\n",
+    "- もしあなたがシステム管理者なら，シェルスクリプトに限界や不満を感じているかもしれません．もしあなたの自動化タスクの中でbashが限界に達しているのなら，この本は全く新しい世界を開いてくれます．Rubyでコマンドラインアプリを書くことはRubyを本当に学び，より良いプログラマになる素晴らしい方法です．なぜなら，あなたの日常業務に直接適用できるからです．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### What You'll Need\n",
+    "\n",
+    "あなたが話についていくために必要な唯一のものはRubyのインストールとUNIXのようなシェルです．この本に載っている全ての例を動かすためにはRubyの2.0か2.1を持っている必要があります．そして，bashシェルがおすすめです（とはいえ私たちはたくさんのシェル特有の機能を見るつもりはありません）．もしあなたが本のウェブサイトからコードをダウンロードするなら，あなたはアーカイブの頂点にいるのはGemfileであると気づくでしょう．これには，サンプルアプリケーションを実行するために必要な全てのgemのリストが含まれていなければなりません．また，このファイルをBundlerとともに使用して，全てを１工程でインストールできます．もしあなたがそれらの意味を知らなくても心配いりません．この本が必要なジェムをいつインストールすればいいかを教えてくれます．もし，物事がうまくいかないなら，あなたはジェムファイルを使って，本を書いていた時に使っていたジェムのバージョンを見ることができます．\n",
+    "\n",
+    "コマンドラインアプリと併せて以下の例を書くためには，MacとLinuxのユーザーにはテキストエディタとターミナル，もしくはシェルアプリケーションが必要になります（Rubyをすでにインストールしていると仮定しています．頒布されるLinuxのほとんどにはそれが含まれています）．私はRVMを使うこととこの本の例のためのジェムセットを作ることを強くおすすめします．RVMはあなたのシステムバージョンと一緒にRubyのどんなバージョンをインストールすることも可能にします．また，gemを互いに孤立させて置くことも可能にします．これは新しいテクノロジーを学ぶ時に非常に便利です．\n",
+    "\n",
+    "Windowsユーザーの場合，例とコードはコマンドプロンプトから機能するはずです．しかし，CygwinやMSYSをインストールして，あなたのシェルにそれらのうちの1つを使用するといい経験になるでしょう．もしRubyをまだインストールしていないのであれば，Ruby Installerを使うのが最も簡単な方法です．ほとんどの場合，この本の全てのことはWindowsに対応していますが，以下は例外です．\n",
+    "\n",
+    "- .rbの接尾辞を伴うアプリの場合，ファイル拡張子をRubyと関連づける必要があります．Ruby Installerを実行するならば，これをできるようにするべきです．接尾辞がないアプリの場合，.rb拡張子との関連性を設定したと仮定して，rubyコマンドでアプリを実行する必要があります．こんな風に．\n",
+    "\n",
+    "```\n",
+    "c:l> ruby my_app.rb\n",
+    "```\n",
+    "\n",
+    "単純化するために，これを包んで.batファイルを作ることができます．\n",
+    "\n",
+    "```\n",
+    "@echo off\n",
+    "ruby my_app.rb %*\n",
+    "```\n",
+    "\n",
+    "％＊はあなたの.batファイルに与える全てのコマンドラインパラメータがあなたのアプリに伝達されることを確実にします．\n",
+    "\n",
+    "- アルバ，コマンドラインアプリの承認テストを実行するために使用するツール，はこれを書いている時のWindowsではちゃんとサポートされていない．テストの章，第８章，テストテストテスト，１１７ページでは，これについてさらに詳しく説明します．\n",
+    "\n",
+    "それ以外にも，Windowsユーザーが少し違ったやりかたをする必要があるものがあれば，それを指摘しますが，一般的に言って，UNIXのようなプラットフォームとWindowsの両方でうまく機能します。"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Conventions Used in the Book\n",
+    "\n",
+    "この本で使われているレイアウトや表記法について知っておくべき３つの重要なことがあります．Ruby，Unix，OOで必要となる背景知識のレベル，私たちがコードで作業する方法，このすべてに適合するテストです．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Ruby, UNIX, and Object Orientation\n",
+    "\n",
+    "これはRubyでコマンドラインアプリを書くことについての本なので，Ruby言語とUNIX環境について少しは知る必要がでてくるでしょう．RubyやUNIXに慣れ親しむことと並行して，できるだけコード例を綺麗にしておくと，話についていくことができるでしょう．\n",
+    "\n",
+    "本の後半で，Rubyのオブジェクト指向の機能をもっと使い始めます．なのでどのようなクラスやオブジェクトが役に立つか分かります．また，Rubyのもっと難解ないくつかの機能に気を取られることなく，ツールやテクニックに集中することができるように，できるだけシンプルにしました．\n",
+    "\n",
+    "もしあなたがRubyを始めたばかりだったり，刷新したいだけなら，Ruby Koansや\"Pickaxe Book\"を検討してください．"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Code\n",
+    "\n",
+    "この本はコードについてのものであると指摘する価値もあります．たくさんのコードがあり，新しいちょっとしたことを一歩づつ着実にするためにベストを尽くします．この本のコードのほとんどは，時間をかけて強化したり改善したりする２つのサンプルアプリケーションからなります．私たちが変化する新しいことを指摘するために，微妙だが重要な呼び出しを使います．このようないくつかのRubyコードを考えてみてください．\n",
+    "\n",
+    "```\n",
+    "if !filename.nil?\n",
+    "  File.open(filename) do |file|\n",
+    "    file.readlines do |line|\n",
+    "      puts line.upcase\n",
+    "    end\n",
+    "  end\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "否定的なテストを避けるためにifをunlessに変更したくなるかもしれません．\n",
+    "\n",
+    "```\n",
+    "unless filename.nil?\n",
+    "  File.open(filename) do |file|\n",
+    "    file.readlines do |line|\n",
+    "      puts line.upcase\n",
+    "    end\n",
+    "  end\n",
+    "end\n",
+    "```\n",
+    "\n",
+    "新しいunlessの文の横に矢印が表示されたのがわかりますか？新しいコードがあるたびにそれらを探してください．場合によっては，作業中にコードに大きな変更を加えることもあります．私たちは参照するために特定の行を呼び出します，このように．\n",
+    "\n",
+    "```\n",
+    "1 def upper_case_file(filename)\n",
+    "2   unless filename.nil?\n",
+    "      File.open(filename) do |file|\n",
+    "        file.readlines do |line|\n",
+    "3         puts line.upcase\n",
+    "        end\n",
+    "      end\n",
+    "    end\n",
+    "  end\n",
+    "```\n",
+    "\n",
+    "番号付きのリストを使うことで特定の行を議論することができます．\n",
+    "\n",
+    "1. ここで新しいメソッドの名前（upper_case_file）を決めます．\n",
+    "\n",
+    "1. nilをここで確認するので，File.openから例外が出ることはありません．\n",
+    "\n",
+    "1. 最後に，putsでそれを表示する前にファイルから読み込んだ行を大文字で表示します．"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "collapsed": true
+   },
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Ruby 2.3.3",
+   "language": "ruby",
+   "name": "ruby"
+  },
+  "language_info": {
+   "file_extension": ".rb",
+   "mimetype": "application/x-ruby",
+   "name": "ruby",
+   "version": "2.3.3"
+  },
+  "latex_envs": {
+   "LaTeX_envs_menu_present": true,
+   "autocomplete": true,
+   "bibliofile": "biblio.bib",
+   "cite_by": "apalike",
+   "current_citInitial": 1,
+   "eqLabelWithNumbers": true,
+   "eqNumInitial": 1,
+   "hotkeys": {
+    "equation": "Ctrl-E",
+    "itemize": "Ctrl-I"
+   },
+   "labels_anchors": false,
+   "latex_user_defs": false,
+   "report_style_numbering": false,
+   "user_envs_cfg": false
+  },
+  "toc": {
+   "nav_menu": {},
+   "number_sections": true,
+   "sideBar": true,
+   "skip_h1_title": false,
+   "toc_cell": false,
+   "toc_position": {},
+   "toc_section_display": "block",
+   "toc_window_display": false
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}