crepe
v0.1.8
Crepeは、Datalogのような構文を使用して、Rustで宣言的論理プログラムを作成できるライブラリです。効率的で安全なコードを生成し、Rustプログラムとシームレスに相互運用する手続き的マクロを提供します。
@input関係を初期化するタイプフェイ方法以下のプログラムでは、指示されたグラフの推移的閉鎖を計算します。 crepe!マクロ。
use crepe :: crepe ;
crepe ! {
@input
struct Edge ( i32 , i32 ) ;
@output
struct Reachable ( i32 , i32 ) ;
Reachable ( x , y ) <- Edge ( x , y ) ;
Reachable ( x , z ) <- Edge ( x , y ) , Reachable ( y , z ) ;
}
fn main ( ) {
let mut runtime = Crepe :: new ( ) ;
runtime . extend ( [ Edge ( 1 , 2 ) , Edge ( 2 , 3 ) , Edge ( 3 , 4 ) , Edge ( 2 , 5 ) ] ) ;
let ( reachable , ) = runtime . run ( ) ;
for Reachable ( x , y ) in reachable {
println ! ( "node {} can reach node {}" , x , y ) ;
}
}出力:
node 1 can reach node 2
node 1 can reach node 3
node 1 can reach node 4
node 1 can reach node 5
node 2 can reach node 3
node 2 can reach node 4
node 2 can reach node 5
node 3 can reach node 4
クレープでもっと多くのことができます。次の例では、層状否定、錆発現構文、および半ナーブ評価を使用して、最大のMAX_PATH_LENで長さの加重グラフ内のすべてのパスを見つける方法を示しています。
use crepe :: crepe ;
const MAX_PATH_LEN : u32 = 20 ;
crepe ! {
@input
struct Edge ( i32 , i32 , u32 ) ;
@output
struct Walk ( i32 , i32 , u32 ) ;
@output
struct NoWalk ( i32 , i32 ) ;
struct Node ( i32 ) ;
Node ( x ) <- Edge ( x , _ , _ ) ;
Node ( x ) <- Edge ( _ , x , _ ) ;
Walk ( x , x , 0 ) <- Node ( x ) ;
Walk ( x , z , len1 + len2 ) <-
Edge ( x , y , len1 ) ,
Walk ( y , z , len2 ) ,
( len1 + len2 <= MAX_PATH_LEN ) ;
NoWalk ( x , y ) <- Node ( x ) , Node ( y ) , ! Walk ( x , y , _ ) ;
}
fn main ( ) {
let n = 256 ;
let mut edges = Vec :: new ( ) ;
for i in 0 ..n {
for j in 0 ..n {
if rand :: random :: < f32 > ( ) < 0.02 {
edges . push ( Edge ( i , j , 5 ) ) ;
}
}
}
let mut runtime = Crepe :: new ( ) ;
runtime . extend ( edges ) ;
let ( walk , nowalk ) = runtime . run ( ) ;
println ! ( "Walk: {}" , walk . len ( ) ) ;
println ! ( "NoWalk: {}" , nowalk . len ( ) ) ;
}出力:
Walk: 89203
NoWalk: 8207
最初のテストから、生成されたコードは非常に高速です。大型グラフ(〜10 6の関係)の推移的閉鎖のバリエーションは、コンパイルされたSouffleに同等の速度で実行され、コンパイル時間の一部を使用します。
ベンチマークについては、 benches/ディレクトリを参照してください。ベンチマークはcargo benchを使用して実行できます。
このマクロは、現在のモジュールにCrepe構造体と、すべての宣言された関係の構造体を生成します。これは、より大きなプログラム内にCrepeを統合するには、関連するコードを使用して独自のモジュールに配置する必要があることを意味します。詳細については、ドキュメントを参照してください。
このプロジェクトは、SouffleとFormulogに大きなインスピレーションを受けており、どちらも静的分析のためにDatalogコンパイルの同様のモデルを使用しています。