Открытый код: как начать свой первый проект на Python

Открытый код: как начать свой первый проект на Python

Python — это язык программирования , который славится своей простотой и универсальностью. Он отлично подходит для начинающих программистов , поскольку его синтаксис легко читается и понимается. Python используется в самых разных областях , от веб-разработки и анализа данных до машинного обучения и автоматизации задач. Именно поэтому изучение Python — это отличный выбор для тех , кто хочет погрузиться в мир программирования и открыть для себя множество интересных возможностей !

Представьте себе , что вы — архитектор , который строит дом. Python — это ваш строительный материал , а проект — это план вашего будущего дома. Прежде чем начать строить , необходимо создать проект , который будет содержать все детали и инструкции. Точно так же , перед тем как начать писать код на Python , нужно создать проект , который будет служить основой для вашей программы. ️

В этой статье мы подробно разберем , как создать свой первый проект на Python , какие инструменты для этого использовать и какие возможности открываются перед вами. Погрузимся в мир Python и начнем строить !

Перейдите к интересующему разделу, выбрав соответствующую ссылку:

Создание проекта на Python – это увлекательный процесс, открывающий двери в мир программирования! Давайте шаг за шагом разберем, как начать свой первый проект. Представьте: вы сидите за компьютером, готовые к созданию чего-то нового и интересного. ✨
Первым делом необходимо открыть вашу среду разработки Python (например, PyCharm, VS Code или Thonny). Интерфейс может немного отличаться в зависимости от выбранной IDE, но общая идея останется неизменной. Главное – найти пункт меню «File» (Файл). В этом меню вы обнаружите волшебную опцию «New Project…» (Новый проект…).
Нажав на неё, вы увидите диалоговое окно, требующее от вас ввода некоторых параметров. Первым делом – это имя проекта. Здесь можно проявить фантазию! Название должно отражать суть вашего проекта, быть понятным и запоминающимся. Например, «МойПервыйПроект», «Калькулятор» или «ИграУгадайка».
Далее вам предложат выбрать интерпретатор Python. Это тот самый «двигатель», который будет исполнять ваш код. Укажите нужную версию Python (например, Python 3.9, Python 3.10 и т.д.). Это обычно указывается как «XX» в инструкции. Важно выбрать версию, установленную на вашем компьютере. ⚙️
В некоторых IDE будет поле «Имя пользователя» – это обычно имя вашего аккаунта в системе. Система, как правило, автоматически подставляет это значение. Если нет, то впишите свое имя пользователя.
После того, как вы заполнили все необходимые поля, смело нажимайте кнопку «Create» (Создать). И вот он – ваш новый проект! Перед вами откроется окно с файлом main.py. Это ваш стартовый файл, место, где вы напишете свой первый код на Python.
Теперь можно приступать к написанию кода! Не бойтесь экспериментировать, пробовать разные варианты и учиться на своих ошибках. Помните, что даже самые сложные программы начинаются с маленького файла main.py. Удачи в вашем программистском путешествии!

Связанные вопросы и ответы:

Что такое открытый код

Иногда разработчики создают программное обеспечение с открытым исходным кодом не с целью прибыли, а чтобы внести свой вклад в развитие интернета в целом.

Эти программы известны как открытые, или open source. Их исходный код доступен для изучения и модификации. Они представляют альтернативу закрытому или проприетарному программному обеспечению, где разработчики ограничивают доступ к коду, запрещают его копирование, анализ, а затем делают программы платными. Сторонники концепции open source придерживаются других принципов.

Open source дает возможность доступа к исходному коду программы или приложения, но это не значит, что его можно бесконтрольно использовать. Лицензии для открытого кода играют важную роль в определении правил его использования. Даже при открытости авторы стремятся сохранить свои авторские права, установить условия для изменения, распространения кода, а также защитить себя от юридических последствий. Лицензии также способствуют поддержанию духа совместной разработки, гарантируя, что измененный код останется доступным для сообщества. Они устанавливают четкие правила для работы, защищая интересы всех участников процесса.

Каждый день пользователи со всего мира объединяют свои усилия, чтобы улучшать open source программное обеспечение, придумывая новые возможности. Многие современные программы, которыми мы пользуемся ежедневно, основаны на принципах open source. Например, браузеры Google Chrome, Opera и Яндекс Браузер основаны на открытом браузере Chromium, а ОС Android — на открытом ядре Linux.

Рассмотрим различные виды программ и устройство мира open source.

Какие преимущества имеет открытый код

Open source software — ПО с открытым исходным кодом, который находится в свободном доступе. Пользователи могут не только просматривать его, но и копировать, использовать для разработки своих проектов или модифицировать части кода.

Степень свободы действий зависит от типа лицензии, на основании которой разработчик работает с софтом. Лицензирование отличается от авторского права: чаще всего создатель открытого кода не требует платить за продукт. Однако ряд ограничений все же есть. Они зависят от того, какой тип лицензии выберет пользователь.

В open source есть две группы лицензионных соглашений — public domain и copyleft. Первая дает больше возможностей: можно распространять проекты на основе авторского кода, делиться ими. Часто в договоре указывают, что разработчик вправе продавать получившийся у него продукт. Copyleft требует от лицензиата применения такой же лицензии к собственному проекту на основе открытого кода. Он не может сделать его закрытым или установить дополнительные ограничения. Крупные компании уже давно выпускают OSS (open source software), например, Linux Foundation, MySQL, Apache. Среди стартапов, ориентированных на отрасль ИТ, также есть те, кто создает решения с открытым исходным кодом. Например, Snyk предлагает анализ композиции открытого ПО (SCA), а Sanity делает опенсорс-CMS.

Бесплатное ПО может быть опенсорсом, но не все приложения с открытым кодом бесплатны. NASA выпустило большое количество программных инструментов с открытым кодом, которые не считаются бесплатными. Компания разрешает пользователю изменять коды этих инструментов только в случае, если вся модификация реализована с нуля. Таким образом, изменения с использованием стороннего кода запрещены.

Какие инструменты и технологии используются для создания открытого кода на Python

Python очень популярный язык программирования. Благодаря открытому исходному коду и использованию в качестве скриптового языка, языка веб программирования, мобильных и настольных приложений. Все это возможно благодаря безграничным опциям модулей Python . При написании кода в Python, интегрирования модулей и библиотек для построения больших систем, текстового редактора недостаточно, нам нужна хорошо интегрированная среда разработки для этих целей. Мы провели небольшое исследование и составили следующий список лучших(начиная с лучшего):

PyCharm

• Создатель JetBrains
• Закрытый исходник
• Поддержка Windows, MacOS и Linux

Разработан под Python, Javascript, Coffeescript, Typescript, HTML/CSS, AngularJS, Node.js и другие языки. Возможности интегрированного модульного тестирования, проверки кода, интегрированного контроля версий, инструменты рефакторинга кода, набор инструментов для навигации проекта, выделения и автоматического завершения. Поддержка ряда сторонних фреймворков для веб-разработки, таких как Django, Pyramid, web2py, Google App Engine и Flask, что делает его универсальной IDE для быстрой разработки приложений.

PyDev

• Плагин Python для Eclipse
• Поддерживается всеми известными операционными системами
• Источники в свободном доступе по публичной лицензии Eclipse
• Обработка доработки кода, интеграция отладки Python, добавление токен-браузера, инструменты рефакторинга и многое другое
• Возможность создания новых проектов Django, выполнение команд Django при помочи горячих клавиш и использование отдельной конфигурации запуска только для Django.

WingWare

• Отличный IDE, разработанный WingWare
• Поддержка Windows, Linux и MacOS
• Это закрытый исходник

Содержит мощный инструмент отладки , который позволяет устанавливать контрольные точки, возможность пошагового выполнения кода, проверка данных, удаленная отладка и отладка шаблонов Django . Поддержка matplotlib , с автоматическим обновлением графиков. Также предоставляется доработка кода, подсветка синтаксиса, исходный браузер, графический отладчик и поддержка систем управления версиями.

Komodo IDE

• IDE для динамических языков, таких как Python, PHP и RUBY
• Поддержка Windows, MacOS и Linux
• Закрытый исходник с собственной лицензией

Поддержка Django: подсветка синтаксиса и завершение кода для шаблонов (кстати, я так и не столкнулся с ситуацией, где это было бы применимо). Содержит базовые функции, такие как рефакторинг кода, автозаполнение, calltips, сопоставление скобок, браузер кода, переход к определению, графическая отладка, многопроцессная отладка, многопоточная отладка, конфигурация точки остановки, профилирование кода, интеграция с тестируемым юнитом и интеграция со сторонними библиотеками, такими как pyWin32. Также в наличии такие функции как интеграция менеджера пакетов, отслеживание изменений, инструмент просмотра заметок, быстрые закладки, переход ко всему (Commando) и многое другое.

Eric

• IDE и по совместительству редактор Python от Detlev Offenbach.
• С открытым кодом
• Поддержка Windows

Содержит такие функции как отладчик Python и Ruby, покрытие кода, автоматическая проверка кода, оболочка Python и Ruby, браузер класса и многое другое. Также имеются функции для совместного редактирования. Диалоги Regex и Qt, опции для создания сторонних приложений прямо в редакторе, диаграммы приложения, возможности управления проектами, а также интерактивная оболочка Python. Многоязычный пользовательский интерфейс, который включает в себя Английский, Немецкий, Русский, Французский, Испанский, Итальянский, Турецкий и Китайский языки, контроль версии для Subversion, Mercurial и Git, использование объявлений в плагинах, и многое другое.

Eclipse

• Платформа общего назначения
• Поддержка всеми операционными системами
• Открытый код и поддержка всех ведомых языков
• Великое множество плагинов

Есть вопросы по Python?

На нашем форуме вы можете задать любой вопрос и получить ответ от всего нашего сообщества!

Python Форум Помощи

Вступите в наш дружный чат по Python и начните общение с единомышленниками! Станьте частью большого сообщества!

Чат

Канал

Одно из самых больших сообществ по Python в социальной сети ВК.

Как выбрать подходящий проект для открытого кода на Python

Открываем файл setup.py и пишем в нём такой код:

from setuptools import setup, find_packages def readme(): with open('README.md', 'r') as f: return f.read() setup( name='package_name', version='1.0.0', author='your_nickname', author_email='example@gmail.com', description='This is my first module', long_description=readme(), long_description_content_type='text/markdown', url='home_link', packages=find_packages(), install_requires==2.25.1'>, classifiers=, keywords='example python', project_urls={ 'Documentation': 'link' }, python_requires='>=3.7' )

Давайте подробно рассмотрим написанный выше код. Первая строчка - это импортирование двух функций из библиотеки setuptools , которую вы должны были установить. Функция setup - это функция установки модуля, в которою передаются его параметры. Функция find_packages ищет все пакеты директории. На третьей строчке я написал функцию, которая читает весь текст из файла README.md . Это было сделано для удобства. На седьмой строчке вызываем функцию setup и передаём в неё некоторые параметры. Рассмотрим каждый параметр по отдельности:

name - имя пакета.

version - версия пакета. Если вы захотите обновить модуль, версия обязательно должна быть другой.

author - автор проекта. Можете написать там ваше имя или ваш никнейм (или что захотите).

author_email - ваша электронная почта (либо не ваша, как хотите).

description - короткое описание пакета.

long_description - подробное описание пакета. В данном случае содержимое файла README.md .

long_description_content_type - разметка, используемая в подробном описании. Здесь она указана как Markdown .

url - ссылка на домашнюю страницу пакета. Чаще всего, пишут ссылку на репозиторий проекта на GitHub.

packages - список пакетов, которые должны опубликоваться. Для удобства я использовал функцию find_packages .

install_requires - зависимости, которые будут установлены вместе с пакетом.

classifiers - метаданные о пакете.

keywords - ключевые слова (должны быть указаны через пробел).

project_urls - дополнительные ссылки пакета. В данном примере я указал только ссылку на документацию.

python_requires - требуемая версия Python.

Как организовать работу над проектом

Откройте окно терминала (как было описано в главе) и запустите интерпретатор Python, введя командуpython3и нажавEnter.

Пользователи Windows могут запустить интерпретатор в командной строке, если установили переменнуюPATHнадлежащим образом. Чтобы открыть командную строку в Windows, зайдите в меню "Пуск" и нажмите "Выполнить…". В появившемся диалоговом окне введите "cmd" и нажмитеEnter; теперь у вас будет всё необходимое для начала работы с python в командной строке DOS.

Если вы используете IDLE, нажмите "Пуск" → "Программы" → "Python 3.0" → "IDLE (Python GUI)".

Как только вы запустилиpython3, вы должны увидеть>>>в начале строки, где вы можете что-то набирать. Это и называется командной строкой интерпретатора Python .

Теперь введитеprint('Hello World')и нажмите клавишуEnter. В результате должны появиться слова "Hello World".

Вот пример того, что вы можете увидеть на экране, если будете использовать компьютер с Mac OS X. Информация о версии Python может отличаться в зависимости от компьютера, но часть, начинающаяся с приглашения (т. е. от>>>и далее) должна быть одинаковой на всех операционных системах.

$ python3 Python 3.3.0 (default, Oct 22 2012, 12:20:36) on darwin Type "help", "copyright", "credits" or "license" for more information. >>> print('hello world') hello world >>>

Обратите внимание, что Python выдаёт результат работы строки немедленно! Вы только что ввели одиночный "оператор" Python.printиспользуется для того, чтобы (что неудивительно) напечатать любое переданное в него значение. В данном случае мы передали в него текст "Hello World", который и был напечатан на экране.

Как выйти из командной строки интерпретатора

Если вы используете IDLE или оболочку GNU/Linux или BSD, вы можете выйти из командной строки интерпретатора нажатиемCtrl-Dили введя командуexit()(примечание: не забудьте написать скобки, "()"), а затем нажав клавишуEnter. Если вы используете командную строку Windows, нажмитеCtrl-Z, а затем нажмите клавишуEnter.

Как создать репозиторий для открытого кода на Python

Перейдите на сайти скачайте GitHub Desktop — это приложение, которое позволит синхронизировать удалённый репозиторий на GitHub и файлы на вашем компьютере без командной строки терминала:

• Скачиваем приложение под свою операционную систему.
• Открываем приложение и проходим авторизацию — нужно указать электронную почту и данные вашего GitHub-аккаунта.
• Приложение синхронизируется с удалённым репозиторием и предложит выполнить одно из следующих действий: создать новый репозиторий, добавить локальную папку с компьютера в GitHub Desktop или клонировать существующий репозиторий в папку компьютера.

Мы создали тестовый удалённый репозиторий, поэтому выберем третий вариант — клонировать существующий репозиторий в папку компьютера.

После установки GitHub Desktop запросит синхронизацию с GitHub-аккаунтом. Если аккаунта нет, приложение предложит его создать
Скриншот: GitHub / Skillbox Media

Рабочее пространство в GitHub Desktop — мы можем клонировать репозиторий, создать новый или перенести нужные файлы с компьютера
Скриншот: GitHub / Skillbox Media

Выбираем репозиторий, сохраняем его на рабочем столе и жмём кнопку Clone
Скриншот: GitHub / Skillbox Media

После клонирования репозитория в рабочем пространстве появятся три вкладки:Current Repository,Current BranchиFetch origin.

Current Repository— раздел позволяет переключаться между несколькими репозиториями, отслеживать невнесённые изменения (вкладкаChanges) и смотреть историю коммитов (вкладкаHistory). Current Branch— раздел позволяет переключаться между несколькими ветками проекта. Fetch origin— раздел обновляет внесённые изменения и синхронизирует файлы локального и удалённого репозитория.

Обратите внимание на разделCurrent Repositoryи вкладкуChanges. В левом нижнем углу есть окно для добавления коммитов и комментариев — это означает, что вы можете записывать каждый шаг, не посещая сайт GitHub.

На скриншоте первый коммит технический, он указывает на то, что мы создали репозиторий. Второй коммит наш — им мы редактировали файлgitignore. История хранит все коммиты, и мы можем вернуться к любому из них. Это страховка от непредвиденных случаев.

Как работать с открытым кодом на Python в команде

Когда нужно протестировать системные сообщения или перехватить ошибку, помогают фикстуры, которые умеют работать с потоками вывода.

Capfd — фикстура для работы с потоками стандартного ввода и вывода ошибок на уровне операционной системы. Она позволяет перехватывать не только то, что происходит в python-коде, но и то, что происходит в операционной системе.

Захваченный вывод доступен через вызов метода capfd.readouterr(), который возвращает named tuple с stderr и stdout в виде строк.

def test_system_echo(capfd): os.system('echo "hello"') captured = capfd.readouterr() assert captured.out == "hello\n"

Capfdbinary — тоже работает со стандартным выводом и ошибками, но возвращает именованный кортеж, где сообщения из stderr и stdout представлены в виде байтовых строк.

def test_system_echo(capfdbinary): os.system('echo "hello"') captured = capfdbinary.readouterr() assert captured.out == b"hello\n"

Capsys — фикстура для работы с потоками для стандартного вывода и вывода ошибок на уровне python-кода. Захватывает sys.stdout и sys.stderr из кода и возвращает в виде строк.

def test_output(capsys): print("hello") captured = capsys.readouterr() assert captured.out == "hello\n"

Capsysbinary — подходит для работы с потоками стандартного вывода на уровне python-кода. Захватывает sys.stdout и sys.stderr из кода и возвращает в виде байтовых строк.