Документация по языку Python3.
Площадка docs-python.ru посвящена языку программирования Python3 и представляет из себя справочную документацию.
Основная цель площадки: сделать доступной справочную информацию о языке Python на русском языке по максимуму. Именно охват максимума, а не только поверхностный разбор популярных встроенных функций, классов и модулей стандартной библиотеки, о которых в интернете и без нас достаточно информации.
На сайте есть разделы, где информация подана не совсем качественно. Мы об этом знаем и работаем над этим, к тому же разместили кнопку: 'Сообщить о неточности'.
На площадке представлены 3 раздела:
- Разобраны основные типы данных языка Python, такие как строки, списки и словари, кортежи и множества, классы и т. д.
- Рассмотрен синтаксис и конструкции языка - циклы, ветвление программы, обработка исключений, тернарные операторы и т. д.
- Приведены примеры деления программы на модули и способы написания чистого, хорошо читаемого кода.
- Имеется справочник встроенных функций в интерпретатор с огромным количеством примеров их использования.
- Так же подберете себе IDE редактор (интегрированную среду разработки) для облегчения написание кода.
- Самоучитель поддерживается в актуальном состоянии и пополняется новыми конструкциями языка.
- Богатая стандартная библиотека является одной из привлекательных сторон языка программирования Python.
- Раздел построен в виде справочника, подобного официальной документации Python3.
- Практически каждый, разобранный здесь модуль, снабжен множеством примеров практического использования.
- На данный момент представлена документация с примерами более чем по 100 встроенным модулям и пакетам. Среди которых:
- все математические модули и модули, отвечающие за работу со строками;
- криптографические модули и модули для работы с архивами;
- модули, которые дополняют стандартные встроенные типы и расширяют функционал языка;
- модули, отвечающие за работу со встроенными функциями OS;
- модули, позволяющие работать с базами данных и различными форматами файлов (
.csv, .json, .ini); - модули для тестирования и логирования ошибок в программах Python;
- и многое другое ...
- Раздел открыт недавно, в Марте 2021 года.
- Публикуются только полезные и часто используемые модули/пакеты (по мнению команды).
- Главные монменты из документации модулям/пакетам с богатыми примерами.
- Разобраны стандартные и нестандартные приемы использования по каждому модулю/пакету.
- У основных классов и функций модулей/пакетов разобраны значения всех аргументов.
- Документация постоянно обновляется и пополняется новыми примерами, модулями и пакетами.
Последние добавленные или измененные записи:
В разделе представлен список всех встроенных фильтров с их полным описанием и примерами использования в шаблонах jinja2.
Внутри блоков кода также можно присваивать значения переменным. Присвоение значений на верхнем уровне (за пределами блоков {% block ... %}, макросов {% macro ... %} или циклов {% for ... %}) экспортируются из шаблона, как макросы верхнего уровня, и могут быть импортированы с другими шаблонами.
Оператор if/elif/else в шаблонах Jinja2 сравним с оператором if/else в Python. В простейшей форме, можно использовать его, чтобы проверить, определена ли переменная, не пуста и не ложна. Для нескольких веток можно использовать elif и else, как в Python.
Довольно часто возникают ситуации, когда нужно генерировать определенные отчеты или манипулировать строками. Общим для всех этих ситуаций является то, что создание отчета или обработка строк следует определенному шаблону. Обычно шаблоны очень похожи и мы их используем повторно.
Тип аннотации Union[] модуля typing представляет собой тип объединения typing.Union[X, Y], который означает либо X, либо Y. Чтобы определить аннотацию объединения, используйте, например, Union[int, str].
Функция len() возвращает длину (количество элементов) в объекте. Аргумент может быть последовательностью или коллекцией
Функция enumerate() возвращает кортеж, содержащий пары ('счётчик', 'элемент') для элементов указанного объекта.
Функция sample() модуля random возвращает список длины k случайных элементов, выбранных из последовательности или множества population. Исходная последовательность population остается неизменной. Используется для случайной выборки без замены.
Функция random.choices() модуля random возвращает список элементов длины k, выбранных из последовательности population с перестановкой элементов. Возвращаемые элементы не сохраняют первоначальный порядок.