auto rustダウンロード - auto rustソースコードのダウンロード

auto rust

その他のソースコード

1.0.0

ダウンロード

自動錆び

auto-rustは、大規模言語モデル (LLM) の力を利用してコンパイル時にコードを生成する Rust 手続き型マクロです。関数シグネチャを記述し、必要な機能を説明するドキュメントコメントを追加して、 auto-rustに実装の詳細を入力させます。

️警告

Auto-Rust は現在開発中であり、本番環境での使用にはまだ適していません。試してみてフィードバックを提供することは歓迎ですが、実装が不完全で意図したとおりに機能しない可能性があることに注意してください。

特徴

AI を活用したコード生成: LLM の機能を活用して、仕様に基づいて Rust 関数本体を生成します。
コンパイル時の統合:使いやすい手続き型マクロを使用して、コード生成を Rust プロジェクトにシームレスに統合します。
コンテキストを意識した生成: Auto-Rust は、関数シグネチャ、ドキュメントコメント、およびプロジェクト内の一部のコードを考慮して、コンテキストに関連した実装を生成します。
組み込みキャッシュ: Auto-Rust は成功したコード生成結果をキャッシュして、開発ワークフローを加速します。不必要な LLM 呼び出しを回避し、コンパイル時間を短縮します。

はじめる

1. インストール

Cargo.tomlファイルにauto-rust依存関係として追加します。

[ dependencies ]
auto-rust = " 0.1.4 "

2. APIキー

Auto-Rust には OpenAI API キーが必要です。プロジェクトのルートに.envファイルを作成し、キーを追加します。

OPENAI_API_KEY= < your-openai-api-key >

3. 使用方法

関数に#[llm_tool]属性の注釈を付け、望ましい動作を説明する明確なドキュメントコメントを提供します。

 use auto_rust :: llm_tool ;

# [ llm_tool ]
# [ handler ]
/// The response will be an HTML layout with the name and the number of letters in the name.
/// Ensure to return a content type of text/html.
fn hello ( Path ( name ) : Path < String > ) -> impl IntoResponse {
    todo ! ( )
}

live引数を使用したライブリロード

シームレスな開発のためにライブリロードを有効にするには、 llm_toolマクロのlive引数を使用します。

 # [ llm_tool ( live ) ]

liveリロードを有効にすると、Auto-Rust はキャッシュメカニズムをバイパスします。コンパイルのたびに LLM にリクエストが送信され、関数シグネチャ、ドキュメントコメント、現在のコードベースコンテキストに基づいて常に最新のコード生成を受け取ることができます。

キャッシュの仕組み

Auto-Rust は単純なキャッシュメカニズムを実装しています。関数のコードを生成するたびに、次のようになります。

関数のシグネチャ、ドキュメントコメント、および関連するコードコンテキストに基づいてハッシュを作成します。
このハッシュは、LLM の生成されたコードを保存するために使用されます。
後続のコンパイルでは、Auto-Rust は最初に、指定されたハッシュに対してキャッシュされた結果が存在するかどうかを確認します。見つかった場合は、キャッシュされたコードが直接使用され、不必要な LLM 呼び出しが防止されます。

コンパイル時間がわずかに増加する場合でも、LLM から最新のコード生成を優先的に受け取りたい場合は、 live引数を使用します。

例

 use auto_rust :: llm_tool ;
use poem :: {
    get , handler , listener :: TcpListener , middleware :: Tracing , web :: Path , EndpointExt , IntoResponse ,
    Route , Server ,
} ;

# [ llm_tool ]
# [ handler ]
/// The response will be an html layout with the name and the number of letters in the name.
/// Ensure to return a content type of text/html.
fn hello ( Path ( name ) : Path < String > ) -> impl IntoResponse {
    todo ! ( )
}

# [ tokio :: main ]
async fn main ( ) -> Result < ( ) , std :: io :: Error > {
    // ...
}

生成されたコード:

 # [ handler ]
/// The response will be an html layout with the name and the number of letters in the name.
/// Ensure to return a content type of text/html.
fn hello ( Path ( name ) : Path < String > ) -> impl IntoResponse {
    let response_html = format ! (
    r#"
<!DOCTYPE html>
<html>
<head>
    <title>Hello, {name}!</title>
</head>
<body>
    <h1>Hello, {name}!</h1>
    <p>The length of your name is {len} letters.</p>
</body>
</html>
"# ,
    name = name,
    len = name.len ( )
) ;

poem :: Response :: builder ( )
    . header ( "Content-Type" , "text/html; charset=utf-8" )
    . body ( response_html )
}

開発者向け説明

Auto-Rust は、Rust の強力な手続き型マクロシステムを利用して、コンパイル時にコードを挿入します。 #[llm_tool]マクロを使用する場合:

解析:マクロは、名前、引数、戻り値の型、ドキュメントコメントなど、アノテーション付き関数のシグネチャを解析します。
コンテキスト抽出:プロジェクト内のコードを抽出し、LLM が周囲のコードとプロジェクトをよりよく理解できるようにコンテキストを提供します。
プロンプトエンジニアリング:抽出された情報を含むプロンプトを構築します。このプロンプトは、LLM が適切で正しい Rust 関数実装を生成できるように慎重に設計されています。
LLM インタラクション:生成されたプロンプトを LLM API に送信します。
コードの挿入:生成された Rust コードを含む LLM の応答は、コードベースに直接挿入され、 todo!()プレースホルダーを置き換えます。

制限事項

LLM 非決定性: LLM 出力は変動する可能性があります。望ましい結果を得るには、実験と反復が必要な場合があります。
限定されたコンテキスト:現在、Auto-Rust のコンテキストは主に関数のシグネチャと doc コメントに基づいています。より広範なプロジェクト構造についての認識は限られています。
依存関係の管理: Auto-Rust は、生成されたコードに新しく導入された依存関係に対するuseステートメントを自動的に追加しません。