mapchar

قم بتوليد قوائم كلمات باستخدام منطق الأنماط والتعبيرات

التثبيت    •    التوثيق    •    الاستخدام    •    المساهمة

[!NOTE] تمت إعادة تسمية هذا المشروع من fuse / fuse-generator إلى mapchar ابتداءً من الإصدار 7.0.2. لقد تغيرت حزمة PyPI وأمر CLI واسم حزمة Python تبعًا لذلك. إذا كنت تستخدم الاسم القديم، فيرجى تحديث عمليات التثبيت والاستيراد.

التثبيت

[!NOTE] يُوصى بالتثبيت باستخدام pipx أو pip للحصول على نسخة PyPI.

التوثيق

لدليل كامل وشروحات الميزات وأمثلة متقدمة، يرجى زيارة التوثيق.

الاستخدام العام

لتوليد قائمة كلمات من تعبير بسيط:

mapchar '/l{2,4}'

لدمج الملفات مع المولدات:

mapchar '^:^' names.txt pass.txt

يمكن معالجة المخرجات وتصفيتها وحفظها.

General Options:
  -h, --help            show this help message and exit
  -v, --version         show version information and exit
  -S, --stats           show pattern statistics and exit
  -q, --quiet           suppress non-essential output
  -n, --non-interactive
                        skip the confirmation prompt before execution

Generation Options:
  -d, --delimiter <string>
                        string inserted between generated entries
  -b, --write-buffer <size>
                        output buffer size
  -w, --workers <1-64>  number of worker processes (default: 1)
  -k, --flush-threshold <size>
                        flush output after reaching this byte threshold (default: 512KB)

Input Options:
  -f, --file <path>     load patterns from file
  -s, --start <word>    start writing output from <word>
  -e, --end <word>      stop writing output at <word>

Output Options:
  -o, --output <path>   write output to a file
  -z, --compress <format>
                        compress output (supported: gzip, bzip2, lzma)
  -l, --compresslevel <level>
                        compression level for the selected format

أساسيات التعبير

• تُنتج الأحرف الحرفية نفسها.
• تُنتج الفئات المضمنة والفئات المحصورة [...] عنصرًا واحدًا لكل موضع.
• الربط يجمع المواضع: يختار كل موضع قيمة واحدة من رمزه ويربطها.

مثال:

$ mapchar '/l{2,3}'
# output: aa, ab, ac, ..., ZY, ZZ

فئات الأحرف

مثال: /l/l يُنتج جميع تركيبات الحرفين (كبيرة وصغيرة).

الفئات المخصصة والاتحادات

• [abc] تختار حرفًا واحدًا من a أو b أو c.
• استخدم | لفصل بدائل الكلمات الكاملة داخل الفئة:
  • [admin|root|123] تُدرج admin أو root أو 123 في تلك النقطة.
• استخدم || لفصل التعبيرات على المستوى الأعلى:
  • mapchar 'admin/d||guest/d' يربط نمطين مستقلين.

الإحصائيات

يمكنك تحليل النمط قبل إنشائه باستخدام العلامة -S/--stats. يعرض ذلك عدد الرموز والحجم المقدر وتفاصيل تصفية النطاق.

mapchar -S '/l{3}||/d{3}'

المُحددات الكمية

• {N} — كرر بالضبط N مرة
• {min,max} — كرر بين min وmax مرة (شامل)
• ? — اختياري (0 أو 1 مرة)

أمثلة:

$ mapchar '[XYZ]{3}'         # XXX, XXY, ..., ZZZ
$ mapchar '[XYZ]{2,5}'       # XY, XZ, ..., XYZXY
$ mapchar 'Ryan?/d'          # Rya0, Rya1, ..., Ryan9
$ mapchar '[XYZ]?Ryan'       # Ryan, XRyan, YRyan, ZRyan

النطاقات الرقمية

• #[1-10] → يُنتج 1,2,3,4,5,6,7,8,9,10
• #[1-10:2] → يُنتج 1,3,5,7,9
• #[2-10:2] → يُنتج 2,4,6,8,10

يمكن استخدام هذه النطاقات الرقمية في أي موضع من التعبير.

الملفات ونقاط الاستبدال

استخدم ^ في التعبير كنقطة استبدال لوسيطة الملف التالية. يستهلك كل ^ ملفًا واحدًا ويكرر على سطوره:

$ mapchar '^/d' names.txt
# output: Bob0, Bob1, ..., Ana0, Ana1, ...

$ mapchar '^-^' names.txt years.txt
# output: Bob-1990, Ana-1991, Ryan-1992, ...

أضف // بادئة لاسم الملف لمعاملته كتعبير مضمن بدلاً من مسار ملف.

ربط القيم

استخدم <@name=expr> لتقييم تعبير مرة واحدة لكل سطر مخرج وتخزينه، ثم إعادة استخدامه باستخدام <@name>. على عكس الربط، يُقدم هذا تبعية، لذا لا يتم إنشاء منتج ديكارتي بين التعريف ومراجعه.

$ mapchar '<@d=/d>-<@d>'
# output: 0-0, 1-1, ..., 9-9

$ mapchar '<@x=^>:<@x>' words.txt
# output: foo:foo, bar:bar, ...

$ mapchar '<@n=/d{2}>_<@n>'
# output: 00_00, 01_01, ..., 99_99

الضغط

يدعم Mapchar الضغط أثناء الكتابة عند كتابة ملفات الإخراج.

# gzip (fast, balanced)
mapchar '/l{5}' -z gzip -o wordlist.txt.gz

# lzma (best compression)
mapchar '/l{5}' -z lzma -o wordlist.txt.xz

# bzip2 (middle ground)
mapchar '/l{5}' -z bzip2 -o wordlist.txt.bz2

إفلات الأحرف الخاصة

استخدم \ لإفلات الأحرف الخاصة.

$ mapchar '\/d/d'
# output: /d/0, /d/1, ..., /d/9

المساهمة

نرحب بالمساهمات في Mapchar! سواء كانت إضافة ميزات جديدة، تحسين التوثيق، أو إصلاح الأخطاء، فإن مساعدتك مقدرة. لا تتردد في فتح مشكلة أو تقديم طلب سحب على مستودع GitHub الخاص بنا في pwnfo/mapchar.

تاريخ النجوم

الرخصة

MIT © Ryan R. <[email protected]>