Форум программистов, компьютерный форум, киберфорум
Python: IDE, инструментарий
Войти
Регистрация
Восстановить пароль
Блоги Сообщество Поиск Заказать работу  
 
Рейтинг 4.83/6: Рейтинг темы: голосов - 6, средняя оценка - 4.83
 Аватар для Gepar
1186 / 543 / 78
Регистрация: 01.07.2009
Сообщений: 3,517

Pycharm: подсунуть кастомную документацию

14.06.2016, 22:40. Показов 1336. Ответов 8
Метки нет (Все метки)

Студворк — интернет-сервис помощи студентам
Есть ли возможность подсунуть Pycharm какую-то кастомную документацию?
Жутко раздражает что при работе с библиотеками реализованными не на питоне я не могу использовать банальный список методов. Как пример - cx_Oracle. Я хотел бы один раз указать что cx_Oracle.connection() возвращает объект Connection с конкретным списком методов, а тот же метод Connection.cursor() возвращает объект Cursor со следующим списком методов и чтобы pycharm использовал эти подсказки для него каждый раз когда я импортирую cx_Oracle. Сейчас же после перехода с IDEA на PyCharm я в большинстве случаев не вижу разницы между PyCharm и sublime по удобству написания кода: что первое что второе подсказывает список ранее использованных слов и на этом всё.
0
IT_Exp
Эксперт
34794 / 4073 / 2104
Регистрация: 17.06.2006
Сообщений: 32,602
Блог
14.06.2016, 22:40
Ответы с готовыми решениями:

PyCharm ссылку на Python документацию
Не могу найти где указать в PyCharm ссылку на Python документацию. Давлю Ctrl+Q - документация считывается с HDD. Долее, стрелку вверх, ...

Как сделать кастомную анимацию?
Как сделать кастомную анимацию?

Как подсунуть правильное описание?
оригинально и как же тогда поисковые псы будут индексировать сайт, тем более новый? одной картой сайта и сайтмэп? По мне, меню одно из...

8
2742 / 2341 / 620
Регистрация: 19.03.2012
Сообщений: 8,830
14.06.2016, 23:31
Можно, с помощью аннотаций типов.
Посмотри вот это выступление выступление одного из разрабов pycharm на прошлом pycon https://www.youtube.com/watch?v=2ECv7CGpWIk об этом речь заходила.
2
 Аватар для Zuzik
298 / 256 / 57
Регистрация: 11.06.2012
Сообщений: 1,557
15.06.2016, 10:11
не совсем по теме - аннотиции типов только с 3.5 или в 3.4 тоже есть?
0
2742 / 2341 / 620
Регистрация: 19.03.2012
Сообщений: 8,830
15.06.2016, 12:57
Zuzik, вроде как и ещё раньше появились, встречал упоминания о них ещё в книге Изучаем python Лутца (4 издания).
Вообще посмотри видео, там рассказывается как решается затронутая тут проблема в pycharm и вообще в python (я был на конфе год назад, уже все в общих чертах помню, да и лучше чем Андрей Власовский я не расскажу).
0
 Аватар для Gepar
1186 / 543 / 78
Регистрация: 01.07.2009
Сообщений: 3,517
15.06.2016, 22:33  [ТС]
alex925, я знаю о аннотациях для pycharm, мой вопрос состоит в том как ему подсказать это всё не имея возможности изменять исходники.
Вот пример того что pycharm получает своей генрилкой:
Python
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# encoding: utf-8
# module cx_Oracle
# from C:\Program Files\Python\Python2711\lib\site-packages\cx_Oracle.pyd
# by generator 1.138
# no doc
 
 
from object import object
 
class Connection(object):
    # no doc
    def begin(self, *args, **kwargs): # real signature unknown
        pass
 
    def cancel(self, *args, **kwargs): # real signature unknown
        pass
 
    def changepassword(self, *args, **kwargs): # real signature unknown
        pass
 
    def close(self, *args, **kwargs): # real signature unknown
        pass
 
    def commit(self, *args, **kwargs): # real signature unknown
        pass
 
    def cursor(self, *args, **kwargs): # real signature unknown
        pass
 
    def ping(self, *args, **kwargs): # real signature unknown
        pass
 
    def prepare(self, *args, **kwargs): # real signature unknown
        pass
 
    def register(self, *args, **kwargs): # real signature unknown
        pass
Я же хочу ему указать что-то типа этого:
Python
1
2
3
4
5
6
7
class Connection(object):
    """
    :rtype: cx_oracle.Cursor
    как видите я также изменил описание: больше нет никаких args / kwargs так как я точно знаю что функция не принимает аргументы
    """
    def cursor(self):
        pass
и при этом не похерить всю реализацию поэтому я не могу изменять оригинальные файлы с исходниками, мне определённо нужно как-то при помощи внешних файлов ему это всё подсказать.
Пролистав видео я не заметил чтобы обсуждалось что-то подобное или там именно то что мне нужно и стоит смотреть видео целиком?
0
2742 / 2341 / 620
Регистрация: 19.03.2012
Сообщений: 8,830
15.06.2016, 22:43
del
0
 Аватар для Gepar
1186 / 543 / 78
Регистрация: 01.07.2009
Сообщений: 3,517
15.06.2016, 22:52  [ТС]
В теории я конечно могу запариться и написать небольшую обёртку возле реального cx_Oracle (классов и методов там не так и много) которая только и будет перенаправлять все обращения на реализацию из cx_Oracle, но это уже не документация, а какой-то костыль получается. Хотелось бы как-то по-человечески что ли да и проблема то не только с cx_Oracle.
0
 Аватар для Zuzik
298 / 256 / 57
Регистрация: 11.06.2012
Сообщений: 1,557
16.06.2016, 09:36
Без костылей не получится( Таковы особенности питона.
Пичарм документацию подтягивает после следующих строчек
Python
1
assert isinstance(то_для_чего_нужна_документация, тип_данных_для_которого_она_нужна)
Это еще больший костыль, но при желании данный процесс можно автоматизировать.
0
2742 / 2341 / 620
Регистрация: 19.03.2012
Сообщений: 8,830
16.06.2016, 10:37
Цитата Сообщение от Zuzik Посмотреть сообщение
Таковы особенности питона.
Не, это особенности сишной библиотеки.
0
Надоела реклама? Зарегистрируйтесь и она исчезнет полностью.
BasicMan
Эксперт
29316 / 5623 / 2384
Регистрация: 17.02.2009
Сообщений: 30,364
Блог
16.06.2016, 10:37
Помогаю со студенческими работами здесь

Как выполнять кастомную отправку POST
Здравствуйте, пишу плагин авторизации пользователей сайта для вордпресса. Прочитал, что любые пост запросы обрабатываются admin-post.php. ...

Подсунуть драйвера в Windows XP на новом HDD
На компьютере полетел жесткий диск. Но имеется другой с установленной системой (и с блекджеком)) При подключении этого другого...

Как подсунуть униканьную статью яше?
Понятно что защититься от копирования статей невозможно, но вот первым показать их яше вроде можно - чтоб знал кто первоисточник... Читал...

Подсунуть чужому приложению свою dll
Цель всего этого — внедрить свой код в чужую программу (Quik.exe) с целью импорта и дальнейшей обработки данных. В программе присутствует...

Метод не принимает кастомную форму в качестве параметра
Здравствуйте! Использую Delphi 6. Создаю свой класс, наследник TForm type TWorkForm = class(TForm) private ...


Искать еще темы с ответами

Или воспользуйтесь поиском по форуму:
9
Ответ Создать тему
Новые блоги и статьи
Музыка, написанная Искусственным Интеллектом
volvo 04.12.2025
Всем привет. Некоторое время назад меня заинтересовало, что уже умеет ИИ в плане написания музыки для песен, и, собственно, исполнения этих самых песен. Стихов у нас много, уже вышли 4 книги, еще 3. . .
От async/await к виртуальным потокам в Python
IndentationError 23.11.2025
Армин Ронахер поставил под сомнение async/ await. Создатель Flask заявляет: цветные функции - провал, виртуальные потоки - решение. Не threading-динозавры, а новое поколение лёгких потоков. Откат?. . .
Поиск "дружественных имён" СОМ портов
Argus19 22.11.2025
Поиск "дружественных имён" СОМ портов На странице: https:/ / norseev. ru/ 2018/ 01/ 04/ comportlist_windows/ нашёл схожую тему. Там приведён код на С++, который показывает только имена СОМ портов, типа,. . .
Сколько Государство потратило денег на меня, обеспечивая инсулином.
Programma_Boinc 20.11.2025
Сколько Государство потратило денег на меня, обеспечивая инсулином. Вот решила сделать интересный приблизительный подсчет, сколько государство потратило на меня денег на покупку инсулинов. . . .
Ломающие изменения в C#.NStar Alpha
Etyuhibosecyu 20.11.2025
Уже можно не только тестировать, но и пользоваться C#. NStar - писать оконные приложения, содержащие надписи, кнопки, текстовые поля и даже изображения, например, моя игра "Три в ряд" написана на этом. . .
Мысли в слух
kumehtar 18.11.2025
Кстати, совсем недавно имел разговор на тему медитаций с людьми. И обнаружил, что они вообще не понимают что такое медитация и зачем она нужна. Самые базовые вещи. Для них это - когда просто люди. . .
Создание Single Page Application на фреймах
krapotkin 16.11.2025
Статья исключительно для начинающих. Подходы оригинальностью не блещут. В век Веб все очень привыкли к дизайну Single-Page-Application . Быстренько разберем подход "на фреймах". Мы делаем одну. . .
Фото: Daniel Greenwood
kumehtar 13.11.2025
Расскажи мне о Мире, бродяга
kumehtar 12.11.2025
— Расскажи мне о Мире, бродяга, Ты же видел моря и метели. Как сменялись короны и стяги, Как эпохи стрелою летели. - Этот мир — это крылья и горы, Снег и пламя, любовь и тревоги, И бескрайние. . .
PowerShell Snippets
iNNOKENTIY21 11.11.2025
Модуль PowerShell 5. 1+ : Snippets. psm1 У меня модуль расположен в пользовательской папке модулей, по умолчанию: \Documents\WindowsPowerShell\Modules\Snippets\ А в самом низу файла-профиля. . .
КиберФорум - форум программистов, компьютерный форум, программирование
Powered by vBulletin
Copyright ©2000 - 2025, CyberForum.ru