Translate stdlib2 and parts of stdlib

Author: sepehr-rs

tutorial/stdlib.po

@@ -12,7 +12,7 @@ msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-07-25 12:59+0330\n"
-"PO-Revision-Date: 2021-06-28 01:50+0000\n"
+"PO-Revision-Date: 2026-07-31 13:23+0330\n"
 "Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"
 "Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
 "fa/)\n"
@@ -21,6 +21,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"X-Generator: Poedit 3.6\n"
 
 #: ../../tutorial/stdlib.rst:5
 msgid "Brief tour of the standard library"
@@ -45,6 +46,12 @@ msgid ""
 ">>> os.system('mkdir today')   # Run the command mkdir in the system shell\n"
 "0"
 msgstr ""
+">>> import os\n"
+">>> os.getcwd()      # Return the current working directory\n"
+"'C:\\\\Python314'\n"
+">>> os.chdir('/server/accesslogs')   # Change current working directory\n"
+">>> os.system('mkdir today')   # Run the command mkdir in the system shell\n"
+"0"
 
 #: ../../tutorial/stdlib.rst:23
 msgid ""
@@ -67,6 +74,11 @@ msgid ""
 ">>> help(os)\n"
 "<returns an extensive manual page created from the module's docstrings>"
 msgstr ""
+">>> import os\n"
+">>> dir(os)\n"
+"<returns a list of all module functions>\n"
+">>> help(os)\n"
+"<returns an extensive manual page created from the module's docstrings>"
 
 #: ../../tutorial/stdlib.rst:38
 msgid ""
@@ -82,6 +94,11 @@ msgid ""
 ">>> shutil.move('/build/executables', 'installdir')\n"
 "'installdir'"
 msgstr ""
+">>> import shutil\n"
+">>> shutil.copyfile('data.db', 'archive.db')\n"
+"'archive.db'\n"
+">>> shutil.move('/build/executables', 'installdir')\n"
+"'installdir'"
 
 #: ../../tutorial/stdlib.rst:51
 msgid "File wildcards"
@@ -99,6 +116,9 @@ msgid ""
 ">>> glob.glob('*.py')\n"
 "['primes.py', 'random.py', 'quote.py']"
 msgstr ""
+">>> import glob\n"
+">>> glob.glob('*.py')\n"
+"['primes.py', 'random.py', 'quote.py']"
 
 #: ../../tutorial/stdlib.rst:64
 msgid "Command-line arguments"
@@ -117,6 +137,9 @@ msgid ""
 "import sys\n"
 "print(sys.argv)"
 msgstr ""
+"# File demo.py\n"
+"import sys\n"
+"print(sys.argv)"
 
 #: ../../tutorial/stdlib.rst:74
 msgid ""
@@ -126,7 +149,7 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:77
 msgid "['demo.py', 'one', 'two', 'three']"
-msgstr ""
+msgstr "['demo.py', 'one', 'two', 'three']"
 
 #: ../../tutorial/stdlib.rst:79
 msgid ""
@@ -147,6 +170,15 @@ msgid ""
 "args = parser.parse_args()\n"
 "print(args)"
 msgstr ""
+"import argparse\n"
+"\n"
+"parser = argparse.ArgumentParser(\n"
+"    prog='top',\n"
+"    description='Show top lines from each file')\n"
+"parser.add_argument('filenames', nargs='+')\n"
+"parser.add_argument('-l', '--lines', type=int, default=10)\n"
+"args = parser.parse_args()\n"
+"print(args)"
 
 #: ../../tutorial/stdlib.rst:93
 msgid ""
@@ -171,6 +203,8 @@ msgid ""
 ">>> sys.stderr.write('Warning, log file not found starting a new one\\n')\n"
 "Warning, log file not found starting a new one"
 msgstr ""
+">>> sys.stderr.write('Warning, log file not found starting a new one\\n')\n"
+"Warning, log file not found starting a new one"
 
 #: ../../tutorial/stdlib.rst:110
 msgid "The most direct way to terminate a script is to use ``sys.exit()``."
@@ -195,6 +229,11 @@ msgid ""
 ">>> re.sub(r'(\\b[a-z]+) \\1', r'\\1', 'cat in the the hat')\n"
 "'cat in the hat'"
 msgstr ""
+">>> import re\n"
+">>> re.findall(r'\\bf[a-z]*', 'which foot or hand fell fastest')\n"
+"['foot', 'fell', 'fastest']\n"
+">>> re.sub(r'(\\b[a-z]+) \\1', r'\\1', 'cat in the the hat')\n"
+"'cat in the hat'"
 
 #: ../../tutorial/stdlib.rst:128
 msgid ""
@@ -207,6 +246,8 @@ msgid ""
 ">>> 'tea for too'.replace('too', 'two')\n"
 "'tea for two'"
 msgstr ""
+">>> 'tea for too'.replace('too', 'two')\n"
+"'tea for two'"
 
 #: ../../tutorial/stdlib.rst:138
 msgid "Mathematics"
@@ -226,6 +267,11 @@ msgid ""
 ">>> math.log(1024, 2)\n"
 "10.0"
 msgstr ""
+">>> import math\n"
+">>> math.cos(math.pi / 4)\n"
+"0.70710678118654757\n"
+">>> math.log(1024, 2)\n"
+"10.0"
 
 #: ../../tutorial/stdlib.rst:149
 msgid "The :mod:`random` module provides tools for making random selections::"
@@ -243,6 +289,15 @@ msgid ""
 ">>> random.randrange(6)    # random integer chosen from range(6)\n"
 "4"
 msgstr ""
+">>> import random\n"
+">>> random.choice(['apple', 'pear', 'banana'])\n"
+"'apple'\n"
+">>> random.sample(range(100), 10)   # sampling without replacement\n"
+"[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]\n"
+">>> random.random()    # random float from the interval [0.0, 1.0)\n"
+"0.17970987693706186\n"
+">>> random.randrange(6)    # random integer chosen from range(6)\n"
+"4"
 
 #: ../../tutorial/stdlib.rst:161
 msgid ""
@@ -261,6 +316,14 @@ msgid ""
 ">>> statistics.variance(data)\n"
 "1.3720238095238095"
 msgstr ""
+">>> import statistics\n"
+">>> data = [2.75, 1.75, 1.25, 0.25, 0.5, 1.25, 3.5]\n"
+">>> statistics.mean(data)\n"
+"1.6071428571428572\n"
+">>> statistics.median(data)\n"
+"1.25\n"
+">>> statistics.variance(data)\n"
+"1.3720238095238095"
 
 #: ../../tutorial/stdlib.rst:173
 msgid ""
@@ -270,7 +333,7 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:179
 msgid "Internet access"
-msgstr ""
+msgstr "دسترسی به اینترنت"
 
 #: ../../tutorial/stdlib.rst:181
 msgid ""
@@ -300,6 +363,24 @@ msgid ""
 "... \"\"\")\n"
 ">>> server.quit()"
 msgstr ""
+">>> from urllib.request import urlopen\n"
+">>> with urlopen('https://docs.python.org/3/') as response:\n"
+"...     for line in response:\n"
+"...         line = line.decode()             # Convert bytes to a str\n"
+"...         if 'updated' in line:\n"
+"...             print(line.rstrip())         # Remove trailing newline\n"
+"...\n"
+"      Last updated on Nov 11, 2025 (20:11 UTC).\n"
+"\n"
+">>> import smtplib\n"
+">>> server = smtplib.SMTP('localhost')\n"
+">>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',\n"
+"... \"\"\"To: jcaesar@example.org\n"
+"... From: soothsayer@example.org\n"
+"...\n"
+"... Beware the Ides of March.\n"
+"... \"\"\")\n"
+">>> server.quit()"
 
 #: ../../tutorial/stdlib.rst:204
 msgid "(Note that the second example needs a mailserver running on localhost.)"
@@ -334,6 +415,19 @@ msgid ""
 ">>> age.days\n"
 "14368"
 msgstr ""
+">>> # dates are easily constructed and formatted\n"
+">>> import datetime as dt\n"
+">>> now = dt.date.today()\n"
+">>> now\n"
+"datetime.date(2003, 12, 2)\n"
+">>> now.strftime(\"%m-%d-%y. %d %b %Y is a %A on the %d day of %B.\")\n"
+"'12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.'\n"
+"\n"
+">>> # dates support calendar arithmetic\n"
+">>> birthday = dt.date(1964, 7, 31)\n"
+">>> age = now - birthday\n"
+">>> age.days\n"
+"14368"
 
 #: ../../tutorial/stdlib.rst:236
 msgid "Data compression"
@@ -361,6 +455,17 @@ msgid ""
 ">>> zlib.crc32(s)\n"
 "226805979"
 msgstr ""
+">>> import zlib\n"
+">>> s = b'witch which has which witches wrist watch'\n"
+">>> len(s)\n"
+"41\n"
+">>> t = zlib.compress(s)\n"
+">>> len(t)\n"
+"37\n"
+">>> zlib.decompress(t)\n"
+"b'witch which has which witches wrist watch'\n"
+">>> zlib.crc32(s)\n"
+"226805979"
 
 #: ../../tutorial/stdlib.rst:258
 msgid "Performance measurement"
@@ -389,6 +494,11 @@ msgid ""
 ">>> Timer('a,b = b,a', 'a=1; b=2').timeit()\n"
 "0.54962537085770791"
 msgstr ""
+">>> from timeit import Timer\n"
+">>> Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()\n"
+"0.57535828626024577\n"
+">>> Timer('a,b = b,a', 'a=1; b=2').timeit()\n"
+"0.54962537085770791"
 
 #: ../../tutorial/stdlib.rst:274
 msgid ""
@@ -431,6 +541,16 @@ msgid ""
 "import doctest\n"
 "doctest.testmod()   # automatically validate the embedded tests"
 msgstr ""
+"def average(values):\n"
+"    \"\"\"Computes the arithmetic mean of a list of numbers.\n"
+"\n"
+"    >>> print(average([20, 30, 70]))\n"
+"    40.0\n"
+"    \"\"\"\n"
+"    return sum(values) / len(values)\n"
+"\n"
+"import doctest\n"
+"doctest.testmod()   # automatically validate the embedded tests"
 
 #: ../../tutorial/stdlib.rst:306
 msgid ""
@@ -455,6 +575,19 @@ msgid ""
 "\n"
 "unittest.main()  # Calling from the command line invokes all tests"
 msgstr ""
+"import unittest\n"
+"\n"
+"class TestStatisticalFunctions(unittest.TestCase):\n"
+"\n"
+"    def test_average(self):\n"
+"        self.assertEqual(average([20, 30, 70]), 40.0)\n"
+"        self.assertEqual(round(average([1, 5, 7]), 1), 4.3)\n"
+"        with self.assertRaises(ZeroDivisionError):\n"
+"            average([])\n"
+"        with self.assertRaises(TypeError):\n"
+"            average(20, 30, 70)\n"
+"\n"
+"unittest.main()  # Calling from the command line invokes all tests"
 
 #: ../../tutorial/stdlib.rst:328
 msgid "Batteries included"