Size: a a a

2021 April 17

c

codingteam@cjr in codingteam
Minoru
а ты плагины никакие не ставила? Тут вот в баг-трекере JetBrains пишут про какой-то плагин для маркдауна, например
источник

C

Claudia in codingteam
из учебных целей пыталась все функции pyCharm использовать. да, маркдаун установила. попробую удалить
источник

C

Claudia in codingteam
Спасибо! помогло выключение плагина и перезагрузка.
источник

C

Claudia in codingteam
источник

c

codingteam@cjr in codingteam
Minoru
https://gitlab.com/getnumers/getnumbers/-/blob/b03f963a841c9d44a9aac4e96fecf67f4759ba2b/FileEngine.py#L2 По-моему, доки для класса пишутся перед классом, а не внутри него (но я давно не писал на Python и могу ошибаться)
источник

c

codingteam@cjr in codingteam
Minoru
https://gitlab.com/getnumers/getnumbers/-/blob/b03f963a841c9d44a9aac4e96fecf67f4759ba2b/FileEngine.py#L14 Ну, строго говоря, метод ничего не возвращает, он просто меняет поле __necessary_file
источник

c

codingteam@cjr in codingteam
Minoru
не знаю, к чему ещё придраться. Как по мне, для обычной задачки этот код уже вылизан. Если бы это был продакшен, то там наверняка были бы вопросы, например: что будет, если воспользоваться этим классом, удалить все файлы и воспользоваться классом ещё раз? Он вернёт предыдущий выбранный файл, это наверняка баг
источник

C

Claudia in codingteam
после передачи имени файла надо удалять объект?
источник

c

codingteam@cjr in codingteam
Minoru
ну, если вызывающая сторона так делает, то проблемы нет
источник

c

codingteam@cjr in codingteam
Minoru
но ты не можешь заставить вызывающую сторону так делать :)
источник

c

codingteam@cjr in codingteam
Minoru
я бы просто вот здесь делал __necessary_file = "": https://gitlab.com/getnumers/getnumbers/-/blob/b03f963a841c9d44a9aac4e96fecf67f4759ba2b/FileEngine.py#L27
источник

c

codingteam@cjr in codingteam
Minoru
ещё я тут полистал PEP8 — питоновский code style — и в нём пишут, что все документированные штуки следует считать публичным интерфейсом, а недокументированные — приватным. А у тебя выходит наоборот: все приватные методы документированы, а единственный публичный — нет
источник

c

codingteam@cjr in codingteam
источник

c

codingteam@cjr in codingteam
Minoru
вообще в док-комментарии класса можно было бы показать, как им пользоваться. Ну, типа, создала, вызвала метод __search_file, получила результат через get_file
источник

c

codingteam@cjr in codingteam
Minoru
т.е. пишешь исходя из предположения, что пользователь твоего класса не будет читать код, а попытается всё понять по документации
источник
2021 April 18

Dv

Dr. Friedrich von Ne... in codingteam
Кажется, Мантикор так делал, как на этой картинке?
источник

Dv

Dr. Friedrich von Ne... in codingteam
Я на днях ревьюил патч на +20к -17к. Да, тяжело, но, если ориентируешься в коде, то жить можно.
источник

Dv

Dr. Friedrich von Ne... in codingteam
Это процесс рендера от Chromium Embedded Framework, ну то есть от браузерного движка.

Чтобы он не появлялся, не нужно открывать браузерные контролы в IDE. Возможно, есть какая-то опция в Registry, чтобы он совсем не появлялся, но я сходу не помню.
источник

Dv

Dr. Friedrich von Ne... in codingteam
Ну и, да, Markdown plugin — это самый очевидный пользователь этого механизма (там браузер для превью используется, потому что HTML-сниппеты часто используют в таких документах). Но относительно к Питону браузер может использоваться ещё во всяких iPython.
источник

Dv

Dr. Friedrich von Ne... in codingteam
Ты ошибся. Докстринги там действительно пишут первым выражением внутри функций и классов. Тут написано правильно.
источник