iframe-proxy | Sunbelt Computer Software

517 lines (450 loc) · 14.9 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
"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"
"Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../tutorial/stdlib.rst:5
msgid "Brief tour of the standard library"
#: ../../tutorial/stdlib.rst:11
msgid "Operating system interface"
#: ../../tutorial/stdlib.rst:13
"The :mod:`os` module provides dozens of functions for interacting with the "
"operating system::"
#: ../../tutorial/stdlib.rst:16
">>> 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"
#: ../../tutorial/stdlib.rst:23
"Be sure to use the ``import os`` style instead of ``from os import *``.  "
"This will keep :func:`os.open` from shadowing the built-in :func:`open` "
"function which operates much differently."
#: ../../tutorial/stdlib.rst:29
"The built-in :func:`dir` and :func:`help` functions are useful as "
"interactive aids for working with large modules like :mod:`os`::"
#: ../../tutorial/stdlib.rst:32
">>> 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
"For daily file and directory management tasks, the :mod:`shutil` module "
"provides a higher level interface that is easier to use::"
#: ../../tutorial/stdlib.rst:41
">>> 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"
#: ../../tutorial/stdlib.rst:53
"The :mod:`glob` module provides a function for making file lists from "
"directory wildcard searches::"
#: ../../tutorial/stdlib.rst:56
">>> import glob\n"
">>> glob.glob('*.py')\n"
"['primes.py', 'random.py', 'quote.py']"
#: ../../tutorial/stdlib.rst:64
msgid "Command-line arguments"
#: ../../tutorial/stdlib.rst:66
"Common utility scripts often need to process command line arguments. These "
"arguments are stored in the :mod:`sys` module's *argv* attribute as a list.  "
"For instance, let's take the following :file:`demo.py` file::"
#: ../../tutorial/stdlib.rst:70
"# File demo.py\n"
"import sys\n"
"print(sys.argv)"
#: ../../tutorial/stdlib.rst:74
"Here is the output from running ``python demo.py one two three`` at the "
"command line::"
#: ../../tutorial/stdlib.rst:77
msgid "['demo.py', 'one', 'two', 'three']"
#: ../../tutorial/stdlib.rst:79
"The :mod:`argparse` module provides a more sophisticated mechanism to "
"process command line arguments.  The following script extracts one or more "
"filenames and an optional number of lines to be displayed::"
#: ../../tutorial/stdlib.rst:83
"import argparse\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
"When run at the command line with ``python top.py --lines=5 alpha.txt "
"beta.txt``, the script sets ``args.lines`` to ``5`` and ``args.filenames`` "
"to ``['alpha.txt', 'beta.txt']``."
#: ../../tutorial/stdlib.rst:101
msgid "Error output redirection and program termination"
#: ../../tutorial/stdlib.rst:103
"The :mod:`sys` module also has attributes for *stdin*, *stdout*, and "
"*stderr*. The latter is useful for emitting warnings and error messages to "
"make them visible even when *stdout* has been redirected::"
#: ../../tutorial/stdlib.rst:107
">>> 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()``."
#: ../../tutorial/stdlib.rst:116
msgid "String pattern matching"
#: ../../tutorial/stdlib.rst:118
"The :mod:`re` module provides regular expression tools for advanced string "
"processing. For complex matching and manipulation, regular expressions offer "
"succinct, optimized solutions::"
#: ../../tutorial/stdlib.rst:122
">>> 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
"When only simple capabilities are needed, string methods are preferred "
"because they are easier to read and debug::"
#: ../../tutorial/stdlib.rst:131
">>> 'tea for too'.replace('too', 'two')\n"
"'tea for two'"
#: ../../tutorial/stdlib.rst:138
msgid "Mathematics"
#: ../../tutorial/stdlib.rst:140
"The :mod:`math` module gives access to the underlying C library functions "
"for floating-point math::"
#: ../../tutorial/stdlib.rst:143
">>> import math\n"
">>> math.cos(math.pi / 4)\n"
"0.70710678118654757\n"
">>> math.log(1024, 2)\n"
#: ../../tutorial/stdlib.rst:149
msgid "The :mod:`random` module provides tools for making random selections::"
#: ../../tutorial/stdlib.rst:151
">>> 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"
#: ../../tutorial/stdlib.rst:161
"The :mod:`statistics` module calculates basic statistical properties (the "
"mean, median, variance, etc.) of numeric data::"
#: ../../tutorial/stdlib.rst:164
">>> 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"
">>> statistics.variance(data)\n"
#: ../../tutorial/stdlib.rst:173
"The SciPy project <https://scipy.org> has many other modules for numerical "
"computations."
#: ../../tutorial/stdlib.rst:179
msgid "Internet access"
#: ../../tutorial/stdlib.rst:181
"There are a number of modules for accessing the internet and processing "
"internet protocols. Two of the simplest are :mod:`urllib.request` for "
"retrieving data from URLs and :mod:`smtplib` for sending mail::"
#: ../../tutorial/stdlib.rst:185
">>> 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"
"      Last updated on Nov 11, 2025 (20:11 UTC).\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"
"... 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.)"
#: ../../tutorial/stdlib.rst:210
msgid "Dates and times"
#: ../../tutorial/stdlib.rst:212
"The :mod:`datetime` module supplies classes for manipulating dates and times "
"in both simple and complex ways. While date and time arithmetic is "
"supported, the focus of the implementation is on efficient member extraction "
"for output formatting and manipulation.  The module also supports objects "
"that are timezone aware. ::"
#: ../../tutorial/stdlib.rst:218
">>> # 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"
">>> # dates support calendar arithmetic\n"
">>> birthday = dt.date(1964, 7, 31)\n"
">>> age = now - birthday\n"
">>> age.days\n"
#: ../../tutorial/stdlib.rst:236
msgid "Data compression"
#: ../../tutorial/stdlib.rst:238
"Common data archiving and compression formats are directly supported by "
"including: :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:`lzma`, :mod:`zipfile` "
"and :mod:`tarfile`. ::"
#: ../../tutorial/stdlib.rst:242
">>> import zlib\n"
">>> s = b'witch which has which witches wrist watch'\n"
">>> len(s)\n"
">>> t = zlib.compress(s)\n"
">>> len(t)\n"
">>> zlib.decompress(t)\n"
"b'witch which has which witches wrist watch'\n"
">>> zlib.crc32(s)\n"
#: ../../tutorial/stdlib.rst:258
msgid "Performance measurement"
#: ../../tutorial/stdlib.rst:260
"Some Python users develop a deep interest in knowing the relative "
"performance of different approaches to the same problem. Python provides a "
"measurement tool that answers those questions immediately."
#: ../../tutorial/stdlib.rst:264
"For example, it may be tempting to use the tuple packing and unpacking "
"feature instead of the traditional approach to swapping arguments. "
"The :mod:`timeit` module quickly demonstrates a modest performance "
"advantage::"
#: ../../tutorial/stdlib.rst:268
">>> 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"
#: ../../tutorial/stdlib.rst:274
"In contrast to :mod:`timeit`'s fine level of granularity, the :mod:`profile` "
"and :mod:`pstats` modules provide tools for identifying time critical "
"sections in larger blocks of code."
#: ../../tutorial/stdlib.rst:282
msgid "Quality control"
#: ../../tutorial/stdlib.rst:284
"One approach for developing high quality software is to write tests for each "
"function as it is developed and to run those tests frequently during the "
"development process."
#: ../../tutorial/stdlib.rst:288
"The :mod:`doctest` module provides a tool for scanning a module and "
"validating tests embedded in a program's docstrings.  Test construction is "
"as simple as cutting-and-pasting a typical call along with its results into "
"the docstring. This improves the documentation by providing the user with an "
"example and it allows the doctest module to make sure the code remains true "
"to the documentation::"
#: ../../tutorial/stdlib.rst:295
"def average(values):\n"
"    \"\"\"Computes the arithmetic mean of a list of numbers.\n"
"    >>> print(average([20, 30, 70]))\n"
"    40.0\n"
"    \"\"\"\n"
"    return sum(values) / len(values)\n"
"import doctest\n"
"doctest.testmod()   # automatically validate the embedded tests"
#: ../../tutorial/stdlib.rst:306
"The :mod:`unittest` module is not as effortless as the :mod:`doctest` "
"module, but it allows a more comprehensive set of tests to be maintained in "
"a separate file::"
#: ../../tutorial/stdlib.rst:310
"import unittest\n"
"class TestStatisticalFunctions(unittest.TestCase):\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"
"unittest.main()  # Calling from the command line invokes all tests"
#: ../../tutorial/stdlib.rst:328
msgid "Batteries included"
#: ../../tutorial/stdlib.rst:330
"Python has a \"batteries included\" philosophy.  This is best seen through "
"the sophisticated and robust capabilities of its larger packages. For "
#: ../../tutorial/stdlib.rst:333
"The :mod:`xmlrpc.client` and :mod:`xmlrpc.server` modules make implementing "
"remote procedure calls into an almost trivial task.  Despite the modules' "
"names, no direct knowledge or handling of XML is needed."
#: ../../tutorial/stdlib.rst:337
"The :mod:`email` package is a library for managing email messages, including "
"MIME and other :rfc:`5322`-based message documents. Unlike :mod:`smtplib` "
"and :mod:`poplib` which actually send and receive messages, the email "
"package has a complete toolset for building or decoding complex message "
"structures (including attachments) and for implementing internet encoding "
"and header protocols."
#: ../../tutorial/stdlib.rst:344
"The :mod:`json` package provides robust support for parsing this popular "
"data interchange format.  The :mod:`csv` module supports direct reading and "
"writing of files in Comma-Separated Value format, commonly supported by "
"databases and spreadsheets.  XML processing is supported by "
"the :mod:`xml.etree.ElementTree`, :mod:`xml.dom` and :mod:`xml.sax` "
"packages. Together, these modules and packages greatly simplify data "
"interchange between Python applications and other tools."
#: ../../tutorial/stdlib.rst:353
"The :mod:`sqlite3` module is a wrapper for the SQLite database library, "
"providing a persistent database that can be updated and accessed using "
"slightly nonstandard SQL syntax."
#: ../../tutorial/stdlib.rst:357
"Internationalization is supported by a number of modules "
"including :mod:`gettext`, :mod:`locale`, and the :mod:`codecs` package."
#: ../../tutorial/stdlib.rst:27
msgid "built-in function"
#: ../../tutorial/stdlib.rst:27
msgid "help"
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

stdlib.po

Latest commit

History

stdlib.po

File metadata and controls
