abdocode 1.2.0__tar.gz → 2.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. {abdocode-1.2.0 → abdocode-2.0.0}/PKG-INFO +29 -26
  2. {abdocode-1.2.0 → abdocode-2.0.0}/README.md +28 -25
  3. {abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/PKG-INFO +29 -26
  4. abdocode-2.0.0/hotkey_engine/core.py +2903 -0
  5. {abdocode-1.2.0 → abdocode-2.0.0}/pyproject.toml +1 -1
  6. abdocode-1.2.0/hotkey_engine/core.py +0 -1455
  7. {abdocode-1.2.0 → abdocode-2.0.0}/LICENSE +0 -0
  8. {abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/SOURCES.txt +0 -0
  9. {abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/dependency_links.txt +0 -0
  10. {abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/requires.txt +0 -0
  11. {abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/top_level.txt +0 -0
  12. {abdocode-1.2.0 → abdocode-2.0.0}/hotkey_engine/__init__.py +0 -0
  13. {abdocode-1.2.0 → abdocode-2.0.0}/setup.cfg +0 -0
{abdocode-1.2.0 → abdocode-2.0.0}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: abdocode
3
- Version: 1.2.0
3
+ Version: 2.0.0
4
4
  Summary: A Python utility library for keyboard shortcuts, file tools, audio helpers and workflow utilities
5
5
  Author-email: Abdalla Emad <19abdo9123@gmail.com>
6
6
  License: MIT
@@ -30,27 +30,24 @@ Dynamic: license-file
30
30
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
31
31
 
32
32
  ## التثبيت:
33
+ ---
34
+
33
35
  ```bash
34
36
  pip install abdocode
35
37
  ```
38
+ ## الكاتب
39
+ - name: abdalla emad
40
+ - age: 13 years
36
41
 
37
- ## شرح الدوال الرئيسية
38
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
42
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
39
43
 
40
- ### 1. إدارة الاختصارات
41
- - `add_shortcut(root, key, event)`: يسجّل اختصار لوحة مفاتيح إلى حدث مع واجهة `tkinter`.
42
- - `remove_shortcut(root, key)`: يزيل اختصارًا مسجّلًا.
43
- - `disable_all()`: يعطّل جميع الاختصارات النشطة.
44
- - `enable_all()`: يعيد تفعيل جميع الاختصارات.
45
- - `reset_all(root)`: يعيد تهيئة ملحقات الاختصارات في النافذة.
46
- - `list_shortcuts()`: يعرض قائمة الاختصارات المفعلة.
44
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
45
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
46
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
47
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
48
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
47
49
 
48
- ### 2. اختصارات جاهزة
49
- توفر المكتبة اختصارات جاهزة مثل:
50
- - `copy(root)`, `paste(root)`, `cut(root)`
51
- - `select_all(root)`, `undo(root)`, `redo(root)`
52
- - `save(root)`, `open_file(root)`, `new_file(root)`
53
- - `refresh(root)`, `print_file(root)`
50
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
54
51
 
55
52
  ### 3. لوحة الحافظة والملفات
56
53
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -183,14 +180,20 @@ pip install abdocode
183
180
 
184
181
  ---
185
182
 
186
- ## ملاحظة
187
- يمكنك استيراد المكتبة كالتالي:
188
- ```python
189
- from hotkey_engine import core
190
- ```
191
- ثم استخدام الدوال مباشرة مثل:
192
- ```python
193
- core.play('note_C4')
194
- core.add_shortcut(root, '<Control-s>', '<<Save>>')
195
- ```
183
+ ## إضافات جديدة (توليد دوال ونظام Beep للأسماء)
184
+
185
+ - مولد دوال مفيدة: تم إضافة مولد ديناميكي في `hotkey_engine.core` يمكنه إنشاء عدد كبير من الدوال المساعدة، يمكن التحكم به عبر `generate_extra_functions(count)`.
186
+ - الاستخدام النموذجي: استدعِ `generate_extra_functions(n)` لإنشاء `n` دوال مسماة فريدة تُستخدم لأغراض الاختبار والأدوات.
187
+ - هذه الدوال مُفيدة للاختبار، الأدوات، أو كمولّد يعطي نتائج صغيرة يمكن فحصها برمجياً.
188
+
189
+ - نظام "Name Beep": أضفنا نظامًا لتوليد سلسلة صوتية قصيرة تمثل اسمًا بصريًا/سمعيًا.
190
+ - `play_name_beep(name)`: يشغّل توقيعًا صوتيًا قصيرًا يمثل `name`.
191
+ - `register_name_beep(name)`: يسجّل نغمة باسم تحت المفتاح `Beep_<name>` في `sound_map`، بحيث يمكنك استدعاؤها عبر `play('Beep_<name>')`.
192
+ - `register_name_beep_group(names)`: يسجل مجموعة من الأسماء دفعة واحدة.
193
+ - `list_registered_name_beeps()`: يعيد قائمة بالمفاتيح المسجلة.
194
+ - ` beep(freq, duration, volume)`انشاء نغمة مرة واحدة فقط
195
+ ملاحظة: جودة التشغيل الصوتي تعتمد على وجود باك-أند صوتي مثل `sounddevice` أو `simpleaudio` أو `winsound` (لويندوز). إذا لم يكن أي منه متاحًا، سيحاول النظام السقوط بهدوء بدلاً من رفع استثناء.
196
+ ### شكرا لكم على وقتكم
197
+
198
+
196
199
 
{abdocode-1.2.0 → abdocode-2.0.0}/README.md RENAMED
@@ -13,27 +13,24 @@
13
13
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
14
14
 
15
15
  ## التثبيت:
16
+ ---
17
+
16
18
  ```bash
17
19
  pip install abdocode
18
20
  ```
21
+ ## الكاتب
22
+ - name: abdalla emad
23
+ - age: 13 years
19
24
 
20
- ## شرح الدوال الرئيسية
21
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
25
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
22
26
 
23
- ### 1. إدارة الاختصارات
24
- - `add_shortcut(root, key, event)`: يسجّل اختصار لوحة مفاتيح إلى حدث مع واجهة `tkinter`.
25
- - `remove_shortcut(root, key)`: يزيل اختصارًا مسجّلًا.
26
- - `disable_all()`: يعطّل جميع الاختصارات النشطة.
27
- - `enable_all()`: يعيد تفعيل جميع الاختصارات.
28
- - `reset_all(root)`: يعيد تهيئة ملحقات الاختصارات في النافذة.
29
- - `list_shortcuts()`: يعرض قائمة الاختصارات المفعلة.
27
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
28
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
29
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
30
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
31
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
30
32
 
31
- ### 2. اختصارات جاهزة
32
- توفر المكتبة اختصارات جاهزة مثل:
33
- - `copy(root)`, `paste(root)`, `cut(root)`
34
- - `select_all(root)`, `undo(root)`, `redo(root)`
35
- - `save(root)`, `open_file(root)`, `new_file(root)`
36
- - `refresh(root)`, `print_file(root)`
33
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
37
34
 
38
35
  ### 3. لوحة الحافظة والملفات
39
36
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -166,14 +163,20 @@ pip install abdocode
166
163
 
167
164
  ---
168
165
 
169
- ## ملاحظة
170
- يمكنك استيراد المكتبة كالتالي:
171
- ```python
172
- from hotkey_engine import core
173
- ```
174
- ثم استخدام الدوال مباشرة مثل:
175
- ```python
176
- core.play('note_C4')
177
- core.add_shortcut(root, '<Control-s>', '<<Save>>')
178
- ```
166
+ ## إضافات جديدة (توليد دوال ونظام Beep للأسماء)
167
+
168
+ - مولد دوال مفيدة: تم إضافة مولد ديناميكي في `hotkey_engine.core` يمكنه إنشاء عدد كبير من الدوال المساعدة، يمكن التحكم به عبر `generate_extra_functions(count)`.
169
+ - الاستخدام النموذجي: استدعِ `generate_extra_functions(n)` لإنشاء `n` دوال مسماة فريدة تُستخدم لأغراض الاختبار والأدوات.
170
+ - هذه الدوال مُفيدة للاختبار، الأدوات، أو كمولّد يعطي نتائج صغيرة يمكن فحصها برمجياً.
171
+
172
+ - نظام "Name Beep": أضفنا نظامًا لتوليد سلسلة صوتية قصيرة تمثل اسمًا بصريًا/سمعيًا.
173
+ - `play_name_beep(name)`: يشغّل توقيعًا صوتيًا قصيرًا يمثل `name`.
174
+ - `register_name_beep(name)`: يسجّل نغمة باسم تحت المفتاح `Beep_<name>` في `sound_map`، بحيث يمكنك استدعاؤها عبر `play('Beep_<name>')`.
175
+ - `register_name_beep_group(names)`: يسجل مجموعة من الأسماء دفعة واحدة.
176
+ - `list_registered_name_beeps()`: يعيد قائمة بالمفاتيح المسجلة.
177
+ - ` beep(freq, duration, volume)`انشاء نغمة مرة واحدة فقط
178
+ ملاحظة: جودة التشغيل الصوتي تعتمد على وجود باك-أند صوتي مثل `sounddevice` أو `simpleaudio` أو `winsound` (لويندوز). إذا لم يكن أي منه متاحًا، سيحاول النظام السقوط بهدوء بدلاً من رفع استثناء.
179
+ ### شكرا لكم على وقتكم
180
+
181
+
179
182
 
{abdocode-1.2.0 → abdocode-2.0.0}/abdocode.egg-info/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: abdocode
3
- Version: 1.2.0
3
+ Version: 2.0.0
4
4
  Summary: A Python utility library for keyboard shortcuts, file tools, audio helpers and workflow utilities
5
5
  Author-email: Abdalla Emad <19abdo9123@gmail.com>
6
6
  License: MIT
@@ -30,27 +30,24 @@ Dynamic: license-file
30
30
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
31
31
 
32
32
  ## التثبيت:
33
+ ---
34
+
33
35
  ```bash
34
36
  pip install abdocode
35
37
  ```
38
+ ## الكاتب
39
+ - name: abdalla emad
40
+ - age: 13 years
36
41
 
37
- ## شرح الدوال الرئيسية
38
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
42
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
39
43
 
40
- ### 1. إدارة الاختصارات
41
- - `add_shortcut(root, key, event)`: يسجّل اختصار لوحة مفاتيح إلى حدث مع واجهة `tkinter`.
42
- - `remove_shortcut(root, key)`: يزيل اختصارًا مسجّلًا.
43
- - `disable_all()`: يعطّل جميع الاختصارات النشطة.
44
- - `enable_all()`: يعيد تفعيل جميع الاختصارات.
45
- - `reset_all(root)`: يعيد تهيئة ملحقات الاختصارات في النافذة.
46
- - `list_shortcuts()`: يعرض قائمة الاختصارات المفعلة.
44
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
45
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
46
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
47
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
48
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
47
49
 
48
- ### 2. اختصارات جاهزة
49
- توفر المكتبة اختصارات جاهزة مثل:
50
- - `copy(root)`, `paste(root)`, `cut(root)`
51
- - `select_all(root)`, `undo(root)`, `redo(root)`
52
- - `save(root)`, `open_file(root)`, `new_file(root)`
53
- - `refresh(root)`, `print_file(root)`
50
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
54
51
 
55
52
  ### 3. لوحة الحافظة والملفات
56
53
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -183,14 +180,20 @@ pip install abdocode
183
180
 
184
181
  ---
185
182
 
186
- ## ملاحظة
187
- يمكنك استيراد المكتبة كالتالي:
188
- ```python
189
- from hotkey_engine import core
190
- ```
191
- ثم استخدام الدوال مباشرة مثل:
192
- ```python
193
- core.play('note_C4')
194
- core.add_shortcut(root, '<Control-s>', '<<Save>>')
195
- ```
183
+ ## إضافات جديدة (توليد دوال ونظام Beep للأسماء)
184
+
185
+ - مولد دوال مفيدة: تم إضافة مولد ديناميكي في `hotkey_engine.core` يمكنه إنشاء عدد كبير من الدوال المساعدة، يمكن التحكم به عبر `generate_extra_functions(count)`.
186
+ - الاستخدام النموذجي: استدعِ `generate_extra_functions(n)` لإنشاء `n` دوال مسماة فريدة تُستخدم لأغراض الاختبار والأدوات.
187
+ - هذه الدوال مُفيدة للاختبار، الأدوات، أو كمولّد يعطي نتائج صغيرة يمكن فحصها برمجياً.
188
+
189
+ - نظام "Name Beep": أضفنا نظامًا لتوليد سلسلة صوتية قصيرة تمثل اسمًا بصريًا/سمعيًا.
190
+ - `play_name_beep(name)`: يشغّل توقيعًا صوتيًا قصيرًا يمثل `name`.
191
+ - `register_name_beep(name)`: يسجّل نغمة باسم تحت المفتاح `Beep_<name>` في `sound_map`، بحيث يمكنك استدعاؤها عبر `play('Beep_<name>')`.
192
+ - `register_name_beep_group(names)`: يسجل مجموعة من الأسماء دفعة واحدة.
193
+ - `list_registered_name_beeps()`: يعيد قائمة بالمفاتيح المسجلة.
194
+ - ` beep(freq, duration, volume)`انشاء نغمة مرة واحدة فقط
195
+ ملاحظة: جودة التشغيل الصوتي تعتمد على وجود باك-أند صوتي مثل `sounddevice` أو `simpleaudio` أو `winsound` (لويندوز). إذا لم يكن أي منه متاحًا، سيحاول النظام السقوط بهدوء بدلاً من رفع استثناء.
196
+ ### شكرا لكم على وقتكم
197
+
198
+
196
199