🌨️ 🍁 👨🏾‍🔬 コマンドラインユーティリティをGo / RustからDに移植する 👨🏻‍🔧 🙏🏻 ✅

数日前、「プログラミング」のredditで、Paulo Henrique Cuchiは、Rust and Go（Habréに翻訳）でコマンドラインユーティリティを開発した経験を共有しました。問題のユーティリティは、彼のペットプロジェクトHashtrackのクライアントです。Hashtrackは、顧客が特定のTwitterハッシュタグを追跡し、関連するツイートのリストをリアルタイムで取得できるGraphQLAPIを提供します。コメントに促されて、Dでポートを作成して、Dを同様の目的で使用する方法を示すことにしました。私は彼が彼のブログ投稿で使用したのと同じ構造を維持しようとします。クリック

時のGitHub

ビデオのソース

Dに来たきっかけ

主な理由は、元のブログ投稿がGoやRustなどの静的に型指定された言語を比較し、NimやCrystalに敬意を表して言及したが、このカテゴリに分類されるDについては言及していなかったためです。ですから、比較が面白くなると思います。

私は言語としてDも好きで、他のさまざまなブログ投稿で言及しています。

ローカル環境

このマニュアルには、リファレンスコンパイラであるDMDをダウンロードしてインストールする方法に関する広範な情報が含まれています。Windowsユーザーはインストーラーを入手でき、macOSユーザーは自作を使用できます。Ubuntuでは、aptリポジトリを追加し、通常のインストールに従いました。これにより、DMDだけでなく、ダブ、パッケージマネージャーも取得できます。

Rustをインストールしたので、始めるのがどれほど簡単かを知ることができました。とても簡単なことに驚きました。インタラクティブインストーラーを実行するだけで、残りは処理されました。パスに〜/ .cargo / binを追加する必要がありました。変更を有効にするには、コンソールを再起動する必要がありました。

編集者によるサポート

私はVimでHashtrackを問題なく作成しましたが、それはおそらく、標準ライブラリで何が起こっているのかについてある程度の考えがあるためです。正しいパッケージからインポートしなかったシンボルを使用したり、間違った引数で関数を呼び出したりしたため、常にドキュメントを開いていました。標準ライブラリの場合、単に「importstd;」と書くことができることに注意してください。そして、あなたの処分ですべてを持っています。ただし、サードパーティのライブラリの場合は、ご自身で行ってください。

ツールキットの状態に興味があったので、お気に入りのIDEであるIntellijIDEAのプラグインを調べました。私はこれを見つけましたそしてそれをインストールしました。また、DCDとDScannerをそれぞれのリポジトリのクローンを作成してビルドし、正しいパスを指すようにIDEAプラグインを構成してインストールしました。詳細については、このブログ投稿の作成者に問い合わせてください。

最初はいくつかの問題が発生しましたが、IDEとプラグインを更新した後に修正されました。私が遭遇した問題の1つは、彼女が自分のパッケージを認識できず、「おそらく未定義」としてマークし続けたことでした。後で、それらが認識されるために、「modulepackage_module_name;」を配置する必要があることに気付きました。ファイルの先頭にあります。

少なくとも私のマシンでは、.lengthが認識されないというバグがまだあると思います。 Githubで問題を開いたので、ここでフォローできます興味があれば。

Windowsを使用している場合、VisualDについて良いことを聞いたことがあります。

パッケージ管理

Dubは、Dの事実上のパッケージマネージャーです。code.dlang.orgから依存関係をダウンロードしてインストールします。このプロジェクトでは、cURLを使用したくなかったため、HTTPクライアントが必要でした。最終的に、2つの依存関係、requestsとその依存関係、cachetoolsになりましたが、これには独自の依存関係がありません。しかし、何らかの理由で、彼はさらに12の依存関係を選択

しました。Dubはそれらを内部で使用していると思いますが、それについてはよくわかりません。

Rustはたくさんの箱（約228）をダウンロードしましたが、これはおそらくRustバージョンが私のものよりも多くの機能を備えているためです。たとえば、彼はrpasswordをダウンロードしました。これは、Pythonのgetpass関数と同様に、端末に入力するときにパスワード文字を非表示にするツールです。~~これは、私がコードに持っていない多くのものの1つです。~~この推奨事項のおかげで、Linuxのgetpassサポートを追加しました。また、元のGoソースからコピーしたエスケープシーケンスのおかげで、ターミナルにテキストフォーマットを追加しました。

ライブラリ

graphqlについてほとんど理解していないので、どこから始めればよいのかわかりませんでした。 code.dlang.orgで「graphql」を検索すると、「graphqld」という名前の対応するライブラリが見つかりました。しかし、それを研究した後、それは実際のクライアントというよりもvibe.dプラグインのように見えるように思えました。

Firefoxでネットワーク要求を調べた後、このプロジェクトでは、HTTPクライアントを使用して送信するgraphql要求と変換を簡単にシミュレートできることに気付きました。応答は、std.jsonパッケージによって提供されるツールを使用して解析できる単なるJSONオブジェクトです。このことを念頭に置いて、私はHTTPクライアントを探し始め、要求に落ち着きました。これは使いやすいHTTPクライアントですが、さらに重要なことに、ある程度の成熟度に達しています。

ネットワークアナライザーからの送信要求をコピーして、別々の.graphqlファイルに貼り付け、それをインポートして、適切な変数とともに送信しました。プロジェクトの必要に応じてさまざまなエンドポイントと構成を挿入したかったため、ほとんどの機能がGraphQLRequest構造に組み込まれました。

ソース

struct GraphQLRequest
{
    string operationName;
    string query;
    JSONValue variables;
    Config configuration;

    JSONValue toJson()
    {
        return JSONValue([
            "operationName": JSONValue(operationName),
            "variables": variables,
            "query": JSONValue(query),
        ]);
    }

    string toString()
    {
        return toJson().toPrettyString();
    }

    Response send()
    {
        auto request = Request();
        request.addHeaders(["Authorization": configuration.get("token", "")]);
        return request.post(
            configuration.get("endpoint"),
            toString(),
            "application/json"
        );
    }
}

これがパケット交換スニペットです。次のコードは認証を処理します。

struct Session
{
    Config configuration;

    void login(string username, string password)
    {
        auto request = createSession(username, password);
        auto response = request.send();
        response.throwOnFailure();
        string token = response.jsonBody
            ["data"].object
            ["createSession"].object
            ["token"].str;
        configuration.put("token", token);
    }

    GraphQLRequest createSession(string username, string password)
    {
        enum query = import("createSession.graphql").lineSplitter().join("\n");
        auto variables = SessionPayload(username, password).toJson();
        return GraphQLRequest("createSession", query, variables, configuration);
    }
}

struct SessionPayload
{
    string email;
    string password;

    //todo : make this a template mixin or something
    JSONValue toJson()
    {
        return JSONValue([
            "email": JSONValue(email),
            "password": JSONValue(password)
        ]);
    }

    string toString()
    {
        return toJson().toPrettyString();
    }
}

ネタバレ注意-私はこれまでこれを行ったことがありません。

すべては次のように行われます。main（）関数は、コマンドライン引数からConfig構造を作成し、それをSession構造に挿入します。これにより、login、logout、およびstatusコマンドの機能が実装されます。 createSession（）メソッドは、対応する.graphqlファイルから実際のクエリを読み取り、それに伴って変数を渡すことにより、graphQLクエリを作成します。私は自分のソースコードをgraphQLの突然変異とクエリで汚染したくなかったので、それらを.graphqlファイルに移動し、コンパイル時にenumとimportを使用してインポートしました。後者では、stringImportPaths（デフォルトではview /）を指すコンパイラフラグが必要です。

login（）メソッドに関しては、その唯一の責任はHTTP要求を送信し、応答を処理することです。この場合、それほど慎重ではありませんが、潜在的なエラーを処理します。次に、トークンを構成ファイルに格納します。これは、実際には優れたJSONオブジェクトにすぎません。

throwOnFailureメソッドは、クエリライブラリのコア機能の一部ではありません。これは実際には、いくつかの迅速で汚いエラー処理を行うヘルパー関数です。

void throwOnFailure(Response response)
{
    if(!response.isSuccessful || "errors" in response.jsonBody)
    {
        string[] errors = response.errors;
        throw new RequestException(errors.join("\n"));
    }
}

DはUFCSをサポートしているため、throwOnFailure（応答）構文はresponse.throwOnFailure（）として書き直すことができます。これにより、send（）などの他のメソッド呼び出しに簡単に埋め込むことができます。プロジェクト全体でこの機能を使いすぎていた可能性があります。

エラー処理

Dは、エラー処理に関しては例外を優先します。理論的根拠はここで詳細に説明されています。私が気に入っていることの1つは、明示的に接続しない限り、未処理のエラーが最終的にポップアップすることです。これが、単純化されたエラー処理から逃れることができた理由です。たとえば、次の行で：

string token = response.jsonBody
    ["data"].object
    ["createSession"].object
    ["token"].str;
configuration.put("token", token);

応答本文にトークンまたはそれにつながるオブジェクトが含まれていない場合、例外がスローされます。これは、メイン関数でバブルし、ユーザーの前で爆発します。 Goを使用する場合は、すべてのステップでエラーに非常に注意する必要があります。そして、率直に言って、関数が呼び出されるたびにerr！= Nullの場合に書き込むのは面倒なので、単にエラーを無視したくなるでしょう。ただし、Goについての私の理解は原始的であり、コンパイラがエラーリターンで何もしないことであなたに吠えても驚かないので、間違っている場合は遠慮なく訂正してください。

元のブログ投稿で説明されている錆びたスタイルのエラー処理は興味深いものでした。 D標準ライブラリにはこのようなものはないと思いますが、サードパーティのライブラリとして実装することについては議論がありました。

Webソケット

ウォッチコマンドの実装にwebsocketを使用しなかったことを簡単に指摘したいと思います。Vibe.dのwebsocketクライアントを使用しようとしましたが、接続を閉じ続けたため、ハッシュトラックバックエンドでは機能しませんでした。結局、私はそれが嫌われているにもかかわらず、循環ポーリングを支持してそれを捨てました。クライアントは別のWebサーバーでテストしてから動作しているので、将来これに戻る可能性があります。

継続的インテグレーション

CIの場合、アーティファクトの最適化されたビルドが確実にダウンロードされるように、通常のブランチビルドとマスターリリースの2つのビルドジョブを設定しました。

約写真は組み立て時間を示しています。依存関係のロードを考慮に入れます。依存関係なしで再構築〜4秒

メモリ消費

元のブログ投稿で説明されているように、/ usr / bin / time -v ./hashtrack--listコマンドを使用してメモリ使用量を測定しました。メモリ使用量がユーザーがフォローしているハッシュタグに依存するかどうかはわかりませんが、dub build -breleaseでコンパイルされたDプログラムの結果は次のとおりです。

最大常駐セットサイズ（kバイト）：10036

最大常駐セットサイズ（kバイト）：10164

最大常駐セットサイズ（kバイト）：9940

最大常駐セットサイズ（kバイト）：10060

最大常駐セットサイズ（kバイト）：10008

悪くない。ハッシュトラックユーザーでGoバージョンとRustバージョンを実行したところ、次の結果が得

られました。gobuild -ldflags "-s -w"でビルドされたGo：

最大常駐セットサイズ（kバイト）：13684

最大常駐セットサイズ（kバイト）：13820

最大常駐セットサイズ（kバイト）：13904

最大常駐セットサイズ（kバイト）：13796

最大常駐セットサイズ（kバイト）：13600

貨物ビルドでコンパイルされた錆-リリース：

最大常駐セットサイズ（kバイト）：9224

最大常駐セットサイズ（kバイト）：9192

最大常駐セットサイズ（kバイト）：9384

最大常駐セットサイズ（kバイト）：9132

最大常駐セットサイズ（kバイト）：9168

Upd：Redditユーザーskocznymrocznyは、LDCおよびGDCコンパイラーのテストも推奨しました。結果は次の

とおりです。dubbuild-brelease --compiler = ldc2によってコンパイルされたLDC1.22（カラー出力とgetpassを追加した後）

最大常駐セットサイズ（kバイト）：7816

最大常駐セットサイズ（kバイト）：7912

最大常駐セットサイズ（kバイト）：7804

最大常駐セットサイズ（kバイト）：7832

最大常駐セットサイズ（kバイト）：7804

Dにはガベージコレクションがありますが、スマートポインター、および最近ではRustに触発された実験的なメモリ管理方法もサポートしています。これらの関数が標準ライブラリとどの程度統合されているか完全にはわからないため、GCにメモリを処理させることにしました。コードを書いているときにメモリ消費について考えていなかったことを考えると、結果はかなり良いと思います。

バイナリサイズ

Rust, cargo build --release: 7.0M

D, dub build -b release: 5.7M

D, dub build -b release --compiler=ldc2: 2.4M

Go, go build: 7.1M

Go, go build -ldflags "-s -w": 5.0M

.. — , , . Windows dub build -b release 2 x64 ( 1.5M x86-mscoff) , Rust Ubuntu18 - openssl, ,

Dは、このようなコマンドラインツールを作成するための信頼できる言語だと思います。標準ライブラリには必要なもののほとんどが含まれていたため、外部の依存関係にはあまり行きませんでした。コマンドライン引数の解析、JSONの処理、ユニットテスト、HTTPリクエストの送信（cURLを使用）などはすべて、標準ライブラリで利用できます。標準ライブラリに必要なものがない場合は、サードパーティのパッケージが存在しますが、この領域にはまだ改善の余地があると思います。一方、NIHの考え方がここで発明されていない場合、またはオープンソース開発者として簡単に影響を与えたい場合は、間違いなくDエコシステムを

気に入るはずです。私がDを使用する理由

はい

コマンドラインユーティリティをGo / RustからDに移植する