helloworld という名前の新しい Rust プロジェクトを作成します。

結果を確認します。

$ cd helloworld
$ tree
.
├── Cargo.toml
└── src
    └── main.rs

1 directory, 2 files
$ cat src/main.rs
fn main() {
    println!("Hello, world!");
}

ディレクトリー helloworld がプロジェクト用に作成されます。これは、プロジェクトメタデータを追跡するためのファイル Cargo.toml、メインのソースコードファイル main.rs が含まれるサブディレクトリー src とともに作成されます。

ソースコードファイル main.rs は Cargo によって、サンプル hello world プログラムに初期化されています。

この例では、例2.1「Cargo を使用した Rust プロジェクトの作成」 に従って Rust プロジェクト helloworld が正常に作成されていることを前提とします。

helloworld ディレクトリーに移動し、プロジェクトをビルドします。

結果を確認します。

$ tree
.
├── Cargo.lock
├── Cargo.toml
├── src
│   └── main.rs
└── target
    └── debug
        ├── build
        ├── deps
        │   └── helloworld-b7c6fab39c2d17a7
        ├── examples
        ├── helloworld
        ├── helloworld.d
        ├── incremental
        └── native

8 directories, 6 files

ディレクトリー target から開始して、サブディレクトリー構造が作成されました。このプロジェクトはデバッグモードでビルドされているため、実際のビルド出力は追加のサブディレクトリー debug に含まれます。実際の実行ファイルは target/debug/helloworld です。

この例では、例2.2「Cargo を使用した Rust プロジェクトのビルド」 に従って Rust プロジェクトの helloworld が正常にビルドされていることを前提とします。

helloworld ディレクトリーに移動し、プロジェクトを確認します。

プロジェクトをチェックし、cargo build コマンドの出力と似た出力が表示されます。ただし、実行ファイルは生成されません。これを確認するには、現在の時間を実行ファイルのタイムスタンプと比較します。

$ date
Fri Oct 13 08:53:21 CEST 2017
$ ls -l target/debug/helloworld
-rwxrwxr-x. 2 vslavik vslavik 252624 Oct 13 08:48 target/debug/helloworld

この例では、例2.2「Cargo を使用した Rust プロジェクトのビルド」 に従って Rust プロジェクトの helloworld が正常にビルドされていることを前提とします。

helloworld ディレクトリーに移動し、プロジェクトを実行します。

Cargo はまずプロジェクトを再構築し、作成された実行ファイルを実行します。

この例では、最後のビルド以降にソースコードに変更がありませんでした。そのため、Cargo は実行可能ファイルを再構築する必要はなく、現時点では受け入れるだけでした。

この例では、例2.2「Cargo を使用した Rust プロジェクトのビルド」 に従って Rust プロジェクトの helloworld が正常にビルドされていることを前提とします。

helloworld ディレクトリーに移動し、以下のソースコードが含まれるように src/main.rs ファイルを編集します。

fn main() {
    println!("Hello, world!");
}

#[test]
fn my_test() {
    assert_eq!(21+21, 42);
}

テスト対象の関数 my_test が追加されました。

ファイルを保存し、テストを実行します。

Cargo はまずプロジェクトを再構築し、次にプロジェクトにあるテストを実行します。helloworld プロジェクトはテスト my_test を正常に渡しました。

この例では、例2.2「Cargo を使用した Rust プロジェクトのビルド」 に従って Rust プロジェクトの helloworld が正常にビルドされていることを前提とします。

helloworld ディレクトリーに移動し、以下のソースコードが含まれるように src/main.rs ファイルを編集します。

extern crate time;

fn main() {
    println!("Hello, world!");
    println!("Time is: {}", time::now().rfc822());
}

このコードには、外部のクレート time が必要になりました。以下のコードが含まれるように Cargo.toml ファイルを編集して、この依存関係をプロジェクト設定に追加します。

[package]
name = "helloworld"
version = "0.1.0"
authors = ["Your Name <yourname@example.com>"]

[dependencies]
time = "0.1"

cargo run コマンドを実行してプロジェクトをビルドし、作成された実行ファイルを実行します。

Cargo は time crate とその依存関係 (crate libc) をダウンロードし、ローカルに保管し、依存関係を含むすべてのプロジェクトのソースコードをビルドし、最終的に生成される実行ファイルを実行します。

この例では、例2.6「プロジェクトへの依存関係の追加および cargo で構築」 に従って依存関係で Rust プロジェクト helloworld を正常にビルドしていることを前提としています。

helloworld ディレクトリーに移動し、以下のソースコードが含まれるように src/main.rs ファイルを編集します。

//! This is a hello-world program.
extern crate time;

/// Prints a greeting to `stdout`.
pub fn print_output() {
    println!("Hello, world!");
    println!("Time is: {}", time::now().rfc822());
}

/// The program entry point.
fn main() {
    print_output();
}

コードに public 関数 print_output() が含まれるようになりました。helloworld プログラム、print_output() 関数、および main() 関数には、ドキュメントコメントが含まれています。

cargo doc コマンドを実行し、プロジェクトのドキュメンテーションを構築します。

インストールされていない場合は、 ツール tree (デフォルトの Red Hat Enterprise Linux リポジトリーで利用できます) をインストールします。

# yum install tree

結果を確認します。

$ tree
.
├── Cargo.lock
├── Cargo.toml
├── src
│   └── main.rs
└── target
...
    └── doc
...
        ├── helloworld
        │   ├── fn.print_output.html
        │   ├── index.html
        │   ├── print_output.v.html
        │   └── sidebar-items.js
...
        └── src
            └── helloworld
                └── main.rs.html

12 directories, 32 files

Cargo はプロジェクトのドキュメンテーションを構築します。ドキュメントを表示するには、ブラウザーで target/doc/helloworld/index.html ファイルを開きます。生成されたドキュメントには、公開されていないため、main() 関数に関する記述は含まれません。

--no-deps オプションを指定せずに cargo doc コマンドを実行し、依存関係ライブラリーの タイム や libc を含むプロジェクトドキュメントを構築します。

tree コマンドを使用して、生成されたディレクトリー構造を確認します。

$ tree
...
92 directories, 11804 files
$ ls -d target/doc/*/
target/doc/helloworld/  target/doc/implementors/  target/doc/libc/  target/doc/src/  target/doc/time/

作成されるドキュメントは、依存関係ライブラリーの time および libc にも対応し、それぞれ target/doc/ ディレクトリーに別のサブディレクトリーとして存在します。

この例では、例2.6「プロジェクトへの依存関係の追加および cargo で構築」 に従って依存関係で Rust プロジェクト helloworld を正常にビルドしていることを前提としています。

ディレクトリー helloworld に移動し、cargo vendor コマンドを実行して依存関係のあるプロジェクトをベンダーします。

結果を確認します。

$ ls
Cargo.lock  Cargo.toml  src  target  vendor
$ tree vendor
vendor
├── kernel32-sys
│   ├── build.rs
│   ├── Cargo.toml
│   ├── README.md
│   └── src
│       └── lib.rs
├── libc
│   ├── appveyor.yml
│   ├── Cargo.toml
...
75 directories, 319 files

vendor ディレクトリーには、helloworld プログラムを構築するために必要なすべての依存関係 crates のコピーが含まれます。Windows オペレーティングシステムでプロジェクトをビルドするための Crates は、Red Hat Enterprise Linux でこのコマンドを実行してもベンダーが提供されています。

GitHub リポジトリーから rust-test-app を構築するには、以下の手順を実行します。

 $ git clone https://github.com/openshift-s2i/s2i-rust.git
 $ cd s2i-rust
 $ make build

s2i build ./examples/test-app/ devtools/rust-toolset-rhel7 rust-test-app

イメージを実行するには、コマンドラインに以下のコマンドを入力します。

$ docker run rust-test-app

ローカルで利用可能なアプリケーションイメージ rust-test-app は、rust-toolset コンテナーイメージを使用してビルドされます。