edited l04

Author: Saeid Darvish

source/lessons/l04-python-interactive-mode.rst

@@ -132,7 +132,19 @@
 
 اکنون می‌دانیم که برای وارد کردن یک ماژول به یک اسکریپت (یا ماژولی دیگر) از دستور import استفاده می‌گردد. پس از آن، برای دستیابی اجزای داخل آن مانند فراخوانی یک تابع نیز می‌بایست از الگوی «نام ماژول + نقطه + نام تابع مورد نظر» استفاده گردد.
 
-مثالی دیگر - ``sys`` یکی از ماژول‌های مهم پایتون است؛ این ماژول امکان دسترسی به برخی از متغیرهای مورد استفاده مفسر (در زمان اجرا) و همچنین تابع‌هایی که با مفسر در ارتباط هستند را فراهم می‌آورد [`اسناد پایتون <http://docs.python.org/3/library/sys.html>`__]:
+و اگر از روش ``... from ... import`` استفاده کنیم: در این صورت می‌توان به جای کل ماژول، تنها اجزای مورد نیاز خود را import نماییم و دیگر نیازی به ذکر نام ماژول نیز نخواهد بود::
+
+    >>> from math import sqrt, pow, radians, sin
+    >>> sqrt(36)
+    6.0
+    >>> pow(3, 2)
+    9.0
+    >>> radians(90)
+    1.5707963267948966
+    >>> sin(_)
+    1.0
+
+مثالی دیگر - ``sys`` یکی از ماژول‌های مهم پایتون است؛ این ماژول امکان دسترسی به برخی از متغیرهای مورد استفاده توسط مفسر (در زمان اجرا) و همچنین تابع‌هایی که با مفسر در ارتباط هستند را فراهم می‌آورد [`اسناد پایتون <http://docs.python.org/3/library/sys.html>`__]:
 
 .. code-block:: python
     
@@ -150,7 +162,27 @@
     >>> sys.getdefaultencoding()
     'utf-8'
 
-دستور ``()sys.exit`` نیز موجب توقف اجرا (در اینجا: خروج از حالت تعاملی پایتون) می‌گردد. برای کنترل خطاها کاربرد دارد و همچنین می‌توان پیامی مرتبط را به خروجی فرستاد (معمولا گزارش رویدادی که موجب اتمام ناگهانی برنامه شده‌ است)::
+یا:
+
+.. code-block:: shell
+    
+    >>> from sys import version, version_info, platform, getdefaultencoding
+    
+    >>> version
+    '3.4.2 (default, Jan 25 2015, 20:02:16) \n[GCC 4.9.2 20141101 (Red Hat 4.9.2-1)]'
+    
+    >>> version_info
+    sys.version_info(major=3, minor=4, micro=2, releaselevel='final', serial=0)
+    
+    >>> platform
+    'linux'
+    
+    >>> getdefaultencoding()
+    'utf-8'
+
+دستور ``()sys.exit`` نیز موجب توقف اجرا (در اینجا: خروج از حالت تعاملی پایتون) می‌گردد. برای کنترل خطاها کاربرد دارد و همچنین می‌توان پیامی مرتبط را به خروجی فرستاد (معمولا گزارش رویدادی که موجب اتمام ناگهانی برنامه شده‌ است):
+
+.. code-block:: shell
 
     >>> import sys
     
@@ -159,6 +191,20 @@
     
     user>
 
+یا
+
+.. code-block:: shell
+
+    >>> from sys import exit as bye
+    
+    >>> bye("Error: Goodbye! :| ")
+    Error: Goodbye! :| 
+    
+    user>
+
+
+با استفاده از ``as`` می‌توان برای اجزای import شده (به هر دو روش)، یک نام دلخواه تنظیم کرد. این ویژگی در زمانی که نام اصلی طولانی بوده یا با یکی از اجزای داخل ماژول همنام باشد (برای جلوگیری از تداخل) کاربرد دارد.
+
 
 .. _python-help: 
 
@@ -404,7 +450,7 @@
     ['', '/home/user/Documents/me', '/usr/local/lib/python34.zip', '/usr/local/lib/python3.4', '/usr/local/lib/python3.4/plat-linux', '/usr/local/lib/python3.4/lib-dynload', '/usr/local/lib/python3.4/site-packages']
     >>>
 
-  چند درس جلوتر خواهید آموخت که مقدار ``sys.path`` در واقع یک شی از نوع ``list`` است؛ ``append`` و ``insert`` نیز تابع‌هایی [#f4]_ هستند که توسط یک شی از نوع ``list`` ارایه می‌گردد. در این مرحله تنها به یاد داشته باشید که موقعیت‌ها در یک شی از نوع ``list`` از عدد صفر شماره‌گذاری می‌گردند.
+  چند درس جلوتر خواهید آموخت که مقدار ``sys.path`` در واقع یک شی از نوع ``list`` است؛ ``append`` و ``insert`` نیز تابع‌هایی  هستند که توسط یک شی از نوع ``list`` ارایه می‌گردد. در این مرحله تنها به یاد داشته باشید که موقعیت‌ها در یک شی از نوع ``list`` از عدد صفر شماره‌گذاری می‌گردند.
 
 .. rubric:: دسته دوم:
 
@@ -437,7 +483,6 @@
   معمولا کدهای اسکریپت به گونه‌ای نوشته می‌شوند که اجرای آن‌ها وابسته به اجرای یک تابع اصلی باشد که معمولا ``()main`` نامیده می‌شود که در انتها بتوان با قرار دادن شرط برابری مقدار ``__name__`` با ``'__main__'`` برای اجرای تابع یاد شده، از اجرای کد‌های مورد نظر تنها در حالت اجرا به صورت اسکریپت (و نه در زمان import) مطمئن شد.
 
   .. code-block:: python
-      :linenos:
       
       def main():  
           print("this runs only when executed directly") 
@@ -455,21 +500,29 @@
 
 
 .. code-block:: python
-    :linenos:
     
     import sys
-    
-    print(sys.argv)
-    print(sys.argv[0])
-    print(sys.argv[1])
-    print(sys.argv[2])
+
+    def main():
+        print(sys.argv)
+        print(sys.argv[0])
+        print(sys.argv[1])
+        print(sys.argv[2])
+
+    if __name__ == '__main__':
+        main()
+
+.. tip::
+     از آنجا که عملکرد و خروجی مورد نظر این ماژول تنها در حالت اجرای اسکریپت است (دریافت آرگومان‌ها) و نه import آن در برنامه، بنابراین با بررسی نام ماژول در زمان اجرا از این موضوع اطمینان حاصل کردیم.
+
 
 اسکریپت بالا را با ارسال دو آرگومان ``arg_1`` و ``arg_2`` اجرا می‌نماییم:
 
 ::
 
-    user> python /home/user/Documents/script-argv.py arg_1 arg_2
-    
+    user> cd /home/user/Documents
+
+    user> python script.py arg_1 arg_2
     ['/home/user/Documents/script-argv.py', 'arg_1', 'arg_2']
     /home/user/Documents/script-argv.py
     arg_1
@@ -483,19 +536,31 @@
     ['-c', '2']
 
 
+
+.. admonition:: تمرین
+    
+  یک اسکریپت ایجاد نمایید که دو پارامتر نام و سن را به صورت آرگومان‌های اسکریپت دریافت و بر روی خروجی نمایش دهد.
+
+  نمونه دستور اجرای اسکریپت:
+
+  ``python script.py "Hideyoshi Nagachika" 19``
+
+  نمونه خروجی اسکریپت:
+
+  ``Name: Hideyoshi Nagachika - Age: 19`` 
+
+
 .. _lesson-04-footer: 
 
 پی‌نوشت
 -------
 
-.. [#f1] «عبارت» (Expression) یک قطعه از سینتکس است که می‌تواند به یک مقدار ارزیابی گردد، عبارت شامل «کلمه‌های کلیدی» (Keywords) نمی‌شود و «دستور» (Statement) بخشی از یک بلاک کد است که شامل کلمه‌های کلیدی بوده و کاری را به انجام می‌رساند. [کلمه‌های کلیدی در آینده بررسی می‌شوند.]
+.. [#f1] «عبارت» (Expression) یک قطعه از کد است که می‌تواند به یک مقدار ارزیابی گردد، عبارت شامل «کلمه‌های کلیدی» (Keywords) نمی‌شود و «دستور» (Statement) بخشی از یک بلاک کد است که شامل کلمه‌های کلیدی بوده و کاری را به انجام می‌رساند. [کلمه‌های کلیدی در آینده بررسی می‌شوند.]
 
 .. [#f2] درست این بود که به جای واژه «مقدار» (Value) از «شی» (Object) استفاده می‌شد؛ چرا که هر چیزی در پایتون یک شی است. به عنوان نمونه، عدد 5 یک شی از کلاس «اعداد صحیح» (Integers) می‌باشد.
 
 .. [#f3] توضیحی است که در ابتدای تابع‌ها، کلاس‌ها و ماژول‌ها می‌آید و توسط مفسر نادیده گرفته نمی‌شود. [docstring در آینده بررسی می‌شود]
 
-.. [#f4] واژه «تابع» در مفهوم شی، مناسب نیست. در تعریف شی‌گرا از واژه «متد» (Method) به جای «تابع» (Function) استفاده می‌گردد؛ ولی در این مرحله که هنوز به شی‌گرایی پرداخته نشده است، ترجیح داده شد تا از واژه «تابع» استفاده گردد.
-
 
 
 |
@@ -504,6 +569,4 @@
 
 :emoji-size:`😊` امیدوارم مفید بوده باشه
 
-`لطفا دیدگاه و سوال‌های مرتبط با این درس خود را در کدرز مطرح نمایید. <http://coderz.ir/python-tutorial-interactive-mode/>`_
-