Install, uninstall, and upgrade packages
PyCharm provides methods for installing, uninstalling, and upgrading Python packages for a particular Python interpreter. It means that each project has its own set of packages, which is considered a best practice for Python dependency management. By default, PyCharm uses pip to manage project packages. For Conda environments you can use the conda package manager.
In PyCharm, you can preview and manage packages in the Python Packages tool window and in the Python interpreter Settings .
Manage packages in the Python Packages tool window
This tool window is available in PyCharm 2021.1 and later
The Python Packages tool window provides the quickest and neat way to preview and install packages for the currently selected Python interpreter. This window is enabled by default, and you can find it in the lower group of the tool windows. At any time you can open it using the main menu: View | Tool Windows | Python Packages .
The Python Packages tool window shows installed packages and the packages available in the PyPI and Conda package repositories. Use the Search field to filter out the list of the available packages.
You can preview package documentation in the documentation area, or you can click the Documentation link and open the corresponding resource in a browser.
To delete an installed package, click in the upper-right corner of the Python Package tool window.
Install packages from repositories
Start typing the package name in the Search field of the Python Package tool window. You should be able to see the number of the matching packages.
Expand the list of the available versions in the upper-right corner of the tool window. Select the required version or keep it the latest.
Click the Install with pip or Install with conda button next to the version list. Once PyCharm notifies you about successful installation, you should see the package in the list of the installed packages.
If needed, click and provide a path to any custom repository you want to install from.
Manage package repositories
To specify a custom repository, including devpi or PyPi, click on the Python Packages toolbar.
In the Python Packages Repositories dialog, click to add a new repository. If no authorization is required, for example, in the case of a local repository, type the target URL and click OK .
If you want to install Python packages from a repository that requires HTTP authorization, click Basic HTTP and type the repository URL and the login credentials. Click OK to complete the task.
Once the repository is added, it appears in the list of the repositories in the Python Packages tool window.
Install packages from Version Control System
Click the Add Package link on the Python Packages toolbar and select From Version Control .
Specify a path to the target git repository. Refer to pip documentation for more information about supported path formats.
Select Install as editable (-e) if you want to install a project in editable mode (for example, setuptools develop mode ).
Install packages from a local machine
Click the Add Package link on the Python Packages toolbar and select From Disk .
Specify a path to the package directory or an archive ( zip or whl ).
Manage packages in the Python interpreter settings
To manage Python packages for the Python interpreter, select the Python Interpreter page in the project Settings or select Interpreter Settings in the Python Interpreter selector on the Status bar .
If you select a Python interpreter with the configured Conda environment, the Use Conda Package Manager toggle appears in the packages area toolbar.
Use this toggle to install and upgrade packages from Conda package repositories. This toggle is enabled by default for Conda environments.
Install a package
Click the button on the package toolbar.
In the Available Packages dialog that opens, preview the list of the available packages and type the name of the package to install in the Search field.
If required, select the following checkboxes:
Specify version : if this checkbox is selected, you can select the desired version from the list of available versions. By default, the latest version is taken.
Options : If this checkbox is selected, you can type the pip install command-line options in the text field.
Install to user’s site packages directory <path> : If this checkbox is left cleared (by default), then the packages will be installed into the current interpreter package directory. If the checkbox is selected, the packages will be installed into the specified directory. This option is not available for Conda environments.
Select the target package and click Install Package .
If you’ve got any or error messages, consult the Troubleshooting guide for a solution.
Uninstall a package
In the list of the packages, select the packages to be removed.
Click Uninstall (). The selected packages are removed from the interpreter.
PyCharm smartly tracks the status of packages and recognizes outdated versions by showing the currently installed package version (column Version ), and the latest available version (column Latest version ). When a newer version of a package is detected, PyCharm marks it with the arrow sign and suggests to upgrade it.
By default, the Latest version column shows only stable versions of the packages. If you want to extend the scope of the latest available versions to any pre-release versions (such as beta or release candidate ), click Show early releases .
Upgrade a package
In the list of the packages, select the package to be upgraded.
Click Upgrade ( ).
The selected packages are upgraded to the latest available versions.
Click OK to complete upgrading.
You can upgrade several packages at once. Hold Cmd (macOS) or Ctrl on (Unix or Windows), left-click to select several items in the list of packages, and then click Upgrade .
If you’re accustomed to installing packages from the command line, you can proceed with your workflow using the Terminal.
Reuse installed packages
Create a new virtual environment and install packages that you want to be used in other projects. Then you can specify this virtual environment as a Python interpreter for the target project and all the needed packages will be available.
PyCharm
PyCharm is an integrated development environment for the Python programming language. It provides code analysis tools, a graphical debugger, a tool for running unit tests and supports Django web development.
PyCharm is developed by JetBrains based on IntelliJ IDEA.
PyCharm is a cross-platform development environment that is compatible with Windows , macOS, and Linux . PyCharm Community Edition (free version) is under Apache License, and PyCharm Professional Edition (paid version) is proprietary software.
Установка в Linux
Скачать с официального сайта jetbrains
Либо с помощью wget
sudo tar -xzf jetbrains-toolbox-1.20.7940.tar.gz -C /opt
cd /opt/jetbrains-toolbox-1.20.7940/
./jetbrains-toolbox
Запустите JetBrains Toolbox
Примите JETBRAINS USER AGREEMENT
Выберите PyCharm Community или PyCharm Professional
Установить модуль в PyCharm
Рассмотрим как устанавливать дополнительные модули и библиотеки в PyCharm на примере requests
Перейдите в настройки проекта нажав
CTRL + ALT + S
Найдите раздел Project: название вашего проекта
Выберите подраздел Project Interpreter или Python Interpreter
Нажмите на плюс в правой части экрана
Должно появиться окно Available Packages
Введите в стоку поиска название нужного модуля. В моём случае это requests
Введите в поиске requests
Нажмите кнопку Install Package
Дождитесь окончания установки
Дождитесь окончания установки
Pycharm: поставить курсор в начало нескольких строк подряд
Если нужно добавить или удалить что-то из нескольких срок, которые идут подряд
Поставьте курсор в нужное место самой верхней строки
Нажмите CTRL затем ещё раз CTRL и не отпускайте его. Нажмите стрелку вниз нужное количество раз.
Вертикальная линия ограничитель длины строки
Вертикальная линия после определённого числа символов помогает понять, что строка стала слишком длинной.
Что считать слишком длинной а что нет — решается обычно на проекте.
PEP 8 ограничивает длину 79 символами.
Limit all lines to a maximum of 79 characters.
For flowing long blocks of text with fewer structural restrictions (docstrings or comments), the line length should be limited to 72 characters.
Документация к Django рекомендует длину строки до 119 символов. Это связано с ограничением в GitHub
An exception to PEP 8 is our rules on line lengths. Don’t limit lines of code to 79 characters if it means the code looks significantly uglier or is harder to read.
We allow up to 119 characters as this is the width of GitHub code review; anything longer requires horizontal scrolling which makes review more difficult.
This check is included when you run flake8. Documentation, comments, and docstrings should be wrapped at 79 characters, even though PEP 8 suggests 72.
Популярный Python линтер Black ограничивает длину 88 символами.
Установить положение вертикальной линии в PyCharm можно в
File → Settings → Editor → Code Style → Hard wrap at
Разделить окно на две части
Разделить окно на две части можно разными способами
Половина слева, половина справа: выберите нужную вкладку → сделайте правый клик → Split Right
Половина снизу, половина сверху: выберите нужную вкладку → сделайте правый клик → Split Down
Если так поступить, вкладка раздвоится — один и тот же файл будет виден как в старой вкладке, так и в новой (справа или снизу)
To просто перенести вкладку на новую половину экрана выберите Split and Move Right или Split and Move Down
Переключение из терминала
To быстро переключаться между терминалом и редактором кода можно воспользоваться следующим способом
Терминал будет скрыт если активен и появится если скрыт. Курсор автоматически переходит туда-сюда.
Убрать зеленый фон у кода в PyCharm
Если в код вставлен фрагмент на другом языке, PyCharm может подсветить его зелёным.
How do I use installed packages in PyCharm?
fails as an undefined reference. However, it works fine in the Python interpreter from the command line.
GNURadio works fine with python outside of Pycharm. Everything is installed and configured how I want it.
Gnuradio is located at /usr/local/lib/python2.7/site-packages/gnuradio
14 Answers 14
Adding a Path
Go into File → Settings → Project Settings → Project Interpreter.
Then press configure interpreter, and navigate to the «Paths» tab.
Press the + button in the Paths area. You can put the path to the module you’d like it to recognize.
But I don’t know the path..
Open the python interpreter where you can import the module.
Most commonly you’ll have a folder structure like this:
You want to add foobarbaz to the path here.
You should never need to modify the path directly, either through environment variables or sys.path . Whether you use the os (ex. apt-get ), or pip in a virtualenv, packages will be installed to a location already on the path.
In your example, GNU Radio is installed to the system Python 2’s standard site-packages location, which is already in the path. Pointing PyCharm at the correct interpreter is enough; if it isn’t there is something else wrong that isn’t apparent. It may be that /usr/bin/python does not point to the same interpreter that GNU Radio was installed in; try pointing specifically at the python2.7 binary. Or, PyCharm used to be somewhat bad at detecting packages; File > Invalidate Caches > Invalidate and Restart would tell it to rescan.
This answer will cover how you should set up a project environment, install packages in different scenarios, and configure PyCharm. I refer multiple times to the Python Packaging User Guide, written by the same group that maintains the official Python packaging tools.
The correct way to develop a Python application is with a virtualenv. Packages and version are installed without affecting the system or other projects. PyCharm has a built-in interface to create a virtualenv and install packages. Or you can create it from the command line and then point PyCharm at it.
In your PyCharm project, go to File > Settings > Project > Project Interpreter . If you used virtualenvwrapper or PyCharm to create the env, then it should show up in the menu. If not, click the gear, choose Add Local , and locate the Python binary in the env. PyCharm will display all the packages in the selected env.
In some cases, such as with GNU Radio, there is no package to install with pip , the package was installed system-wide when you install the rest of GNU Radio (ex. apt-get install gnuradio ). In this case, you should still use a virtualenv, but you’ll need to make it aware of this system package.
Unfortunately it looks a little messy, because all system packages will now appear in your env, but they are just links, you can still safely install or upgrade packages without affecting the system.
Подготовка рабочего места в Windows и Linux. Virtual Environment (venv). Ответы на вопросы
Весь текст ниже появился как попытка дать универсальный ответ на те вопросы, которые дорогие читатели присылали и продолжают присылать раз за разом. Здесь не будет кода, связанного с ботами напрямую, а лишь советы по организации процесса написания. И, конечно же, не нужно воспринимать это как истину в последней инстанции, напротив, выбирайте те инструменты и подходы к разработке, которые лично вам кажутся удобными. Важная деталь: текст написан в конце 2019 года. Достаточно вступительных слов, поехали!
Предположим, вы уже немного знаете язык Python 3 (забудьте про Python 2.7, он мёртв), умеете писать простенькие программы и хотите взяться за разработку ботов. Где это делать? В чём писать код? Как правило, у большинства начинающих программистов основной операционкой используется Microsoft Windows. С неё и начнём, но сперва…
Virtual environment
Вы когда-нибудь пользовались VirtualBox? Например, чтобы «пощупать» другие операционные системы или просто установить какой-нибудь подозрительный софт. Python Virtual environment (далее — venv) чем-то напоминает «виртуалку». При его использовании создаётся копия выбранного интерпретатора Питон, а все устанавливаемые модули хранятся изолированно от общесистемных, тем самым, упрощается их обновление, удаление или изменение. Часто venv позволяет избежать ошибок, связанных с обратной совместимостью некоторых библиотек, а также обойтись без конфликтов с системными модулями. Работа с venv будет подробнее описана ниже в разделе Linux, но использовать его мы будем везде.
Windows
Первым делом, разумеется, нужно скачать сам интерпретатор Python. На момент написания этого текста актуальной версией является Python 3.8.1. В качестве каталога установки я рекомендую использовать что-то простое, вроде C:\Python38. Где писать код — личное дело каждого, конечно, но я всё же рекомендую использовать специальную среду разработки под названием PyCharm Community Edition. Бесплатной версии (та самая Community) более чем достаточно. После установки и первичной настройки выберите пункт File -> New Project. Укажите имя вашего первого проекта, а ниже укажите «New environment using virtualenv», ниже в качестве интерпретатора путь к python.exe каталога с Питоном (например, C:\Python38\python.exe).
Создание нового проекта в PyCharm
После запуска откройте вкладку Terminal в левом нижнем углу и установите библиотеку pytelegrambotapi (не telebot!). Для любителей тыкать мышкой есть более запутанный вариант: File -> Settings -> Project <имя проекта>-> Project Interpreter -> кнопка «+» в правой части экрана.
Установка библиотеки через терминал в PyCharm
Прекрасно, теперь начинайте творить! Создайте первый файл с исходником, нажав правой кнопкой мышки по имени проекта в списке файлов, затем New и Python File.
Создание нового файла кода в PyCharm
Запустить код можно, выбрав сверху пункт Run, затем снова Run…, но с многоточием, и затем выбрав созданный ранее файл.
Как залить файлы на сервер?
Для копирования файлов на удалённый сервер (обычно там стоит Linux), я использую замечательную бесплатную программу WinSCP, причём в ней присутствует режим автоматической синхронизации файлов, чтобы при любом изменении в локальном каталоге обновлялось содержимое на удалённой машине, избавляя вас от необходимости копировать всё вручную.
Скриншот программы WinSCP
При помощи WinSCP можно даже просто подключиться к серверу и подправить файл «на лету», не забудьте только потом перезапустить бота!
Linux
Если Linux у вас используется вместо Windows, то работа с PyCharm будет точно такой же, поэтому второй раз писать не имеет смысла. Далее рассмотрен процесс запуска в терминале на удалённом сервере. Прекрасно, вы написали бота и хотите где-то его запустить. Например, арендовали сервер у Scaleway/DigitalOcean/AWS/etc. Запустили сервер, подключились к нему по SSH, а там чёрный экран и терминальная Linux-сессия. Во-первых, давайте посмотрим, какой интерпретатор у нас выбран по умолчанию, введя команду python3 .
Хорошим правилом будет иметь на сервере ровно ту же версию Python, что и на своей локальной машине, во избежание различных неприятностей. Если версия на сервере ниже 3.7 и/или ниже той, что установлена локально, лучше всего будет установить её отдельно. Очень рекомендую вот эту статью, по которой я для себя написал простой скрипт для автоматизации рутинных действий. Итак, интерпретатор установлен, теперь пора создать каталог, куда положим файлы бота. Выполните по очереди следующие команды:
В результате должно получиться примерно то же самое, что на скриншоте ниже, с той лишь разницей, что я прервал процесс установки библиотеки для читабельности. Обратите внимание, что после подгрузки файла venv/bin/activate, перед названием пользователя и текущего каталога появится приписка (venv), означающая, что мы «вошли» в виртуальное окружение и устанавливаем библиотеки именно в него.
Создание venv в Linux-терминале
Что произошло выше? Во-первых, мы создали каталог с названием mybot и перешли в него. Во-вторых, мы использовали Python версии 3.7 (в вашем случае это может быть не так), чтобы создать виртуальное окружение в подкаталоге venv. В-третьих, мы «активировали» venv и выполнили в нём нужную нам команду. Внутри venv команды pip и python точно знают, к какому именно интерпретатору они относятся, поэтому путаницы вроде «я установил библиотеку для Python 3.5, а запускаю из-под Python 3.7» попросту не будет. Наконец, в-четвёртых, мы деактивировали venv, поскольку он напрямую нам больше не нужен. Чтобы сделать жизнь ещё приятнее, давайте настроим автозагрузку бота, чтобы при возникновении ошибок или при перезапуске сервера он вновь запускался, избавляя нас от необходимости постоянно проверять всё вручную. Для этого мы воспользуемся подсистемой инициализации systemd, которая всё больше распространена в современных Linux-дистрибутивах. Прежде, чем описать службу systemd, откройте главный файл с ботом, в котором прописан его запуск и добавьте в качестве первой строки следующий код: #!venv/bin/python
Сохраните файл, закройте его и выполните команду chmod +x имяфайласботом.py , чтобы сделать его исполняемым. Теперь создайте файл mybot.service, и скопируйте туда следующий текст:
Отредактируйте поля Description , WorkingDirectory и ExecStart , сохраните и закройте файл. Далее скопируйте его в каталог /etc/systemd/system , введя свой пароль при необходимости (если сидите не из-под рута, что правильно, то ваш юзер должен иметь возможность выполнять команды от имени sudo). Затем выполните следующие команды для включения автозагрузки и запуска бота (опять-таки, требуются права суперпользователя):
Наконец, проверьте состояние вашего бота командой systemctl status mybot . Его статус должен быть Active (running) зелёного цвета (если поддерживается разноцветный режим).
Проверка статуса бота через systemd
Как редактировать файлы на сервере?
Если что-то нужно подправить небольшое, то неплохим вариантом остаётся старое доброе подключение по SSH и использование редакторов вроде micro, nano или даже vim с emacs. Но если вдруг у вас в качестве локальной машины применяется Linux, то крайне рекомендую редактор Visual Studio Code (https://code.visualstudio.com) с дополнением Remote-SSH. В этом случае, вы сможете прямо в VS Code открывать каталоги на сервере и редактировать файлы в удобном окружении и с подсветкой синтаксиса. К сожалению, насколько мне известно, расширение Remote-SSH не работает в Windows, но впоследствии этот недочёт будет устранён.
Ответы на часто задаваемые вопросы (FAQ)
Хочу научиться писать ботов. С чего мне начать?
Прежде всего, пожалуйста, изучите хотя бы немного сам язык Python. Он довольно простой, но перед созданием ботов стоит понять азы. Конкретнее: переменные, циклы, функции, классы, обработка исключений, работа с файлами и файловой системой.
Можно ли писать ботов на телефоне?
Да кто ж вам запретит-то? Но лучше от этого никому не будет, поверьте. Будет трудно, неудобно и контрпродуктивно. Используйте нормальный компьютер.
[pyTelegramBotAPI] Ошибка AttributeError: module ‘telebot’ has no attribute ‘TeleBot’!
На 99% уверен, что вы установили библиотеку telebot вместо pytelegrambotapi. С учётом всего вышесказанного проще создать новое окружение venv, перенести туда нужные файлы и установить именно pytelegrambotapi, при этом в исходниках должно остаться import telebot.
Как мне держать бота запущеным в Windows?
Запустите бота в PyCharm, не закрывайте приложение и не выключайте комп. Почти шутка. По-моему, Windows — не самая лучшая операционка для подобных вещей, проще арендовать сервер у европейских провайдеров, заодно не будет геморроя с варварами из Российского Консорциума Неадекватов.
Библиотека pyTelegramBotAPI не поддерживает новые фичи Bot API!
К сожалению, упомянутая библиотека в 2019 году развивалась гораздо медленнее, чем хотелось. Если вы уже чувствуете себя уверенным ботописателем, подумайте о переходе на альтернативы вроде aiogram.
В завершение хочется напомнить, что если у вас возникли замечания, предложения или вопросы, вы всегда можете открыть issue на Github или прийти к нам в чатик.