add launchers dir to the path pycharm что это
Command-line interface
Use PyCharm features from the command line: open files and projects, view diffs, merge files, apply code style formatting, and inspect the source code.
For information about running command-line tools from inside PyCharm, see Terminal emulator.
Launcher for a standalone instance
This command changes the PATH environment variable for the current shell only (the current instance of cmd.exe ). If you want to update it permanently for the current user, run setx :
The installer can do this for you if you select Add launchers dir to the PATH on the Installation Options step of the setup wizard.
To run PyCharm from the shell, use the open command with the following options:
-a : specify the application.
—args : specify additional arguments when passing more than just the file or directory to open.
-n : open a new instance of the application even if one is already running.
For example, you can run PyCharm.app with the following command:
If PyCharm is not in the default /Applications directory, specify the full path to it.
You can create a shell script with this command in a directory from your PATH environment variable. For example, create the file /usr/local/bin/pycharm with the following contents:
Make sure you have permissions to execute the script and since /usr/local/bin should be in the PATH environment variable by default, you should be able to run pycharm from anywhere in the shell.
Since /usr/local/bin should be in the PATH environment variable by default, you should be able to run the pycharm command from anywhere in the shell.
Shell scripts generated by the Toolbox App
If you are using the Toolbox App to install and manage JetBrains products, it can create shell scripts for launching your IDEs from the command line.
Generate shell scripts
If necessary, change the shell scripts location.
If you have several versions of the same IDE, the Toolbox App generates a shell script for each version with a unique name. You can change the name of the shell script for an IDE instance in the settings for this specific instance.
Change the name of the shell script
Open the Toolbox App.
At the bottom, change the Shell script name field.
By default, the Toolbox App puts shell scripts in a directory from the system PATH environment variable, so you can run the name of the script as a command to launch PyCharm from any working directory.
Command-line arguments
The launcher script accepts commands, options, and other arguments to modify its behavior:
Path to file or directory
Open the file or directory specified as the argument.
Open the diff viewer to see differences between two specified files.
Open the Merge dialog to merge the specified files.
Apply code style formatting to the specified files.
Perform code inspection on the specified project.
Do not show the splash screen when loading PyCharm.
Do not reopen projects and show the welcome screen. This can help if a project that was open crashes PyCharm for some reason.
Do not load manually installed plugins. This can help if a plugin that you installed crashes PyCharm for some reason. You will be able to start the IDE and either disable or uninstall the problematic plugin.
Wait for the files to be closed before returning to the command prompt.
Вся статья написана на духу и не является адаптацией любых других статей по этой теме.
Освещать буду такие темы, как:
Установка Python 3.7
Для программирования на питоне нам потребуется следующий инструментарий (доступен на linux, windows, mac)
В принципе, достаточно только python 3.7, но встроенная в него IDE не удобна, поэтому дополнительно я использую Atom и PyCharm.
Подсветка синтаксиса, древовидная структура проекта, поддержка системы контроля версий, (удобный поиск, дизайн, дополнения и тд).
Для Windows скачиваем по ссылкам интерпретатор и для комфортного кодинга PyCharm и Atom. При установке python 3.7 ставим галочку на ‘Add Python to PATH’ и выбираем ‘Customize installation’.
Во втором окне оставляем все по-умолчанию(выбраны все пункты), а в третьем добавляем пункт ‘Install for all users’.
После всех установок перезагружаем систему.
Для проверки правильности установки в командной строке пишем ‘python’, в случае успеха должен запустится интерпретатор.
Если этого не произошло, то, вероятно, в системе не прописались пути. Вручную пути (к папкам python37-32, python37-32\Scripts) добавить можно в ‘Компьютер’->’Свойства’->’Дополнительные параметры системы’->’Переменные системы’->’Path’->’Значение переменной’.
kali, mint, ubuntu:
arch, manjaro:
Настройка виртуального окружения.
Во время написания программ, нам часто нужны будут различные модули, которые отсутствуют в системе. Для их установки
ситуаций принято использовать виртуальное окружение (механизм venv).
При создании окружения, интерпретатор с базовыми библиотеками копируется в отдельную папку (рекомендуется положить к проекту), и при запуске кода вызывается локальный python. Если вы что-то сломаете, или установите лишние модули, то виртуальное окружение можно быстро переустановить.
Создание окружения
В командной строке (находясь в папке с проектом):
Bash:
Находясь в активированном окружении можем устанавливать модули локально, не засоряя систему.
Команды для работы с модулями:
Bash:
Также, важно держать файл с установленными библиотеками под рукой:
pip freeze > requirements.txt
При портировании проекта приложите requirements.txt к файлам проекта (папку env не нужно, только список txt).
На целевом компьютере создайте окружение, и выполните команду:
И все прописанные в файле модули нужных версий установятся в новое окружение.
Используя venv, вы всегда контролируете какие библиотеки необходимы (+достаточно) для корректной работы программы.
PyCharm сам следит за виртуальным окружением, облегчая некоторые аспекты работы с ним. При создании проекта выберите пункт ‘New environment using’.
При первом запуске проекта(нового или скопированного), убедитесь, что путь прописан правильно:
Для добавления окружения, нажмите на шестеренку->’Add’ и выберите создание нового или использование существующего (выбирать нужно ‘env\Scripts\python.exe’).
Если окружение не создано, PyCharm сообщит, что не может выполнить код программы, и сам предложит исправить это, отправив вас в настройки.
В данном случае спасает система контроля версий. Она в отдельной папке хранит все изменения вашего проекта. Можно откатиться к работающей версии, создать ветку для экспериментов и не боятся что-то сломать, хранить разные версии приложения в одном проекте, и при необходимости работать над одной или вносить исправления сразу в несколько.
Скачиваем на официальном сайте и устанавливаем (windows):
sudo apt-get install git
Проект подключенный к VCS называется репозиторием. Чтобы создать репозиторий выполним простые действия:
Запускаем командную строку(в папке с проектом):
Сейчас он пуст, даже если в папке есть файлы.
Если файлов нет, то система сообщит, что изменений не найдено. Давайте создадим файл run.py. При проверке статуса, система обнаружит изменение и предложит добавить файл в репозиторий.
Bash:
Файл добавлен, но не учтен, нужно сделать запись о наших изменениях:
Если это первый репозиторий git, то система выдаст ошибку: ‘Please tell me who you are’. Чтобы познакомиться с ним, введем команды, которые он нам предлагает:
Bash:
Теперь можем закоммитить (внести в базу изменения) добавленный файл.
Если перейдем к первому коммиту, содержание файла сотрется, так как в тот момент времени он был пуст. Вернуться обратно
можно той же командой, поменяв hash на второй коммит
Работа с ветками:
Скачивать репозиторий с gihub:
PyCharm и atom из коробки умеют работать с системами контроля версий. Если мы откроем проект, в котором VCS уже есть, то это отобразится в IDE. Всю работу с репозиторием можно выполнять прямо в PyCharm:
Не все файлы, которые хранятся в папке с проектом должны быть в репозитории. Например, виртуальное окружение, временные файлы созданные автоматически и тд. Для того, чтобы исключить файлы и папки, их нужно внести в файл ‘.gitignore’, который располагается на одном уровне с папкой ‘.git’. Автоматически это можно сделать при очередном коммите, в диалоговом окне правой кнопкой мыши щелкнуть по списку файлов и выбрать пункт ignore.
Теперь git не будет предлагать вносить в репозиторий файлы окружения и временные файлы
Для минимальной работы, этого, возможно, хватит, однако настоятельно рекомендую пройти полноценный курс по Git:
Советы по оформлению кода.
Для наиболее правильной работы программ, необходимо соблюдать некоторые правила, о них я сейчас и расскажу.
Рекомендации PEP8
Дзен Python
Набор правил, соблюдение которых практически гарантирует быструю и понятную разработку программных решений. Изучите и следуйте им:
Изучайте best practices
Разделяйте код на функции, модули, классы
Читать и исправлять ошибки в коде, написанным сплошным текстом как минимум сложно, а иногда невозможно без замены больших частей кода.
Поэтому к правилам хорошего разработчика относится разделение кода на небольшие части связанные по смыслу и назначению.
Для начала, начните код с подобной конструкции:
Python:
Выглядит эта конструкция так:
Python:
Валидация данных
Python:
Тем самым, вместо прерывания будут выполнены инструкции описанные в блоке except, при этом инструкции из блока try не будут выполнены.
Рефакторинг
Периодически проводите вышеперечисленные операции для улучшения кода, для выявления и исправления ошибок (а они есть
практически всегда). Находите более успешные реализации элементов программы, не бойтесь экспериментировать (при этом
пользуйтесь VCS для перестраховки).
Пример неплохого кода (калькулятор):
run.py:
calc_engine.py:
calculate.py:
Теперь при необходимости изменения программы, изменить нужный кусок кода будет проще, так как код держится обособленно.
Результат работы:
Компиляция exe
Самый старый способ и ныне не работает (на современных версиях python). Последний релиз был в конце 2014 года, и по легендам последняя версия, которую поддерживал была 3.4. Есть разные наработки с этой библиотекой на просторах интернета, но это уже ковыряние трупа, поэтому этим методом пользоваться не будем.
Тернистый путь установки:
Выполняя команду pip install cx_freeze командная строка сообщила, что нет VC++14
Install PyCharm
PyCharm is a cross-platform IDE that provides consistent experience on the Windows, macOS, and Linux operating systems.
System requirements
8 GB of total system RAM
Multi-core CPU. PyCharm supports multithreading for different operations and processes making it faster the more CPU cores it can use.
2.5 GB and another 1 GB for caches
SSD drive with at least 5 GB of free space
Officially released 64-bit versions of the following:
Microsoft Windows 8 or later
macOS 10.13 or later
Any Linux distribution that supports Gnome, KDE, or Unity DE. PyCharm is not available for some Linux distributions, such as RHEL6 or CentOS6, that do not include GLIBC 2.14 or later.
Pre-release versions are not supported.
Latest 64-bit version of Windows, macOS, or Linux (for example, Debian, Ubuntu, or RHEL)
You do not need to install Java to run PyCharm because JetBrains Runtime is bundled with the IDE (based on JRE 11).
Python 2: version 2.7
Python 3: from the version 3.6 up to the version 3.10
Install using the Toolbox App
The JetBrains Toolbox App is the recommended tool to install JetBrains products. Use it to install and manage different products or several versions of the same product, including Early Access Program (EAP) and Nightly releases, update and roll back when necessary, and easily remove any tool. The Toolbox App maintains a list of all your projects to quickly open any project in the right IDE and version.
Install the Toolbox App
Run the installer and follow the wizard steps.
After you run the Toolbox App, click its icon in the notification area and select which product and version you want to install.
Log in to your JetBrains Account from the Toolbox App and it will automatically activate the available licenses for any IDE that you install.
Install the Toolbox App
There are separate disk images for Intel and Apple Silicon processors.
Mount the image and drag the JetBrains Toolbox app to the Applications folder.
After you run the Toolbox App, click its icon in the main menu and select which product and version you want to install.
Log in to your JetBrains Account from the Toolbox App and it will automatically activate the available licenses for any IDE that you install.
Install the Toolbox App
Extract the tarball to a directory that supports file execution.
For example, if the downloaded version is 1.17.7391, you can extract it to the recommended /opt directory using the following command:
Execute the jetbrains-toolbox binary from the extracted directory to run the Toolbox App and select which product and version you want to install. After you run the Toolbox App for the first time, it will automatically add the Toolbox App icon to the main menu.
Log in to your JetBrains Account from the Toolbox App and it will automatically activate the available licenses for any IDE that you install.
You can use this shell script that automatically downloads the tarball with the latest version of the Toolbox App, extracts it to the recommended /opt directory, and creates a symbolic link in the /usr/local/bin directory.
Standalone installation
Install PyCharm manually to manage the location of every instance and all the configuration files. For example, if you have a policy that requires specific install locations.
To verify the integrity of the installer, use the SHA checksum linked from the Download page.
Run the installer and follow the wizard steps.
Mind the following options in the installation wizard
64-bit launcher : Adds a launching icon to the Desktop.
Open Folder as Project : Adds an option to the folder context menu that will allow opening the selected directory as a PyCharm project.
.py : Establishes an association with Python files to open them in PyCharm.
Add launchers dir to the PATH : Allows running this PyCharm instance from the Console without specifying the path to it.
There are separate disk images for Intel and Apple Silicon processors.
To verify the integrity of the downloaded disk image, use the SHA checksum linked from the Download page.
Mount the image and drag the PyCharm app to the Applications folder.
Run the PyCharm app from the Applications directory, Launchpad, or Spotlight.
Install using tar archives
Unpack the pycharm-*.tar.gz file to a different folder, if your current Download folder doesn’t support file execution:
To verify integrity of the downloaded archive, use the SHA checksum linked from the Download page.
Switch to the bin subdirectory:
Run pycharm.sh from the bin subdirectory.
Install using snap packages
For Ubuntu 16.04 and later, you can use snap packages to install PyCharm.
PyCharm is distributed via two channels:
The stable channel includes only stable versions. To install the latest stable release of PyCharm, run the following command:
The edge channel includes EAP builds. To install the latest EAP build of PyCharm, run the following command:
To create a desktop entry, do one of the following:
On the Welcome screen, click Configure | Create Desktop Entry
From the main menu, click Tools | Create Desktop Entry
When you run PyCharm for the first time, some steps are required to complete the installation, customize your instance, and start working with the IDE.
For information about the location of the default IDE directories with user-specific files, see Directories used by the IDE.
Silent installation on Windows
Silent installation is performed without any user interface. It can be used by network administrators to install PyCharm on a number of machines and avoid interrupting other users.
To perform silent install, run the installer with the following switches:
/S : Enable silent install
/CONFIG : Specify the path to the silent configuration file
/D : Specify the path to the installation directory
This parameter must be the last in the command line and it should not contain any quotes even if the path contains blank spaces.
To check for issues during the installation process, add the /LOG switch with the log file path and name between the /S and /D parameters. The installer will generate the specified log file. For example:
Silent configuration file
The default silent configuration file is unique for each JetBrains product. You can modify it to enable or disable various installation options as necessary.
Создание виртуальных окружений и установка библиотек для Python 3 в IDE PyCharm
Язык программирования Python считается достаточно простым. На нем легче и быстрее пишутся программы, по сравнению с компилируемыми языками программирования. Для Python существует множество библиотек, позволяющих решать практически любые задачи. Есть, конечно, и минусы и другие нюансы, но это отдельная тема.
Довольно часто я вижу, как мои знакомые и друзья начинают изучать Python и сталкиваются с проблемой установки и использования сторонних библиотек. Они могут несколько часов потратить на установку библиотеки, и даже, могут не справиться с этим и забить на неё. В то время как, в большинстве случаев, это можно было сделать за несколько минут.
Статья начинается с базовых вещей: с установки Python 3, инструментов разработки Pip и Virtualenv и среды разработки PyCharm в Windows и в Ubuntu. Для многих это не представляет трудностей и возможно, что уже всё установлено.
После чего будет то, ради чего задумывалась статья, я покажу как в PyCharm создавать и использовать виртуальные окружения и устанавливать в них библиотеки с помощью Pip.
Установка Python и Pip
Pip является менеджером пакетов для Python. Именно с помощью него обычно устанавливаются модули/библиотеки для разработки в виде пакетов. В Windows Pip можно установить через стандартный установщик Python. В Ubuntu Pip ставится отдельно.
Установка Python и Pip в Windows
Для windows заходим на официальную страницу загрузки, где затем переходим на страницу загрузки определенной версии Python. У меня используется Python 3.6.8, из-за того, что LLVM 9 требует установленного Python 3.6.
Во время установки ставим галочку возле Add Python 3.x to PATH и нажимаем Install Now:
Установка Python и Pip в Ubuntu
В Ubuntu установить Python 3 можно через терминал. Запускаем его и вводим команду установки. Вторая команда выводит версию Python.
Далее устанавливаем Pip и обновляем его. После обновления необходимо перезапустить текущую сессию (или перезагрузить компьютер), иначе возникнет ошибка во время вызова Pip.
Основные команды Pip
Рассмотрим основные команды при работе с Pip в командой строке Windows и в терминале Ubuntu.
Установка VirtualEnv и VirtualEnvWrapper
VirtualEnv используется для создания виртуальных окружений для Python программ. Это необходимо для избежания конфликтов, позволяя установить одну версию библиотеки для одной программы, и другу для второй. Всё удобство использования VirtualEnv постигается на практике.
Установка VirtualEnv и VirtualEnvWrapper в Windows
В командной строке выполняем команды:
Установка VirtualEnv и VirtualEnvWrapper в Ubuntu
Для Ubuntu команда установки будет следующей:
После которой в конец
Работа с виртуальным окружением VirtualEnv
Рассмотрим основные команды при работе с VirtualEnv в командой строке Windows и в терминале Ubuntu.
Команда | Описание |
---|---|
mkvirtualenv env-name | Создаем новое окружение |
workon | Смотрим список окружений |
workon env-name | Меняем окружение |
deactivate | Выходим из окружения |
rmvirtualenv env-name | Удаляем окружение |
Установка PyCharm
PyCharm — интегрированная среда разработки для языка программирования Python. Обладает всеми базовыми вещами необходимых для разработки. В нашем случае огромное значение имеет хорошее взаимодействие PyCharm с VirtualEnv и Pip, чем мы и будем пользоваться.
Установка PyCharm в Windows
Скачиваем установщик PyCharm Community для Windows с официального сайта JetBrains. Если умеете проверять контрольные суммы у скаченных файлов, то не забываем это сделать.
В самой установке ничего особенного нету. По сути только нажимаем на кнопки next, и в завершение на кнопку Install. Единственно, можно убрать версию из имени папки установки, т.к. PyCharm постоянно обновляется и указанная версия в будущем станет не правильной.
Установка PyCharm в Ubuntu
Скачиваем установщик PyCharm Community для Linux с официального сайта JetBrains. Очень хорошей практикой является проверка контрольных сумм, так что если умеете, не ленитесь с проверкой.
Теперь в директории
Далее выполняем команды в терминале:
Производим установку. И очень важно в конце не забыть создать desktop файл для запуска PyCharm. Для этого в Окне приветствия в нижнем правом углу нажимаем на Configure → Create Desktop Entry.
Установка PyCharm в Ubuntu из snap-пакета
PyCharm теперь можно устанавливать из snap-пакета. Если вы используете Ubuntu 16.04 или более позднюю версию, можете установить PyCharm из командной строки.
Использование VirtualEnv и Pip в PyCharm
Поддержка Pip и Virtualenv в PyCharm появилась уже довольно давно. Иногда конечно возникают проблемы, но взаимодействие работает в основном стабильно.
Рассмотрим два варианта работы с виртуальными окружениями:
Первый пример: использование собственного виртуального окружения для проекта
Создадим программу, генерирующую изображение с тремя графиками нормального распределения Гаусса Для этого будут использоваться библиотеки matplotlib и numpy, которые будут установлены в специальное созданное виртуальное окружение для программы.
Запускаем PyCharm и окне приветствия выбираем Create New Project.
В мастере создания проекта, указываем в поле Location путь расположения создаваемого проекта. Имя конечной директории также является именем проекта. В примере директория называется ‘first_program’.
Теперь установим библиотеки, которые будем использовать в программе. С помощью главного меню переходим в настройки File → Settings. Где переходим в Project: project_name → Project Interpreter.
Здесь мы видим таблицу со списком установленных пакетов. В начале установлено только два пакета: pip и setuptools.
Справа от таблицы имеется панель управления с четырьмя кнопками:
Для добавления (установки) библиотеки в окружение нажимаем на плюс. В поле поиска вводим название библиотеки. В данном примере будем устанавливать matplotlib. Дополнительно, через Specify version можно указать версию устанавливаемого пакета и через Options указать параметры. Сейчас для matplotlib нет необходимости в дополнительных параметрах. Для установки нажимаем Install Package.
После установки закрываем окно добавления пакетов в проект и видим, что в окружение проекта добавился пакет matplotlib с его зависимостями. В том, числе был установлен пакет с библиотекой numpy. Выходим из настроек.
Теперь мы можем создать файл с кодом в проекте, например, first.py. Код программы имеет следующий вид:
Далее указываем в поле Name имя конфигурации и в поле Script path расположение Python файла с кодом программы. Остальные параметры не трогаем. В завершение нажимаем на Apply, затем на OK.
Теперь можно выполнить программу и в директории с программой появится файл gauss.png :
Второй пример: использование предварительно созданного виртуального окружения
Данный пример можно использовать во время изучения работы с библиотекой. Например, изучаем PySide2 и нам придется создать множество проектов. Создание для каждого проекта отдельного окружения довольно накладно. Это нужно каждый раз скачивать пакеты, также свободное место на локальных дисках ограничено.
Более практично заранее подготовить окружение с установленными нужными библиотеками. И во время создания проектов использовать это окружение.
В этом примере мы создадим виртуальное окружения PySide2, куда установим данную библиотеку. Затем создадим программу, использующую библиотеку PySide2 из предварительно созданного виртуального окружения. Программа будет показывать метку, отображающую версию установленной библиотеки PySide2.
Далее в созданном окружении устанавливаем пакет с библиотекой PySide2, также как мы устанавливали matplotlib. И выходим из настроек.
Теперь мы можем создавать новый проект использующий библиотеку PySide2. В окне приветствия выбираем Create New Project.
Для проверки работы библиотеки создаем файл second.py со следующий кодом:
Далее создаем конфигурацию запуска программы, также как создавали для первого примера. После чего можно выполнить программу.
Заключение
У меня нет богатого опыта программирования на Python. И я не знаком с другими IDE для Python. Поэтому, возможно, данные IDE также умеют работать с Pip и Virtualenv. Использовать Pip и Virtualenv можно в командой строке или в терминале. Установка библиотеки через Pip может завершиться ошибкой. Есть способы установки библиотек без Pip. Также создавать виртуальные окружения можно не только с помощью Virtualenv.
В общем, я лишь поделился небольшой частью опыта из данной области. Но, если не вдаваться в глубокие дебри, то этого вполне достаточно знать, чтобы писать простые программы на Python с использованием сторонних библиотек.