الفرق بين المراجعتين لصفحة: «Python/pathlib»

من موسوعة حسوب
مرئينص الويكي
قمت بإنشاء الصفحة كبذرة، وهي أول وحدة لي في الموسوعة
 
طلا ملخص تعديل
 
(17 مراجعة متوسطة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
=  pathlib — وحدة مسارات نظام الملفات كائنية التوجه=
تقدم هذه الوحدة أصنافًا تمثّل مسارات نظام التشغيل مع دلالات ملائمة لمختلف [https://academy.hsoub.com/apps/operating-systems/%D9%86%D8%B8%D8%A7%D9%85-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84/ أنظمة التشغيل]، وقد أُضيفت هذه الوحدة إلى بايثون في النسخة 3.4.


= 11.1. pathlib — مسارات نظام الملفات كائنية التوجه =
تحتوي هذه الوحدة على صنفين يسمحان بالتعامل مع المسارات، أحدهما للتعامل مع المسارات بشكلها النصي <code>PurePath</code>  والآخر  للقيام بعمليات الدخل والخرج على الملفات والمجلدات التي تشير إليها المسارات.
جديدة في النسخة 3.4
==[[Python/pathlib/PurePath|صنف المسارات النقية <code>PurePath</code>]]==
يقدم هذا الصنف عمليات نصّية على المسارات دون أي عمليات إدخال أو إخراج، أي أنه لا يتم الوصول الفعلي إلى نظام الملفات أبدًا ولا يُشترط أن يكون المسار مشيرًا إلى ملفات حقيقية أصلًا.


الشيفرة المصدرية: Lib/pathlib.py
توجد ثلاث طرائق للوصول إلى هذه الأصناف، ونسمي هذه الطرائق بالنكهات، ونوجزها فيما يلي:
----تقدم هذه الوحدة أصنافًا تمثّل مسارات نظام التشغيل مع دلالات ملائمة لمختلف أنظمة التشغيل. تنقسم أصناف المسارات إلى نوعين، الصنف PurePaths الذي يقدم عمليات لحساب المسارات دون أي عمليات إدخال أو إخراج، والصنف ConcretePaths الذي يرث من PurePaths  ولكن مع تقديمها لعمليات الإدخال والإخراج.


إن لم تكن قد استخدمت هذه الوحدة من قبل أو أنك غير متأكد أي صنف عليك أن تستخدم لأداء مهمة ما، فعلى الأغلب عليك استخدام الصنف Path الذي يتولد (instantiates) من الصنف concrete path بما يلائم المنصة التي تُفسّر فيها الشيفرة البرمجية.
1- <code>[[Python/pathlib/PurePath|PurePath]]</code> هو صنف عام يمثل نكهة مسار النظام الذي يتم العمل عليه(حيث يُنشأ كائن من نوع <code>[[Python/pathlib/PurePosixPath|PurePosixPath]]</code> أو <code>[[Python/pathlib/PureWindowsPath|PureWindowsPath]]</code> عند إنشاء كائن منه حسب نظام التشغيل المُفسّر للشيفرة) ذلك يكون حسب قيمة المتغير [[Python/os/name|os.name]] كما هو واضح من [https://github.com/python/cpython/blob/3.7/Lib/pathlib.py الشيفرة البرمجية للوحدة].


يمكن للمسارات النقية (Pure Paths) أن تكون مفيدةٌ في بعض الحالات الخاصة، على سبيل المثال:
2- <code>[[Python/pathlib/PurePosixPath|PurePosixPath]]</code> هو الصنف الفرعي من الصنف <code>[[Python/pathlib/PurePath|PurePath]]</code> الذي يمثل مسارات نظام الملفات في الأنظمة المغايرة لويندوز.
# لمعالجة مسارات نظام ويندوز أثناء العمل على جهاز يعمل بنظام يونكس (والعكس بالعكس)، حيث لا يمكنك إنشاء كائن من الصنف WindowsPath عند العمل على نظام يونكس، ولكن يمكنك إنشاء كائن من الصنف PureWindowsPath.
# عليك التأكد بأن الشيفرة البرمجية تعالج المسارات فقط دون الوصول الفعلي إلى نظام التشغيل، ففي هذه الحالة، يمكنك إنشاء كائن من أحد الأصناف النقية، فهي لا تملك عمليات تسمح لها بالوصول إلى نظام التشغيل.
{| class="wikitable"
|انظر أيضًا


PEP 428: وحدة pathlib -- مسارات نظام الملفات كائنية التوجه
3- <code>[[Python/pathlib/PureWindowsPath|PureWindowsPath]]</code> هو الصنف الفرعي من الصنف <code>[[Python/pathlib/PurePath|PurePath]]</code> الذي يمثل مسارات نظام الملفات في ويندوز.


انظر أيضًا
تسمح المسارات النقية بإنشاء كائنات من أحد الصنفين على كلي أنظمة التشغيل ويندوز و POSIX وذلك لأن جميع التوابع الخاصة بهذا النوع من الأصناف (المسارات النقية) هي توابع للتعامل النصي فقط مع المسارات.
==[[Python/pathlib/Path|صنف المسارات الصلبة <code>Path</code>]]==
يرث هذا الصنف من الصنف <code>[[Python/pathlib/PurePath|PurePath]]</code>  ولكن مع تقديمه لعمليات الإدخال والإخراج، أي أن الكائنات المنشأة منه قادرة على الوصول الفعلي لملفات النظام والتعديل عليها، ويمكن إنشاء كائنات من هذا الصنف بثلاث طرق (نكهات مختلفة)، نوجزها فيما يلي:


للقيام بمعالجة منخفضة المستوى للمسارات على السلاسل النصية، يمكنك أيضًا استخدام الوحدة os.path
1- <code>[[Python/pathlib/Path|Path]]</code> هو الصنف العام، يُنشأ كائن من أحد الصنفين <code>[[Python/pathlib/PosixPath|PosixPath]]</code>  أو <code>[[Python/pathlib/WindowsPath|WindowsPath]]</code> عند إنشاء كائن منه.
|}


== 11.1.1. الاستخدام الأساسي ==
2-<code>[[Python/pathlib/PosixPath|PosixPath]]</code>  هو الصنف فرعي الذي يمثل المسارات الصلبة لمسارات أنظمة الملفات المغايرة لنظام ويندوز، ولا يُسمح بإنشاء كائنات منه في نظام ويندوز.
استيراد الصنف الأساسي:


>>> from pathlib import Path
3-<code>[[Python/pathlib/WindowsPath|WindowsPath]]</code> هو الصنف الفرعي الذي يمثل المسارات الصلبة لمسارات أنظمة ملفات ويندوز، ولا يٌسمح بإنشاء كائنات منه في الأنظمة المغايرة لويندوز.


تعداد المسارات الفرعية:
يُمثل الشكل التالي هيكلية الوراثة بين هذه الأصناف الثلاثة:


>>> p = Path('.')
[[ملف:pathlib-inheritance.png|بديل=صورة توضح طريقة الوراثة بين الأصناف في وحدة pathlib|حدود|وسط|800x800بك|طريقة الوراثة بين الأصناف في وحدة pathlib|وصلة=https://wiki.hsoub.com/%D9%85%D9%84%D9%81:pathlib-inheritance.png]]
==ملاحظة بخصوص الاستخدام لأول مرة==
إن لم تكن قد استخدمت هذه الوحدة من قبل أو أنك غير متأكد أي صنف عليك أن تستخدم لأداء مهمة ما، فعلى الأغلب عليك استخدام الصنف <code>[[Python/pathlib/Path|Path]]</code> الذي يتولد (instantiates) من صنف المسارات الصلبة بما يلائم المنصة التي تُفسّر فيها الشيفرة البرمجية.


>>> [x for x in p.iterdir() if x.is_dir()]
== انظر أيضًا ==
إذا أردت تجربة هذا الصنف في نظام يونكس، فيمكنك استخدام المحاكي من [https://repl.it/repls/SnappyZigzagPrintablecharacter موقع Repl.it] أو المحاكي الخاص بموقع tutorialspoint.


[PosixPath('.hg'), PosixPath('docs'), PosixPath('dist'),
<nowiki>https://www.tutorialspoint.com/online_python_ide.php</nowiki>


PosixPath('__pycache__'), PosixPath('build')]
== مصادر ==
 
[https://docs.python.org/3/library/pathlib.html#pathlib.PurePath.suffix صفحة التوثيق الرسمي لمكتبة pathlib وفي وثائق بايثون.]
تعداد ملفات بايثون المصدرية في شجرة المجلدات هذه:
 
>>>
 
>>> list(p.glob('**/*.py'))
 
[PosixPath('test_pathlib.py'), PosixPath('setup.py'),
 
PosixPath('pathlib.py'), PosixPath('docs/conf.py'),
 
PosixPath('build/lib/pathlib.py')]
 
التنقّل ضمن شجرة المجلدات:
 
>>> p = Path('/etc')
 
>>> q = p / 'init.d' / 'reboot'
 
>>> q
 
PosixPath('/etc/init.d/reboot')
 
>>> q.resolve()
 
PosixPath('/etc/rc.d/init.d/halt')
 
الاستعلام عن خصائص المسار:
 
>>> q.exists()
 
True
 
>>> q.is_dir()
 
False
 
فتح ملف:
 
>>>
 
>>> with q.open() as f: f.readline()
 
...
 
'#!/bin/bash\n'
 
== 11.1.2.‏ ‎‏PurePaths‏ ==
الكائنات المنشأة من الصنف المسارات النقية تقدم عمليات لمعالجة المسارات بحيث لا يتم الوصول الفعلي إلى نظام الملفات. توجد ثلاث طرائق للوصول إلى هذه الأصناف، ونسمي هذه الطرائق بالنكهات. 
 
class pathlib.PurePath(*pathsegments)
 
هو صنف عام يمثل نكهة مسار النظام (حيث يُنشأ كائن من نوع PurePosixPath أو PureWindowsPath عند إنشاء كائن منه)
 
class pathlib.PurePosixPath(*pathsegments)
 
هو صنف فرعي من الصنف PurePath، ويمثل مسارات أنظمة الملفات المغايرة لنظام ويندوز
 
class pathlib.PureWindowsPath(*pathsegments)
 
هو صنف الفرعي من الصنف PurePath، ويمثل مسارات نظام الملفات في ويندوز
 
== 11.1.3. Concrete paths ==
المسارات الصلبة هي أصناف فرعية من أصناف المسارات النقية، وهي تقدم إضافة لكل ما سبق طرائق للقيام باستدعاءات من النظام على كائنات المسار، وهناك ثلاث طرق لإنشاء كائن من المسارات الصلبة
 
Concrete paths are subclasses of the pure path classes. In addition to operations provided by the latter, they also provide methods to do system calls on path objects. There are three ways to instantiate concrete paths:
 
class pathlib.Path(*pathsegments)
 
هو صنف فرعي من الصنف PurePath يمثل المسارات الصلبة لنكهات المسارات المختلفة للنظام، وعند إنشاء كائن منه يُنشأ كائن من أحد الصنفين PosixPath  أو WindowsPath.
 
A subclass of PurePath, this class represents concrete paths of the system’s path flavour (instantiating it creates either a PosixPath or a WindowsPath):
 
class pathlib.PosixPath(*pathsegments)
 
هو صنف فرعي من الصنف Path  والصنف PurePosixPath، يمثل المسارات الصلبة لمسارات أنظمة الملفات المغايرة لنظام ويندوز.
 
A subclass of Path and PurePosixPath, this class represents concrete non-Windows filesystem paths:
 
class pathlib.WindowsPath(*pathsegments)
 
هو صنف فرعي من الصنف Path  والصنف PurePosixPath، يمثل المسارات الصلبة لمسارات أنظمة ملفات ويندوز.
 
A subclass of Path and PureWindowsPath, this class represents concrete Windows filesystem paths:
 
== 11.1.4. تقابل الأدوات المذكورة مع وحدة os ==
يبيّن الجدول التالي تقابل عدة توابع من الوحدة os  مع ما يقابلها و يكافئها من الوحدة PurePath و Path.
 
Below is a table mapping various os functions to their corresponding PurePath/Path equivalent.
 
ملاحظة:
 
بالرغم من وجود بعض التقاطع في حالات استخدام التابعين os.path.relpath‎‎()‎ والتابع PurePath.relative_to()‎ إلا أن مدلول كل منهما مختلف بما يدعو لعدم اعتبارهما متكافئين.
 
Note
 
Although os.path.relpath() and PurePath.relative_to() have some overlapping use-cases, their semantics differ enough to warrant not considering them equivalent.
{| class="wikitable"
|الوحدة os والوحدة os.path
|pathlib
|-
|os.path.abspath()
|Path.resolve()
|-
|os.getcwd()
|Path.cwd()
|-
|os.path.exists()
|Path.exists()
|-
|os.path.expanduser()
|Path.expanduser() و Path.home()
|-
|os.path.isdir()
|Path.is_dir()
|-
|os.path.isfile()
|Path.is_file()
|-
|os.path.islink()
|Path.is_symlink()
|-
|os.stat()
|Path.stat(),Path.owner(), Path.group()
|-
|os.path.isabs()
|PurePath.is_absolute()
|-
|os.path.join()
|PurePath.joinpath()
|-
|os.path.basename()
|PurePath.name
|-
|os.path.dirname()
|PurePath.parent
|-
|os.path.splitext()
|PurePath.suffix
|}
**
 
==== Previous topic ====
11. File and Directory Access
 
==== Next topic ====
11.2. os.path — Common pathname manipulations
 
=== This Page ===
* Report a Bug
* Show Source

المراجعة الحالية بتاريخ 16:42، 18 يوليو 2023

  pathlib — وحدة مسارات نظام الملفات كائنية التوجه

تقدم هذه الوحدة أصنافًا تمثّل مسارات نظام التشغيل مع دلالات ملائمة لمختلف أنظمة التشغيل، وقد أُضيفت هذه الوحدة إلى بايثون في النسخة 3.4.

تحتوي هذه الوحدة على صنفين يسمحان بالتعامل مع المسارات، أحدهما للتعامل مع المسارات بشكلها النصي PurePath والآخر للقيام بعمليات الدخل والخرج على الملفات والمجلدات التي تشير إليها المسارات.

صنف المسارات النقية PurePath

يقدم هذا الصنف عمليات نصّية على المسارات دون أي عمليات إدخال أو إخراج، أي أنه لا يتم الوصول الفعلي إلى نظام الملفات أبدًا ولا يُشترط أن يكون المسار مشيرًا إلى ملفات حقيقية أصلًا.

توجد ثلاث طرائق للوصول إلى هذه الأصناف، ونسمي هذه الطرائق بالنكهات، ونوجزها فيما يلي:

1- PurePath هو صنف عام يمثل نكهة مسار النظام الذي يتم العمل عليه(حيث يُنشأ كائن من نوع PurePosixPath أو PureWindowsPath عند إنشاء كائن منه حسب نظام التشغيل المُفسّر للشيفرة) ذلك يكون حسب قيمة المتغير os.name كما هو واضح من الشيفرة البرمجية للوحدة.

2- PurePosixPath هو الصنف الفرعي من الصنف PurePath الذي يمثل مسارات نظام الملفات في الأنظمة المغايرة لويندوز.

3- PureWindowsPath هو الصنف الفرعي من الصنف PurePath الذي يمثل مسارات نظام الملفات في ويندوز.

تسمح المسارات النقية بإنشاء كائنات من أحد الصنفين على كلي أنظمة التشغيل ويندوز و POSIX وذلك لأن جميع التوابع الخاصة بهذا النوع من الأصناف (المسارات النقية) هي توابع للتعامل النصي فقط مع المسارات.

صنف المسارات الصلبة Path

يرث هذا الصنف من الصنف PurePath  ولكن مع تقديمه لعمليات الإدخال والإخراج، أي أن الكائنات المنشأة منه قادرة على الوصول الفعلي لملفات النظام والتعديل عليها، ويمكن إنشاء كائنات من هذا الصنف بثلاث طرق (نكهات مختلفة)، نوجزها فيما يلي:

1- Path هو الصنف العام، يُنشأ كائن من أحد الصنفين PosixPath  أو WindowsPath عند إنشاء كائن منه.

2-PosixPath هو الصنف فرعي الذي يمثل المسارات الصلبة لمسارات أنظمة الملفات المغايرة لنظام ويندوز، ولا يُسمح بإنشاء كائنات منه في نظام ويندوز.

3-WindowsPath هو الصنف الفرعي الذي يمثل المسارات الصلبة لمسارات أنظمة ملفات ويندوز، ولا يٌسمح بإنشاء كائنات منه في الأنظمة المغايرة لويندوز.

يُمثل الشكل التالي هيكلية الوراثة بين هذه الأصناف الثلاثة:

صورة توضح طريقة الوراثة بين الأصناف في وحدة pathlib

ملاحظة بخصوص الاستخدام لأول مرة

إن لم تكن قد استخدمت هذه الوحدة من قبل أو أنك غير متأكد أي صنف عليك أن تستخدم لأداء مهمة ما، فعلى الأغلب عليك استخدام الصنف Path الذي يتولد (instantiates) من صنف المسارات الصلبة بما يلائم المنصة التي تُفسّر فيها الشيفرة البرمجية.

انظر أيضًا

إذا أردت تجربة هذا الصنف في نظام يونكس، فيمكنك استخدام المحاكي من موقع Repl.it أو المحاكي الخاص بموقع tutorialspoint.

https://www.tutorialspoint.com/online_python_ide.php

مصادر

صفحة التوثيق الرسمي لمكتبة pathlib وفي وثائق بايثون.

مجلوبة من «https://wiki.hsoub.com/index.php?title=Python/pathlib&oldid=32690»