Язык Python

Определение модулей и пакетов

Модули позволяют разбить сложную программу на части, разработку которых можно поручать отдельным программистам. Модуль – это обычная программа на Python, в которой определяются глобальные переменные, функции и классы. Имена из импортируемых в нем модулей также становятся частью этого модуля.

При использовании
import модуль
доступны все определения через `"модуль" tt"." "имя"`. Также можно получить доступ к любому имени модуля через
from модуль import имя

Однако имена с подчеркиванием в начале не добавляются к именам другого модуля при импорте с помощью
from модуль import *
и можно явно указать для этого случая список импортируемых имен с помощью переменной:
__all__=('abc','_def')

Код вне функций исполняется. Можно проверить, вызывается модуль напрямую (python -m модуль) или импортируется с помощью условия:

if __name__ == '__main__':
  # вызывается
else:
  # импортируется

Пакет – это папка, в которой находятся модули и другие пакеты. Какие имена будут доступны при импорте пакета определяется в файле __init__.py, а в файле __main__.py пишется код, который выполняется при вызове пакета напрямую (python -m пакет).

Документирование

Документацией считается строковая константа, которая указывается в первой строке модуля (init.py для пакета), в определении класса, в блоке после заголовка функции. Эта информация помещается в специальный атрибут __doc__ соответствующего объекта и может быть просмотрена с помощью функции help:

class Polynom:
  """
Полином представляет собой функцию от x, 
которая вычисляется по формуле a[n-1]*x**(n-1)+...+a[1]*x+a[0],
где a[i] - коэффициенты полинома
  """
  def __init__(self,a):
    "В качестве аргумента конструктору можно указать любую последовательность чисел: Polynom([1,-2,1.5])"
    self.a=list(a)
  def __call__(self,x):
    "Для вычисления полинома P в точке x нужно вызвать P(x)"
    r=0.0
    for ai in reversed(self.a):
      r=r*x+ai
    return r
def degree(p):
  "Вычисляет степень полинома"
  return len(p.a)

p=Polynom([1,-2,1.5])
print(p(2))
help(Polynom) # В качестве аргумента можно указать класс или объект этого класса: help(p)
help(degree) # или функцию

Модуль pydoc позволяет сформировать html-страницу с документацией по отдельному модулю или запустить локально сайт с документацией по всем доступным модулям:
python -m pydoc -b

Стандартные модули и пакеты

import collections
Point=collections.namedtuple('Point', ['x', 'y'])
p=Point(1,2)
print(p.x, p.y)

from datetime import date,timedelta
d=date(2025,2,20)
print(d.weekday())
d+=timedelta(10)
print(d.day,d.month)
print(date.today())

Установка дополнительных пакетов

При установке Python в стандартной библиотеке находится минимальное количество пакетов для разных задач. Например, curses для создания интерфейсов консольных приложений, tkinter для GUI, sqlite3 для баз данных, http для разработки веб-клиентов и серверов. Дополнительные пакеты устанавливаются с сайта https://pypi.org с помощью программы pip:
pip install имя_пакета

Например,
pip install pcio