ケント・ベックの「テスト駆動開発」の写経をRustでやってみる(2)

最初にやるのはcargo newである。

> cargo new money
     Created binary (application) `money` package
> cd money
> ls -la
total 16
drwxr-xr-x  6 tambara  staff  192  3 20 17:48 .
drwxr-xr-x  3 tambara  staff   96  3 20 17:48 ..
drwxr-xr-x  8 tambara  staff  256  3 20 17:48 .git
-rw-r--r--  1 tambara  staff    8  3 20 17:48 .gitignore
-rw-r--r--  1 tambara  staff  226  3 20 17:48 Cargo.toml
drwxr-xr-x  3 tambara  staff   96  3 20 17:48 src

.gitまで出来ちゃう辺りが新世代って感じ。

さて、まずは実行してみますか。

> cargo run
   Compiling money v0.1.0 (/Users/tambara/study/tdd_rust/money)
    Finished dev [unoptimized + debuginfo] target(s) in 0.34s
     Running `/Users/tambara/study/tdd_rust/money/target/debug/money`
Hello, world!

Hello, worldが書かれていたようだ(笑)。

さて、もちろんVimでコードを書いていってもいいわけだけど、 今回はVScodeも使ってみたい。 私は本当に手に馴染んだIDEというものがないのだ。

では、単純にVScodeでこのディレクトリを開いてみよう。

このファイルがRustのソースコードであることは知っているわけだ。

ただし、このレベルではVimと大差ない。 Rustは公式のLanguage Serverがあるらしいので、もっと格好良くなるはず。

というわけで、拡張を入れる事にする。 拡張をクリックすると、RECOMMENDEDのトップにRust(rls)が出ている。 入れるべきなのはこれなんだけど、「お前、Rust書くのか。・・・入れるだろ」と 見透かされているようでなんかムカつく(笑)。

ま、入れますけど。

入れると、「rls入ってへんがな」と怒られる。

https://github.com/rust-lang/rls

を見て、インストールする。

> rustup update
info: syncing channel updates for 'stable-x86_64-apple-darwin'
info: checking for self-updates

  stable-x86_64-apple-darwin unchanged - rustc 1.42.0 (b8cedc004 2020-03-09)

info: cleaning up downloads & tmp directories
> rustup component add rls rust-analysis rust-src
info: downloading component 'rls'
info: installing component 'rls'
info: downloading component 'rust-analysis'
info: installing component 'rust-analysis'
info: downloading component 'rust-src'
info: installing component 'rust-src'

これでいいのかな？

ステータスバーのRLSのところがRLS:startingのままになって 動かない状態になって上手く動かなかったんだけど、 その後、最新版へのUPDATE指示が出て、更新して再起動したら動いた。なんか謎。

サジェスチョンでるようになった。おおー。

ケント・ベックの「テスト駆動開発」の写経をRustでやってみる(1)

社内で、ケント・ベックの「テスト駆動開発」を写経する会を立ち上げて、アドバイザーみたいなことをやることになった。良いコードを書くにはまだ及ばないが、酷いテストコードを直す経験ならちょっとしたものである(笑)。

とりあえず、参加メンバーはあまり普段コードを書かないような人(うちの社内はそういう人の方が多いのだ)になるだろうから、書籍と全く同じようにJavaで書く。もうホントに一字一句その通りにやるのが良いと思う。というわけで、スタートガイドのようなものをQiitaに書いた。

qiita.com

その一方で、私はJavaでやってもつまらないので、Rustでやってみることにする。Rustは2年前に社内の勉強会でちょっと触って以来だ。そのときに一度インストールはしたのだが、その後、Diskが飛んでいるのでまたインストールするところからのスタートである。

さて、こういう時は本家からスタートするに限る。

Rustプログラミング言語

インストールのページを見に行くと

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

をやれと書いてある。homebrewでも入れられるけど、こっちとデフォルトで入るモノが違ったりするらしいので、公式に従うことにする。

> curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
info: downloading installer

Welcome to Rust!

This will download and install the official compiler for the Rust
programming language, and its package manager, Cargo.

It will add the cargo, rustc, rustup and other commands to
Cargo's bin directory, located at:

  /Users/tambara/.cargo/bin

This can be modified with the CARGO_HOME environment variable.

Rustup metadata and toolchains will be installed into the Rustup
home directory, located at:

  /Users/tambara/.rustup

This can be modified with the RUSTUP_HOME environment variable.

This path will then be added to your PATH environment variable by
modifying the profile files located at:

  /Users/tambara/.profile
/Users/tambara/.bash_profile

You can uninstall at any time with rustup self uninstall and
these changes will be reverted.

Current installation options:


   default host triple: x86_64-apple-darwin
     default toolchain: stable
               profile: default
  modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
>

info: profile set to 'default'
info: default host triple is x86_64-apple-darwin
info: syncing channel updates for 'stable-x86_64-apple-darwin'
info: latest update on 2020-03-12, rust version 1.42.0 (b8cedc004 2020-03-09)
info: downloading component 'cargo'
info: downloading component 'clippy'
info: downloading component 'rust-docs'
 12.1 MiB /  12.1 MiB (100 %)  11.7 MiB/s in  1s ETA:  0s
info: downloading component 'rust-std'
 16.1 MiB /  16.1 MiB (100 %)   8.2 MiB/s in  1s ETA:  0s
info: downloading component 'rustc'
 54.5 MiB /  54.5 MiB (100 %)   8.7 MiB/s in  6s ETA:  0s
info: downloading component 'rustfmt'
info: installing component 'cargo'
info: installing component 'clippy'
info: installing component 'rust-docs'
 12.1 MiB /  12.1 MiB (100 %)   2.9 MiB/s in  3s ETA:  0s
info: installing component 'rust-std'
 16.1 MiB /  16.1 MiB (100 %)  14.9 MiB/s in  1s ETA:  0s
info: installing component 'rustc'
 54.5 MiB /  54.5 MiB (100 %)   8.7 MiB/s in  6s ETA:  0s
info: installing component 'rustfmt'
info: default toolchain set to 'stable'

  stable installed - rustc 1.42.0 (b8cedc004 2020-03-09)


Rust is installed now. Great!

To get started you need Cargo's bin directory ($HOME/.cargo/bin) in your PATH
environment variable. Next time you log in this will be done
automatically.

To configure your current shell run source $HOME/.cargo/env

.profileにはちゃんとパスの設定も入っている。

> cat .profile 

export PATH="$HOME/.cargo/bin:$PATH"

が、こちらはfish遣いなので、自分でやる。

.config/fish/config.fishの末尾に

# Rust
set -x PATH $HOME/.cargo/bin $PATH

を書き足せばOKだ。

> rustup --version
rustup 1.21.1 (7832b2ebe 2019-12-20)
> rustc --version
rustc 1.42.0 (b8cedc004 2020-03-09)
> cargo --version
cargo 1.42.0 (86334295e 2020-01-31)

とりあえず、一安心。

docsifyを入れてみる

下準備

まずはNode.jsを入れるところから。

> brew install nodebrew

Warning: nodebrew 1.0.1 is already installed and up-to-date
To reinstall 1.0.1, run `brew reinstall nodebrew`

あれ？

> nodebrew -v
nodebrew 1.0.1

Usage:
    nodebrew help                         Show this message
(以下略)
> nodebrew list
v10.15.3
v12.2.0

current: none

あー。

> nodebrew use v12.2.0
use v12.2.0
> nodebrew list
v10.15.3
v12.2.0

current: v12.2.0

とりあえず、これで。気が向いたら更新する。

> node -v
v12.2.0
> npm -v
6.9.0

下準備はOK

Quick start

docsify.js.org をやってみる。

> npm install docsify-cli -g
/Users/tambara/.nodebrew/node/v12.2.0/bin/docsify -> /Users/tambara/.nodebrew/node/v12.2.0/lib/node_modules/docsify-cli/bin/docsify

> fsevents@1.2.9 install /Users/tambara/.nodebrew/node/v12.2.0/lib/node_modules/docsify-cli/node_modules/fsevents
> node install

node-pre-gyp WARN Using needle for node-pre-gyp https download 
[fsevents] Success: "/Users/tambara/.nodebrew/node/v12.2.0/lib/node_modules/docsify-cli/node_modules/fsevents/lib/binding/Release/node-v72-darwin-x64/fse.node" is installed via remote

> core-js@2.6.9 postinstall /Users/tambara/.nodebrew/node/v12.2.0/lib/node_modules/docsify-cli/node_modules/core-js
> node scripts/postinstall || echo "ignore"

Thank you for using core-js ( https://github.com/zloirock/core-js ) for polyfilling JavaScript standard library!

The project needs your help! Please consider supporting of core-js on Open Collective or Patreon: 
> https://opencollective.com/core-js 
> https://www.patreon.com/zloirock 

Also, the author of core-js ( https://github.com/zloirock ) is looking for a good job -)


> docsify@4.9.4 postinstall /Users/tambara/.nodebrew/node/v12.2.0/lib/node_modules/docsify-cli/node_modules/docsify
> opencollective postinstall


                         Thanks for installing docsify 🙏
                 Please consider donating to our open collective
                        to help us maintain this package.

                           Number of contributors: 140
                              Number of backers: 12
                              Annual budget: US$ 158
                             Current balance: US$ 257

          👉  Donate: https://opencollective.com/docsify/donate

+ docsify-cli@4.3.0
added 456 packages from 207 contributors in 24.511s

自分の日記の場所で初期化する。

> docsify init ./diary

Initialization succeeded! Please run docsify serve ./diary

> cd diary/
> ls -la
total 16
drwxr-xr-x   7 tambara  staff  224  9 28 08:13 .
drwxr-xr-x@  8 tambara  staff  256  9 23 13:28 ..
-rw-r--r--   1 tambara  staff    0 10 26  1985 .nojekyll
drwxr-xr-x  14 tambara  staff  448  5  8 23:22 2018
drwxr-xr-x  12 tambara  staff  384  9  2 10:23 2019
-rw-r--r--   1 tambara  staff   34 10 26  1985 README.md
-rw-r--r--   1 tambara  staff  612  9 28 08:13 index.html

以下の3つのファイルが出来てる。

• index.html
• README.md
• .nojekyll

カレントディレクトリに戻って起動してみる。

> docsify serve diary

Serving /Users/tambara/diary now.
Listening at http://localhost:3000

何にもないページが出る

しばらくmarkdownで作業のメモを作るようにしていたので、過去に書いたメモはURLを指定すれば読める。

diary/2018/12/20181224.md というファイルを表示してみる。

なるほど。

とりあえず、動いてる。いったん、ここまで。次はディレクトリにあるファイルの一覧をブラウザで取れるようにしてみよう。

Java13にヒアドキュメントが入ったらしい

http://jdk.java.net/13/ からダウンロード。展開して、

> sudo mv ./jdk-13.jdk/ /Library/Java/JavaVirtualMachines/
> /usr/libexec/java_home
/Library/Java/JavaVirtualMachines/jdk-13.jdk/Contents/Home
> set -x JAVA_HOME (/usr/libexec/java_home -v 13)
> echo $JAVA_HOME
/Library/Java/JavaVirtualMachines/jdk-13.jdk/Contents/Home
> java --version
openjdk 13 2019-09-17
OpenJDK Runtime Environment (build 13+33)
OpenJDK 64-Bit Server VM (build 13+33, mixed mode, sharing)

てな感じ。環境変数のセットの部分はfishを使っているのでこうなっている。

さっそく試す。

> jshell
|  JShellへようこそ -- バージョン13
|  概要については、次を入力してください: /help intro

jshell> String hoge = """
   ...> ID, Name, Sex
   ...> G3, アムロ, M
   ...> C109, ハヤト, M
   ...> 006, セイラ, F
   ...> """
|  エラー:
|  テキスト・ブロックはプレビュー機能であり、デフォルトで無効になっています。
|    (テキスト・ブロックを有効にするには--enable-previewを使用します)
|  String hoge = """
|                ^

しょぼーん

> jshell --enable-preview
|  JShellへようこそ -- バージョン13
|  概要については、次を入力してください: /help intro

jshell> String hoge = """
   ...> ID, Name, Sex
   ...> G3, アムロ, M
   ...> C109, ハヤト, M
   ...> 006, セイラ, F
   ...> """
hoge ==> "ID, Name, Sex\nG3, アムロ, M\nC109, ハヤト, M\n006, セイラ, F\n"

いえーい。

DataGripでモデルの絵を書く

絵は本来、「描く」ものだが、データモデリングの場合、「書く」のが正しい気がするのでタイトルはわざとである。つっこまないように。そして、見習わないように。

さて、DataGripの話をしようとしていたのにAWSに不慣れなせいでDBに接続するところで前回は力尽きた。 早速、テーブルを作っていこう・・・と言いたいところだが、さくさく作れるので途中のスクリーンショットも撮らずに喜んでひとしきり作ってしまった。

まず、DB接続をした直後は、"hogefuta"という適当に付けたDB接続定義の直下に、schemasとcollationsという2つがある。schemasの下にはinfomation_schemaというメタ情報を格納するのだと思われるスキーマだけがあるので、まずはスキーマを1つ作る。operationにした。システム運用に関するデータモデルを作るつもりだったのだ。

その直下にテーブルを作っていく。テーブル作成のダイアログはこんな感じ。

すこぶる簡単だ。

ダイアログを書くには外部キー制約を付ける。基本的に勝手にテーブル同士を結ぶことはできないみたいだ。

外部キーを付けるのも簡単

ちゃんと補完も入れてくれる。さすがJetBrains製。

というわけで、ひとしきりテーブル設計をした上で、Databaseビューで1つテーブルを選んで右クリック。[Diagrams] - [Show Visualisation...]を選ぶとこんな感じ。外部キーとして見ているテーブルも一緒に出てくる。

レイアウトは何種類か選べる。

テーブルの位置は動かせるけど覚えてくれない。線の出る位置などもいじれないので、そのへんの見た目はあんまり頑張れないみたい。

参照しているキーの表示・非表示、PKとそれ以外のカラムそれぞれの表示・非表示が設定できるので、思いっきり表示を絞って30弱作ったテーブルを全部表示させてみると、

わかりやすくはないね。ちなみに色はテーブルごとに選んで付けることが出来る。テーブルをグループ分けできるのでとても良い。ただし、見た目だけね。

前述の通り、テーブルを選んで作図させると参照しているテーブルも表示される。これは嬉しい時も嬉しくないときもあるんだけど、1度表示させておいて、図で右クリックして指定したテーブルの表示を消すことが出来る。

[Delete]をクリックするのはちょっと怖いけど、別にテーブルがドロップしたりはしない。

というわけで、ひとまず目的は果たした。

データモデリングというとこのように実際にDDLをDBに投げてテーブルを作るレベルよりもすこし上流の、つまりいい加減なレベルで書きたいことが多い。ER図のようにカラスの足みたいなカーディナリティの表記もできないし、そもそもカラム間の参照があるところしか線が引かれないのでデータモデリングという意味ではこれはちょっと違うよねって感じだが、開発に近いレベルであったり、すでに動いているアプリケーションについて分析したりする上ではこれはとてもよく出来たツールだと思う。そもそも、人間が手でちまちまる絵とDDLの整合性を取って保存しておくことはなんだかよくわからない仕様を生み出しかねないので、図は書けるけどDDL(と、色づけ)の情報しか保持せずに図は自動で生成したものしかないっす！という仕様も1つの妥当な選択であり、これはこれでいいんじゃないかと思う。なにせ、BlueworksLiveで書いたプロセスを見ながら数時間うーむと悩んだだけでこれだけのデータモデルが作れたのだから立派なものだ。ExcelとPowerPointでやっていたら死んでた。

今回は絵を書くことが目的だったので、データをつっこんだり、ぶっこぬいたり、クエリしたりという本来の機能はなんも使わなかったのだけど、この分ならそのあたりの機能もちゃんと使えることだろう。あと、起動も含めて操作が軽いのもいいですね。Javaで作ってるのに(というのは、MacのJava実行環境なんてそんな頑張られてないだろうという偏見を持っているということなんだけど)偉いなあ。

データモデリングをしようと思い、DataGripを使ってみることにする

でっかいSIerでお仕事をしていると、データモデリングをすることが・・・それほどはない。だいたい、そのポジションは1アプリケーションにつき、1人が専任してやることが多いからだ。それぐらいデータモデリングは統一された考え方が必要だし、重要なものだ。私はちゃらんとかぽらんとかしている人間で、データモデルの管理を任せられたことなんかないのだ。

とはいえ、ちょっとした作業の仕組みをデータモデリングを使って表現したいことだってある。人間の活動というのは、だいたいがデータ処理なのだ。そこではわかりやすい絵で表現することが大事だ。ベースがデータモデリングなのだからデータベースの管理ツールを使って書ければそれがよい。後で他の時にも役にたつかもしれないし。PowerPointで書くのは出来れば避けたい。なぜなら、泣きそうになるからだ。

というわけで、なんか新しいツールを触ってみるべと思い、最近とみに評判のよいJetBrainsのページを見てみる。DB管理ツールがあるので、これを使ってみることにする。DataGridという名前だ。ほっくりと有料だが、例によって1ヶ月間の試用期間がある。月額¥2290とあるので、使いたくなったときにポチッとお金を払うのでも良さそうだ。払ったことないので、ライセンス管理をどうやってやるのかしらないけど。

さて、dmgがダウンロードできたので(今回はdatagrip-2019.1.4.dmgというファイル名だった)、インストールしてみよう。そういえば、こないだMacがあぱらぱーになって工場出荷状態に戻して以来、初めてインストールするJetBrains IDEものだ。

さっそく起動すると以下のウィンドウからスタートだ。

設定の取り込み

"Do not import settings"で進む。リーガル・アグリーメントがでるので、アグリーしちゃう。アグリー。

User Agreement

よく聞かれる情報を送っていいかダイアグラム。お好きにどうぞ

診断情報の送信確認

お金を払える。とりあえず、払わない。

License Activation

UIテーマを選ぶ。私、いわゆるダークモードって嫌いです。

UIテーマ

接続するDBの種類を選ぶ。お絵かきするだけなのでなんだっていいんだけど、あとでAWSのDBでも遊んでみたいのでMariaDBを選んどく。 Directoryはよくわからないので、とりあえず何も書かないでいってみよう。

Database Option

というわけで、やっとこさ起動した。

起動直後

せっかくだからDBに接続してみよう。AWSコンソールからRDSを選ぶ。ちなみに、私のAWSアカウントは作ってIAMのセキュリティ設定だけしかしてないすっからかんのアカウントである。

RDS

しょっぱいDBを作っとく。DB名は恥ずかしいので秘密(謎)。あえて簡単設定を選んでみよう。

DBの作成1

DBの作成2

作成中。

作成中

[認証情報の詳細を表示]をクリックすると

ここにパスワードが出るので、メモっておく。作成が完了したら、DB識別子のリンクをクリックして、

接続情報

エンドポイントとポートをメモる。これを使って接続する。

DataGripでCommand-Nすると、メニューが出てくる。

Newメニュー

[Data Source from URL]を選ぶ。

シンプルなダイアログ

エンドポイントをURLに入れる。ある程度埋まった設定画面が出る。

設定画面

[Test Connection]を押すと、テスト接続できる。

で、すんなりとは接続できなかった。

1. ドライバが入ってない。これは[Test Connection]を押すとダウンロードしてくれるので問題ない。
2. Connection Time Outになる。簡単設定でつくると、パブリックアクセシビリティがオフになってるので、オンに変更する。
3. それでもタイムアウト。考えてみれば、DBインスタンスと同時にできたVPCの接続設定がされてない。VPCセキュリティグループにMyIPからの3306を許可

VPCセキュリティグループ

これで繋がるようになった。

長くなったので、つづく。

プロセスフローを書きたいと思い、BlueworksLiveに出会った

でっかいSIerでお仕事をしていると、プログラムコードを書くよりもビジネスプロセスを書く方がよっぽど頻度が高い(個人の感想です)。

ビジネスプロセスというとスイムレーンが水平に並んでいて、お仕事が左から右にフローチャートみたいな書式で流れていく、 あんな感じの図を思い浮かべる人も多いだろう。アレだ。

DFDを思い浮かべてしまう人や、シーケンス図を思い浮かべてしまう人もいるだろうか。いないか。

アーキテクトたるもの、図を書くものである。むしろ、抽象概念を図で表すことが主なアーキテクトの仕事と言っても良い。これをモデリングという。なので、アーキテクトは様々なものを図にする。図にするのは、複雑なものを単純にして理解しやすくするという意味もあるが、誰か他の人にモデリング対象がどうなっているか伝えるという大きな意味もある。というわけで、図の書き方、記法というものはアーキテクト間で共有されてなければならない。

そんなわけで、ビジネスプロセスも図にするときには記法がある。BPMN(Business Process Model and Notation)という。このBPMNに従った図をラクチンに書く方法が欲しい。Excelやパワーポイントで書くと泣きそうになるからだ。

己のクリック力を最大限まで高めて検索してみたが、お手頃であんまりいいツールはない。マネーを支払って良いのならIBMのクラウドツールであるBlueworksLiveが良い事がわかった。灯台下暗しである。1ユーザー月額$53。日本円で買うとなぜか¥7,345。まあ、良い値段だけどお仕事ツールとしてめちゃ高いわけでもない。1ヶ月試用できるので、その間に仕事を終わらすのがナイス。

何が灯台の下だったかというと、私は何を隠そうIBM社員であり、社員はタダで使えると言うことにログインしてみて初めて気がついたからである。なので、ここでBlueworksLiveをべた褒めしているのは社員だということに注意して欲しい。社員も知らないようなツールなのかよということも、あまり突っ込まないで欲しい。デカい会社というのはそんなものだ。

というわけで、そんなにたくさんの種類のお絵かきツールを使ったわけではないし、BPMNを活かすような使い方もしていないけど、ビジネスフロー作成ツールとしてはBlueworksLiveはかなり良い感じだった。ログインするとまずチュートリアルのビデオを見ててと言われるので(英語を我慢して)見て欲しい。はー、よくできてんなーと思ってもらえると思う。