ara - クラウド上のオンライン

プログラム：

NAME

ara - Debian パッケージ データベースに対してブール正規表現クエリを実行するためのユーティリティ

SYNOPSIS

バッチ モード：
コンゴウインコ [オプション] クエリ

バッチモードでは、 コンゴウインコ XNUMX つ以上のクエリを引数として受け取り、データベース ファイルを読み取ります
設定に従って結果を出力します。 (Linuxで言うところのstdout）.

対話 モード：
コンゴウインコ [オプション] -i

-i or -相互の作用 オプションは、 コンゴウインコ データベース ファイルを読み取り、プロンプトを表示します。
クエリまたはコマンドのユーザー。 結果が表示されます（次のようなポケベルを使用します）。
他には？ or less 必要に応じて)、そして コンゴウインコ ユーザーに再度プロンプトを表示します。 インタラクティブモードが強力
パッケージ データベースのロードには時間がかかる可能性があるため、推奨されますが、ロードされるとクエリが実行されます。
かなり速いです。 これは大きな利点です コンゴウインコ などのツールを介して dpkg-iasearch or
dpkg-dctrl.

キーバインディングについては、を参照してください。 キー バインディング.

グラフィカル インタフェース (GTK2):
グラフィカルインターフェース、 シャーラ(1)、Debian パッケージによって提供されます xara-gtk.

クエリー 構文
ジョブの設定方法については、 例 簡単な紹介のセクション。 シャーラ にはいくつかの組み込みヘルプがあります。 の
構文については以下で詳しく説明します。

DESCRIPTION

コンゴウインコ & シャーラ ユーザーが Debian ソフトウェア パッケージ データベース (以下を含む) を検索できるようにします。
インストールされているパッケージとアンインストールされているパッケージ)、次のブール値の組み合わせで構成される強力なクエリを使用します。
パターンによって指定されたフィールドに作用する正規表現。

たとえば、次のクエリは セクション=ユーティリティ & 依存:(gtk or tk8 or xlib or KDE or ノーム or qt)
& Debianの & パッケージ セクションにパッケージが表示されます ユーティリティ グラフィカルなもの
インターフェイス (グラフィカル ツールキットまたは X11 ライブラリに依存するため)、およびそのインターフェイス
説明には単語が含まれています Debianの & パッケージ.

理論的根拠

Debian ユーザーはコマンドを使用してソフトウェアを簡単にインストールできます 選択しない or apt-get install.
(Debian 3.1 不安定版では) 30,000 以上のパッケージから選択できます。 正しいものを見つける
パッケージはかなり難しいかもしれません。 パッケージは大雑把なセクションに分類されていますが、
パッケージがまだ多すぎて、すべての説明を読むのは問題外です。

データベース ファイルは巨大で、メールに似た構文のため検索が困難です。
grep のような行指向のツール。 などのコマンドが存在します dpkg-iasearch（1）または
dpkg-dctrl(1) ただし、その機能には制限があります。 グラフィカルなパッケージ管理ツールなど
as 適性 or シナプスの 検索機能があります。 それでも コンゴウインコ 呼び出すことができます apt インストールするか、
パッケージを削除すると、その方向性は強力な検索ツールになります。 確かにその名前は、 コンゴウインコ
トルコ語の動詞の命令形に由来する 検索 「探す」という意味です。

ザ デビアン PACKAGE DATABASE

Debian パッケージのデータベースは、次の場所にある巨大なテキスト ファイルです。 / var / lib / dpkg / available （または
以下のテキスト ファイルのコレクション / var / lib / apt / lists /）。 これらのファイルはメールボックスのような場所にあります
形式であり、一般的なエントリは次のようになります。

優先度: 必須
セクション: ベース
設置サイズ：460
出身地: デビアン
メンテナ: Dpkg 開発[メール保護]>
バグ: debugs://bugs.debian.org
アーキテクチャ：i386
出典: dpkg
バージョン：1.10.24
置き換え: dpkg (<< 1.10.3)
依存: libc6 (>= 2.3.2.ds1-4)、...
ファイル名: pool/main/d/dpkg/dselect_1.10.24_i386.deb
サイズ：119586
MD5sum: c740f7f68dab08badf4f60b51a33500a
説明: Debian パッケージを管理するためのユーザー ツール
dselect は、インストール、削除、および
Debian パッケージの管理。 dpkg のフロントエンドです。

したがって、各パッケージは一連のフィールド (パッケージ、説明、バージョンなど) によって記述されます。

QUERY 構文 そして セマンティクス

ここでは、クエリ構文について詳しく説明します。 バージョン 1.0 以降、 コンゴウインコ 新しいものを紹介し、
簡略化された構文は非常に伝統的であり、使用したことがある人には馴染みがあるはずです。
サーチエンジン。 検索語を単純に組み合わせると、 そして, OR & NOT ブール演算子。
見てみると、 例 このマニュアルの最後にあるセクションを参照してください。
出発点。

セットを検討してください D ファイルに含まれる Debian パッケージの説明
/ var / lib / dpkg / available (または以下のファイル内) / var / lib / apt / lists /）。 それぞれの説明は、
形式のカップルのセット （F V） コラボレー f & v 文字列です: f フィールドの名前です
(つまり、 パッケージ, 説明, ファイル名, 依存など） v はその値です。 したがって D セットです
カップルのセットが宇宙を形成します。 ユニバースのサブセットを選択するクエリ D.
出力オプションでは、ユニバースの選択した部分のどのフィールドを表示するかを選択します。
それらを表示する方法。

クエリ
A クエリー アトミック式のブール値の組み合わせです。 アン アトミック 表現 を選択します
セットのサブセット D 説明の。 私はこのセットを 意味 表現の； もし e
は原子式を表し、その意味は次のように表されます。 [e]。 ブール値の意味
アトミック式の組み合わせは、その意味のブール値の組み合わせにすぎません。
構成要素。 言い換えれば、もし e1 & e2 がアトミック式である場合、 e1 & e2 　
クエリ。その意味は、次の意味の交差です。 e1 & e2; そしてその意味は
e1 | e2 の意味の結合です e1 & e2.

アトミック 表現
アトミック式には次の形式があります。 パターン, /正規表現/, 引用文字列, フィールドスペック
operator1 文字列または フィールドスペック operator2 正規表現.

ブーリアン 演算子 & 定数
e1 & e2 （また、 e1 そして e2, e1 & e2)
これは論理積 (集合積集合) です。 [e1] の交点を返します。
および [e2]、つまり e1 と e2 の両方を満たすパッケージ。

e1 | e2 （また、 e1 OR e2, e1 or e2)
これが論理和（集合結合）です。 [e1] と [e2] の結合、つまりパッケージ
e1、e2、または両方を満たす。

!e1 （また、 NOT e1, e1)
これは論理否定（集合の補数）です。 [e1] の補数、つまりパッケージ
e1を満たしていない。

ということに注意してください ~ は現在のデフォルトのフィールド指定子を表し、
補完演算子のエイリアス。

true （また、 を)
すべての説明のセット、つまりすべてのパッケージ。

false （また、 なし）
空のセット、つまりパッケージがありません。

フィールド 指定子
フィールド指定子 フィールドスペック フィールド パターンのカンマ区切りのリストです。

フィールド パターンは単純なシェル パターンのようなもので、スター文字が含まれる場合があります (
何かを表します）または疑問符（任意の XNUMX 文字を表します）。 彼らです
大文字小文字を区別しません。 一連のフィールドを指定します。

例えば、 説明 & 説明 フィールドのセットを指定する { 説明 }、一方、
デ・ 指定する { 説明、 依存 }.

特別な指定子 ~ 現在のデフォルト指定子を示します (以下を参照)。

電流プローブ フィールド 指定子 & 簡略化されました アトミック 表現
フィールド指定子を繰り返す必要があるため、上記の構文が煩雑になる可能性があります。 それが理由です
がある 現在 フィールド 指定子。 指定されている現在のフィールドは、デフォルトでは、
説明、パッケージ。 簡略化されたアトミック表現は単なる単語または簡略化されたシェルです
式 (二重引用符で囲む必要はありません) で検索されます。
現在のフィールド指定子のフィールド。 文字、数字、アンダースコア、
ダッシュとピリオド。 これらには、次のように解釈される疑問符の星が含まれる場合があります。
フィールド パターン (つまり、単純化されたシェル式として)。 二重引用符が使用されている場合、その他の
文字とスペースが使用できます。

クエリ内のデフォルトのフィールド指定子 クエリー に変更することができます フィールドスペック 単に
クエリにプレフィックスを付ける フィールド仕様:。 これは与える フィールド仕様:クエリ。 ただし、 クエリー is
複雑な (つまり、バイナリ ブール演算子を含む) を囲む必要があります クエリー in
次のように括弧 フィールド仕様:(クエリ1 or クエリ2).

文字列 リテラル
文字列 リテラル 二重引用符の有無にかかわらず指定できます。 二重引用符なしでは、
構文は C の識別子と同じですが、ダッシュを使用できる点が異なります。
ラテン文字 ([a-zA-Z]) ラテン文字、XNUMX 進数、または
アンダースコア ([a-zA-Z0-9_]）。 二重引用符内では、次の場合を除くすべての文字を使用できます。
二重引用符の前にバックスラッシュを付ける必要があります。

Variables
クエリの結果は変数に保存でき、後で呼び出すことができます。 これは違います
バッチ モードでは非常に便利ですが、インタラクティブ モードやグラフィカル モードでも役立ちます。

変数名はドルで始まり、変数の通常の規則に従います。
英数字とアンダースコア、ダッシュなどの記号を任意に組み合わせて使用​​できます。

変数名では大文字と小文字が区別されるため、 $インストール済み & $インストール済み 異なっています。

クエリの結果 (パッケージのセット) を名前付きの変数に割り当てるには $変数
クエリを実行するだけです $変数 := クエリー。 次に、この特定のセットを呼び出すことができます。
ただ書いているだけ $変数.

例： $インストール済み := ステータス:(インストール済み & ！インストールされていない）

オペレーター
階層比較演算子は、角度の方向を変更することで無効にできます。
括弧と末尾の等号の追加または削除 (<= になる >）。 その他のオペレーター
は次のように否定されます。 = になる != & =~ になる !~。

フィールド仕様=文字列
フィールドを持つパッケージを選択するアトミック式 フィールドスペック 値aを持つ
正確に等しい値 文字列.

フィールドスペック (フィールド仕様<=文字列、 フィールド仕様>文字列、 フィールド仕様>=文字列)
フィールドを持つパッケージを選択するアトミック式 フィールドスペック その値は
厳密に未満 文字列。 使用される順序は、Debian のバージョン順です。 これ
順序は、整数の自然順序および Debian バージョンと互換性があります。
数字。 特殊文字を含まない文字列を比較する場合、文字はソートされます。
私たちが慣れ親しんでいる辞書編集的な ASCII 順序とは対照的に、数字の前に配置されます。 これはつまり
5 進数 (MDXNUMX 合計など) は通常の順序ではありません。

注意してください 文字列 は演算子の右側になければなりません (つまり、次のように書くことはできません)
1000 < サイズ).

フィールドスペック=~/式/ （また、 フィールド仕様:/式/)
フィールドに名前が付けられている説明を選択します フィールドスペック 存在し、その値が一致する、
大文字と小文字が区別される正規表現 表現.

フィールドスペック=~/式/i （また、 フィールド仕様:/式/i)
上記と同じですが、正規表現では大文字と小文字が区別されません。

フィールドスペック=~/式/w （また、 フィールド仕様:/式/w)
上記と同じですが、正規表現は大文字と小文字が区別され、次の場合にのみ一致します。
単語の境界線。 文字から数字へ、または数字から文字への遷移は次のように行われることに注意してください。
単語の境界とみなされます。

フィールドスペック=~/式/iw （また、 フィールド仕様:/式/iw)
ここでの正規表現は大文字と小文字が区別されず、単語の境界で一致します。

レギュラー 表現
正規表現は、一対のスラッシュの間に指定されます。 最後のスラッシュの後には
フラグを表す文字の可換シーケンス。 正規表現の構文は sed に似ています。
括弧と代替文字をグループ化する場合はバックスラッシュで囲む必要があります。 詳細については、「
Str モジュールに関する Objective Caml マニュアルの章。 要するに （x,x1,x2 メタシンボルです
正規表現を示します):

/./ 任意の文字。

/トト/ リテラル文字列 toto。

/x1x2/ 連結。

/x1\|x2/
交代。

\(x1\)*
スタークロージャー。

[CD] 文字範囲。

\b 単語の境界。

/x/i 大文字小文字を区別しません。

/x/w 単語の境界で。

リマーク
ほとんどのクエリには、かなりの量のシェル メタキャラクタが含まれます。 例えば、
論理和はパイプ文字で示され、既知のすべてのシェルで使用されます。
実際のコマンド名が
使用されている表現。 したがって、エラーによって UNIX パイプラインを正常にセットアップすることはできません。
もっともらしい。

電話するとき コンゴウインコ バッチ モードのコマンド ラインから、保護することを強くお勧めします。
クエリを単純な引用符で囲みます。 のようなことは決して書かないでください コンゴウインコ
パック*=~/停止|再起動|シャットダウン/ これによりシステムが再起動される可能性が非常に高いため（そして
正規表現構文が正しくない場合、 停止する or リブート or shutdown 意味: パイプは次のとおりでなければなりません
バックスラッシュ)。 代わりに、次のように書く必要があります。 コンゴウインコ 'パック*=~/停止\|再起動\|シャットダウン /'

OPTIONS

操作
-相互の作用, -i
インタラクティブモード; クエリのプロンプトが表示されたら、それを表示します。

-config (また シャーラ)
設定ファイル名を設定します（デフォルト $HOME/.ara/ara.config).

-noconfig
構成ファイルを作成しようとしないでください。

-履歴はありません
コマンド履歴を保存しない

カスタマーサービス オプション
-助けて (また シャーラ)
ヘルプを表示する

-だいたい 著作権、感謝、献身を表示します。

-バージョン, -だいたい (また シャーラ)
作成者、ライセンス、バージョン、および献辞を出力します (CLI から呼び出された場合は終了します)。

-例
終了例を含むいくつかのドキュメントを表示します。

-q
クエリ (例: depend:xlibs & !package:xcalc)。

-クエリ
同上。

オプション 関連する 〜へ 　 ターミナル
-進捗 (-進捗なし)
データベースのロード時に進行状況インジケーターを表示するかどうかを指定します。

-ライン
インタラクティブ表示用の端末の高さを設定します。 デフォルトでは、これは次から取得されます。
環境変数 LINES または、未定義の場合は 25 となります。

-列
インタラクティブ表示用の端末の幅を設定します。 デフォルトでは、これは次から取得されます。
環境変数 COLUMNS または、未定義の場合は 25 となります。

-ページャ (-ノページャー)
対話モードで長い出力を表示するページャーを使用します (または使用しません)。 ポケベル
コマンドは設定ファイルで定義されています $HOME/.ara/ara.config。 デフォルトでは
これは /etc/alternatives/ページャー。 ページャーは、出力サイズが異なる場合にのみ使用されます。
端子の高さを超えています。

-デバッグ (また シャーラ)
デバッグ情報を有効にする

-デバッグレベル (また シャーラ)
デバッグ レベルを設定します (高いほど冗長になります、最大は 100、デフォルトは 10)

ディスプレイ スタイル
-新着 各パッケージの最新バージョンのみを表示します。

-古い パッケージのすべてのバージョンをリストします。

-ショート
クエリを満たすパッケージの名前 (および、場合はそのバージョン) を表示します。 -古い が設定されています）、
XNUMX 行に複数のパッケージ。

-リスト
同じですが、XNUMX 行に XNUMX つのパッケージ名が表示され、中括弧は表示されません (デフォルト)。

-生
クエリを満たすパッケージごとに、選択されたフィールドをすべて表示します。

-表
結果を表として表示します。

-国境を超えた人
表形式の出力には ASCII 境界線を描画しないでください。

-ボーダー
表形式の出力用に ASCII 境界線を描画します。

-カウント
一致するパッケージの数を表示します。

-田畑
出力を指定されたフィールドに制限します。 オプションの幅指定子は、
-表 オプションであり、それ以外の場合は無視されます。 すべてのフィールドを表示するには * を使用します (ただし、必ず
スター文字をシェルからエスケープします)。

-ast 解析されたクエリの抽象構文ツリーを標準エラー出力にダンプします。

例

コンゴウインコ 'セクション=ユーティリティ'
セクション utils にすべてのパッケージの名前をリストします。

コンゴウインコ 'セクション=ユーティリティ & !依存:(gnome|kde|gtk)'
... 依存関係フィールドが正規表現 gnome\|kde\|gtk に一致するものを除く

コンゴウインコ -リスト 'セクション=ユーティリティ & ステータス:(インストール済み & ！インストールされていない）'
セクションにインストールされているすべてのパッケージをリストします ユーティリティ.

コンゴウインコ -ショート 'セクション=ユーティリティ & !依存:(gtk|gnome|kde) & 優先度=オプション'
... XNUMX 行に複数の名前をリストし、オプションのパッケージのみを表示します。

コンゴウインコ -ショート 'セクション=ユーティリティ & (!依存:(gtk|gnome|kde) | サイズ<100000) & 優先度=オプション'
gtk、gnome、または kde のものは 100000 バイト以上の場合にのみ除外してください。

コンゴウインコ -国境を超えた人 -田畑 パッケージ、サイズ、メンテナ:20 -表 \
-ショート 'セクション=ユーティリティ & (!依存:(gtk|gnome|kde) | サイズ<100000) & 優先度=オプション'

... 上記の結果の Package、Size、Maintainer フィールドを素敵な ASCII として表示します。
テーブルでは、メンテナ フィールドを 20 文字に制限していますが、粗雑な ASCII 境界線はありません。

コンゴウインコ -古い -田畑 パッケージ:8、サイズ、説明:100 \
-表 'セクション=ゲーム & (依存:(gtk|sdl|kde|opengl|gnome|qt)
or /撃つ\|殺す\|破壊する\|爆破\|レース\|爆弾/iw
or /マルチ\(-\|\)プレイヤー\|戦略\|征服\|3\(-\|\)d/iw)
& 依存:(xlibs or vga)
& サイズ <= 1000000 '

125 列の表示を想定して、パッケージ名の最初の XNUMX 文字を表示します。
バイト単位のサイズ、および説明の (最初の行) の最初の XNUMX 文字
サイズが XNUMX 万バイトを超えないゲーム セクション内のすべてのパッケージ、および
GTK、SDL、KDE、OpenGL、Qt、Gnome などの高度なものに依存しないものについては言及しないでください。
説明の中に何らかの形の暴力（銃撃、殺害など）が記載されていない
マルチプレイヤー、戦略、征服、または XNUMX 次元として、しかもいずれかの xlib に依存します
または svga を使用してコンソールベースのゲームを除外します。

SPEED

コンゴウインコ データベース全体をメモリに読み取り、クエリを処理します。 データベースがあるので、
通常は大きいため、時間がかかります。 ただし、クエリは非常に高速に実行されます。 したがって、指定します
複数のクエリを使用するか、 -相互の作用 の読み取りコストを償却するオプション
データベース。

onworks.net サービスを使用してオンラインで Ara を使用する