abdocode 1.2.0__tar.gz → 2.0.1__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 (14) hide show
  1. {abdocode-1.2.0/abdocode.egg-info → abdocode-2.0.1}/PKG-INFO +37 -27
  2. abdocode-1.2.0/PKG-INFO → abdocode-2.0.1/README.md +29 -43
  3. abdocode-1.2.0/README.md → abdocode-2.0.1/abdocode.egg-info/PKG-INFO +53 -26
  4. abdocode-2.0.1/abdocode.egg-info/requires.txt +11 -0
  5. abdocode-2.0.1/hotkey_engine/core.py +2903 -0
  6. {abdocode-1.2.0 → abdocode-2.0.1}/pyproject.toml +18 -5
  7. abdocode-1.2.0/abdocode.egg-info/requires.txt +0 -2
  8. abdocode-1.2.0/hotkey_engine/core.py +0 -1455
  9. {abdocode-1.2.0 → abdocode-2.0.1}/LICENSE +0 -0
  10. {abdocode-1.2.0 → abdocode-2.0.1}/abdocode.egg-info/SOURCES.txt +0 -0
  11. {abdocode-1.2.0 → abdocode-2.0.1}/abdocode.egg-info/dependency_links.txt +0 -0
  12. {abdocode-1.2.0 → abdocode-2.0.1}/abdocode.egg-info/top_level.txt +0 -0
  13. {abdocode-1.2.0 → abdocode-2.0.1}/hotkey_engine/__init__.py +0 -0
  14. {abdocode-1.2.0 → abdocode-2.0.1}/setup.cfg +0 -0
{abdocode-1.2.0/abdocode.egg-info → abdocode-2.0.1}/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.1
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
@@ -13,9 +13,16 @@ Description-Content-Type: text/markdown
13
13
  License-File: LICENSE
14
14
  Requires-Dist: numpy
15
15
  Requires-Dist: sounddevice
16
+ Requires-Dist: simpleaudio
17
+ Provides-Extra: audio
18
+ Requires-Dist: simpleaudio>=1.1.10; extra == "audio"
19
+ Provides-Extra: dev
20
+ Requires-Dist: pytest>=6.0; extra == "dev"
21
+ Requires-Dist: black>=21.0; extra == "dev"
22
+ Requires-Dist: pylint>=2.0; extra == "dev"
16
23
  Dynamic: license-file
17
24
 
18
- # ============/Abdo☆code\===============
25
+ # ============Abdo☆code===============
19
26
 
20
27
  مكتبة `abdocode` توفر أدوات مساعدة قوية لتطبيقات بايثون، خاصة العمليات المرتبطة بالاختصارات، إدارة الملفات، الصوت، والمزيد.
21
28
 
@@ -30,27 +37,24 @@ Dynamic: license-file
30
37
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
31
38
 
32
39
  ## التثبيت:
40
+ ---
41
+
33
42
  ```bash
34
43
  pip install abdocode
35
44
  ```
45
+ ## الكاتب
46
+ - name: abdalla emad
47
+ - age: 13 years
36
48
 
37
- ## شرح الدوال الرئيسية
38
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
49
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
39
50
 
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()`: يعرض قائمة الاختصارات المفعلة.
51
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
52
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
53
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
54
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
55
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
47
56
 
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)`
57
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
54
58
 
55
59
  ### 3. لوحة الحافظة والملفات
56
60
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -183,14 +187,20 @@ pip install abdocode
183
187
 
184
188
  ---
185
189
 
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
- ```
190
+ ## إضافات جديدة (توليد دوال ونظام Beep للأسماء)
191
+
192
+ - مولد دوال مفيدة: تم إضافة مولد ديناميكي في `hotkey_engine.core` يمكنه إنشاء عدد كبير من الدوال المساعدة، يمكن التحكم به عبر `generate_extra_functions(count)`.
193
+ - الاستخدام النموذجي: استدعِ `generate_extra_functions(n)` لإنشاء `n` دوال مسماة فريدة تُستخدم لأغراض الاختبار والأدوات.
194
+ - هذه الدوال مُفيدة للاختبار، الأدوات، أو كمولّد يعطي نتائج صغيرة يمكن فحصها برمجياً.
195
+
196
+ - نظام "Name Beep": أضفنا نظامًا لتوليد سلسلة صوتية قصيرة تمثل اسمًا بصريًا/سمعيًا.
197
+ - `play_name_beep(name)`: يشغّل توقيعًا صوتيًا قصيرًا يمثل `name`.
198
+ - `register_name_beep(name)`: يسجّل نغمة باسم تحت المفتاح `Beep_<name>` في `sound_map`، بحيث يمكنك استدعاؤها عبر `play('Beep_<name>')`.
199
+ - `register_name_beep_group(names)`: يسجل مجموعة من الأسماء دفعة واحدة.
200
+ - `list_registered_name_beeps()`: يعيد قائمة بالمفاتيح المسجلة.
201
+ - ` beep(freq, duration, volume)`انشاء نغمة مرة واحدة فقط
202
+ ملاحظة: جودة التشغيل الصوتي تعتمد على وجود باك-أند صوتي مثل `sounddevice` أو `simpleaudio` أو `winsound` (لويندوز). إذا لم يكن أي منه متاحًا، سيحاول النظام السقوط بهدوء بدلاً من رفع استثناء.
203
+ ### شكرا لكم على وقتكم
204
+
205
+
196
206
 
abdocode-1.2.0/PKG-INFO → abdocode-2.0.1/README.md RENAMED
@@ -1,21 +1,4 @@
1
- Metadata-Version: 2.4
2
- Name: abdocode
3
- Version: 1.2.0
4
- Summary: A Python utility library for keyboard shortcuts, file tools, audio helpers and workflow utilities
5
- Author-email: Abdalla Emad <19abdo9123@gmail.com>
6
- License: MIT
7
- Keywords: hotkey,utility,audio,workflow,tkinter
8
- Classifier: Programming Language :: Python :: 3
9
- Classifier: License :: OSI Approved :: MIT License
10
- Classifier: Operating System :: OS Independent
11
- Requires-Python: >=3.6
12
- Description-Content-Type: text/markdown
13
- License-File: LICENSE
14
- Requires-Dist: numpy
15
- Requires-Dist: sounddevice
16
- Dynamic: license-file
17
-
18
- # ============/Abdo☆code\===============
1
+ # ============Abdo☆code===============
19
2
 
20
3
  مكتبة `abdocode` توفر أدوات مساعدة قوية لتطبيقات بايثون، خاصة العمليات المرتبطة بالاختصارات، إدارة الملفات، الصوت، والمزيد.
21
4
 
@@ -30,27 +13,24 @@ Dynamic: license-file
30
13
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
31
14
 
32
15
  ## التثبيت:
16
+ ---
17
+
33
18
  ```bash
34
19
  pip install abdocode
35
20
  ```
21
+ ## الكاتب
22
+ - name: abdalla emad
23
+ - age: 13 years
36
24
 
37
- ## شرح الدوال الرئيسية
38
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
25
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
39
26
 
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()`: يعرض قائمة الاختصارات المفعلة.
27
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
28
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
29
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
30
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
31
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
47
32
 
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)`
33
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
54
34
 
55
35
  ### 3. لوحة الحافظة والملفات
56
36
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -183,14 +163,20 @@ pip install abdocode
183
163
 
184
164
  ---
185
165
 
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
- ```
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
+
196
182
 
abdocode-1.2.0/README.md → abdocode-2.0.1/abdocode.egg-info/PKG-INFO RENAMED
@@ -1,4 +1,28 @@
1
- # ============/Abdo☆code\===============
1
+ Metadata-Version: 2.4
2
+ Name: abdocode
3
+ Version: 2.0.1
4
+ Summary: A Python utility library for keyboard shortcuts, file tools, audio helpers and workflow utilities
5
+ Author-email: Abdalla Emad <19abdo9123@gmail.com>
6
+ License: MIT
7
+ Keywords: hotkey,utility,audio,workflow,tkinter
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.6
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ Requires-Dist: numpy
15
+ Requires-Dist: sounddevice
16
+ Requires-Dist: simpleaudio
17
+ Provides-Extra: audio
18
+ Requires-Dist: simpleaudio>=1.1.10; extra == "audio"
19
+ Provides-Extra: dev
20
+ Requires-Dist: pytest>=6.0; extra == "dev"
21
+ Requires-Dist: black>=21.0; extra == "dev"
22
+ Requires-Dist: pylint>=2.0; extra == "dev"
23
+ Dynamic: license-file
24
+
25
+ # ============Abdo☆code===============
2
26
 
3
27
  مكتبة `abdocode` توفر أدوات مساعدة قوية لتطبيقات بايثون، خاصة العمليات المرتبطة بالاختصارات، إدارة الملفات، الصوت، والمزيد.
4
28
 
@@ -13,27 +37,24 @@
13
37
  - نظام تسجيل وتدفق أحداث مع `EventBus` ومحرّك لوغاريتمي للتطبيقات البسيطة.
14
38
 
15
39
  ## التثبيت:
40
+ ---
41
+
16
42
  ```bash
17
43
  pip install abdocode
18
44
  ```
45
+ ## الكاتب
46
+ - name: abdalla emad
47
+ - age: 13 years
19
48
 
20
- ## شرح الدوال الرئيسية
21
- فيما يلي أهم دوال المكتبة ومجالات استخدامها:
49
+ ## توضيح تعديلات النوافذ المنبثقة (آخر التحديثات)
22
50
 
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()`: يعرض قائمة الاختصارات المفعلة.
51
+ - تم تحديث سلوك النوافذ المنبثقة المتعلقة بالاختصارات والأصوات لتكون تفاعلية ومناسبة للاستخدام كمكتبة:
52
+ - النقر بزر الفأرة الأيمن (`Button-3`) يعرض نافذة منبثقة لقائمة الاختصارات القابلة للبحث.
53
+ - الضغط المتسلسل `Ctrl+S` ثم `.` يفتح نافذة منبثقة للأصوات المسجّلة.
54
+ - عناصر القوائم تُعرض كأزرار قابلة للنقر: النقر على زر الاختصار يجري تشغيل الحدث المسجّل، والنقر على زر الصوت يشغل نغمة (في خيط منفصل لتجنب تجميد الواجهة).
55
+ - الربط غير مفعل تلقائيًا عند استيراد المكتبة — استخدم `enable_shortcuts_ui(root)` لربط النوافذ بجذر `tkinter` عندما تريد تفعيل السلوك داخل تطبيقك.
30
56
 
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)`
57
+ ملاحظة: صُممت هذه الميزات لتكون صديقة للمكتبات؛ لا تفرض تغييرات على تطبيق المستخدم إلا بعد استدعاء التهيئة اليدوية.
37
58
 
38
59
  ### 3. لوحة الحافظة والملفات
39
60
  - `write_clipboard(root, text)`: يضع نصًا في الحافظة.
@@ -166,14 +187,20 @@ pip install abdocode
166
187
 
167
188
  ---
168
189
 
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
- ```
190
+ ## إضافات جديدة (توليد دوال ونظام Beep للأسماء)
191
+
192
+ - مولد دوال مفيدة: تم إضافة مولد ديناميكي في `hotkey_engine.core` يمكنه إنشاء عدد كبير من الدوال المساعدة، يمكن التحكم به عبر `generate_extra_functions(count)`.
193
+ - الاستخدام النموذجي: استدعِ `generate_extra_functions(n)` لإنشاء `n` دوال مسماة فريدة تُستخدم لأغراض الاختبار والأدوات.
194
+ - هذه الدوال مُفيدة للاختبار، الأدوات، أو كمولّد يعطي نتائج صغيرة يمكن فحصها برمجياً.
195
+
196
+ - نظام "Name Beep": أضفنا نظامًا لتوليد سلسلة صوتية قصيرة تمثل اسمًا بصريًا/سمعيًا.
197
+ - `play_name_beep(name)`: يشغّل توقيعًا صوتيًا قصيرًا يمثل `name`.
198
+ - `register_name_beep(name)`: يسجّل نغمة باسم تحت المفتاح `Beep_<name>` في `sound_map`، بحيث يمكنك استدعاؤها عبر `play('Beep_<name>')`.
199
+ - `register_name_beep_group(names)`: يسجل مجموعة من الأسماء دفعة واحدة.
200
+ - `list_registered_name_beeps()`: يعيد قائمة بالمفاتيح المسجلة.
201
+ - ` beep(freq, duration, volume)`انشاء نغمة مرة واحدة فقط
202
+ ملاحظة: جودة التشغيل الصوتي تعتمد على وجود باك-أند صوتي مثل `sounddevice` أو `simpleaudio` أو `winsound` (لويندوز). إذا لم يكن أي منه متاحًا، سيحاول النظام السقوط بهدوء بدلاً من رفع استثناء.
203
+ ### شكرا لكم على وقتكم
204
+
205
+
179
206
 
abdocode-2.0.1/abdocode.egg-info/requires.txt ADDED
@@ -0,0 +1,11 @@
1
+ numpy
2
+ sounddevice
3
+ simpleaudio
4
+
5
+ [audio]
6
+ simpleaudio>=1.1.10
7
+
8
+ [dev]
9
+ pytest>=6.0
10
+ black>=21.0
11
+ pylint>=2.0