اللهجات   YARA, YARA-L, YARA-X
المحللات    محلل قياسي، محلل موحد، محلل تدفقي
المخرجات    YARA, JSON, YAML, عروض شجرة AST
الأدوات    CLI، زوار، بناة، تسلسل، فحوصات دلالية

pip install yaraast

git clone https://github.com/seifreed/yaraast.git
cd yaraast
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e .

import yaraast

yara_code = """
rule example {
    strings:
        $a = "malware" nocase
    condition:
        $a
}
"""

document = yaraast.parse(yara_code)
print(document.ast.rules[0].name)

# تحليل وطباعة YARA معياري
yaraast parse rules.yar

# تحليل إلى JSON
yaraast parse rules.yar --format json

# تحليل مع لهجة صريحة
yaraast parse rules.yar --dialect yara-x

# التحقق من الملف (فحوصات بناء الجملة + التحليل)
yaraast validate rules.yar

# تنسيق الملف في مكانه (مُنسق قائم على AST)
yaraast fmt rules.yar

# فحص التنسيق دون تعديل الملف
yaraast fmt rules.yar --check

from pathlib import Path

import yaraast

source = "rule example { condition: true }"

# اكتشاف اللهجة تلقائيًا
document = yaraast.parse(source)

# فرض لهجة محددة
document = yaraast.parse(source, dialect="yara")

# تحليل الملفات، توليد مصدر جديد، وتنسيقه بشكل قانوني
Path("rules.yar").write_text(source, encoding="utf-8")
file_document = yaraast.parse_file("rules.yar")
generated = yaraast.generate(file_document)
formatted = yaraast.format_canonical(source, dialect="yara")

# الحفاظ على كل بايت خارج تعديل بايت UTF-8 صريح
offset = source.encode("utf-8").index(b"true")
rewritten = yaraast.rewrite_lossless(
    source,
    [yaraast.SourceEdit(offset, offset + 4, "false")],
)

# المحللات العامة تطبق حدودًا افتراضية مقيدة. تجاوزها لكل عملية عند الحاجة.
limits = yaraast.ResourceLimits(max_input_bytes=1024 * 1024, parse_deadline=5.0)
document = yaraast.parse(source, resource_limits=limits)

cancel = yaraast.CancellationToken()
cancel.cancel()
# yaraast.parse(source, cancellation_token=cancel) يرفع ParseCancelledError

from pathlib import Path

from yaraast.parser import Parser
from yaraast.visitor import BaseVisitor

class RuleCollector(BaseVisitor):
    def __init__(self):
        self.rules = []

    def visit_rule(self, node):
        self.rules.append(node.name)
        super().visit_rule(node)

ast = Parser(Path("rules.yar").read_text(encoding="utf-8")).parse()
collector = RuleCollector()
collector.visit(ast)
print(collector.rules)

# دعم LSP
pip install yaraast[lsp]

# تكامل libyara
pip install yaraast[libyara]

# أدوات الأداء
pip install yaraast[performance]

# دعم التصور
pip install yaraast[visualization]

# حزمة دعم وقت التشغيل
pip install yaraast[all]

# أدوات وقت التشغيل والتطوير
pip install yaraast[dev-all]