Документация по языку Python3.
Площадка docs-python.ru посвящена языку программирования Python3 и представляет из себя справочную документацию.
Основная цель площадки: сделать доступной справочную информацию о языке Python на русском языке по максимуму. Именно охват максимума, а не только поверхностный разбор популярных встроенных функций, классов и модулей стандартной библиотеки, о которых в интернете и без нас достаточно информации.
На сайте есть разделы, где информация подана не совсем качественно. Мы об этом знаем и работаем над этим, к тому же разместили кнопку: 'Сообщить о неточности'.
На площадке представлены 3 раздела:
- Разобраны основные типы данных языка Python, такие как строки, списки и словари, кортежи и множества, классы и т. д.
- Рассмотрен синтаксис и конструкции языка - циклы, ветвление программы, обработка исключений, тернарные операторы и т. д.
- Приведены примеры деления программы на модули и способы написания чистого, хорошо читаемого кода.
- Имеется справочник встроенных функций в интерпретатор с огромным количеством примеров их использования.
- Так же подберете себе IDE редактор (интегрированную среду разработки) для облегчения написание кода.
- Самоучитель поддерживается в актуальном состоянии и пополняется новыми конструкциями языка.
- Богатая стандартная библиотека является одной из привлекательных сторон языка программирования Python.
- Раздел построен в виде справочника, подобного официальной документации Python3.
- Практически каждый, разобранный здесь модуль, снабжен множеством примеров практического использования.
- На данный момент представлена документация с примерами более чем по 100 встроенным модулям и пакетам. Среди которых:
- все математические модули и модули, отвечающие за работу со строками;
- криптографические модули и модули для работы с архивами;
- модули, которые дополняют стандартные встроенные типы и расширяют функционал языка;
- модули, отвечающие за работу со встроенными функциями OS;
- модули, позволяющие работать с базами данных и различными форматами файлов (
.csv, .json, .ini); - модули для тестирования и логирования ошибок в программах Python;
- и многое другое ...
- Раздел открыт недавно, в Марте 2021 года.
- Публикуются только полезные и часто используемые модули/пакеты (по мнению команды).
- Главные монменты из документации модулям/пакетам с богатыми примерами.
- Разобраны стандартные и нестандартные приемы использования по каждому модулю/пакету.
- У основных классов и функций модулей/пакетов разобраны значения всех аргументов.
- Документация постоянно обновляется и пополняется новыми примерами, модулями и пакетами.
Последние добавленные или измененные записи:
Класс Template() модуля jinja2 представляет собой центральный объект шаблона. Этот класс представляет собой скомпилированный шаблон и используется для его оценки. Обычно объект Template создается из jinja2.Environment, но eго также есть можно создать напрямую.
Функция rmtree() модуля shutil рекурсивно удаляет все дерево каталогов. Путь path должен указывать на каталог, но не символическую ссылку на каталог.
Описанные ниже методы позволяют создать/удалить файл, каталог или символическую ссылку средствами модуля pathlib. Данные методы принадлежат экземпляру, созданному из класса Path().
Функция dataclass() модуля dataclasses является декоратором, который используется для добавления сгенерированных специальных методов к классам. Декоратор ищет поля, имеющие аннотацию типа и определяет их как переменные класса. @dataclass() не проверяет, указанный в аннотации, тип переменной!
В материале представлены разные подходы к сравнению двух списков и вычисления их идентичности.
Рассмотрены разные случаи итерации по разным типам данных. Приведены подробные примеры кода.
Контекст шаблона jinja2.runtime.Context() содержит все переменные шаблона. В нем хранятся значения, переданные в шаблон, а также имена, которые экспортирует шаблон. Создание экземпляров Context не поддерживается, т.к. он создается автоматически на различных этапах оценки шаблона и не должен создава
Приведенные в материале вспомогательные декораторы и функции модуля jinja2 полезны, если добавляются свои собственные фильтры или функции в среду Jinja.
Довольно часто возникают ситуации, когда нужно генерировать определенные отчеты или манипулировать строками. Общим для всех этих ситуаций является то, что создание отчета или обработка строк следует определенному шаблону. Обычно шаблоны очень похожи и мы их используем повторно.