pycharm-howto
- 在 pycharm 中的 opencv 智能提示
- console output colorful log
- doc stub on class
- pycharm vs vscode
- create pycharm shortcut
- How to sort parameters of a function call
FIXED: pycharm 中创建 test 测例，但默认 target_directory 定位异常
pycharm 中创建 test 的 target_directory 的默认规则如下：
- 当前工程（或文件夹？具体我也不清楚）下若有 tests 文件夹，则创建于此
- 若没有，则创建于当前文件夹下
但我们的 target_directory 却出现了异常，总是跑到venv/lib/python3.9/site_packages/numpy下面的某个 tests 模块下，除非把 numpy 卸载了才行。
我已经尝试过的办法：
- 更换不同的 venv 目录
- 重装 venv
- 修改 interpreter path（加入本工程 path）
- 重装 numpy、opencv
- 删除.idea、pycache文件夹
- ...
均不行，最后还是通过重建了工程，然后把原工程文件全复制过来才解决问题。
我猜应该是原工程的数据库配置文件出问题了？咱也不清楚，也许是那个文件夹的风水不好……
最后，我把那个文件夹拆分了，都换到了新的地方，然后把它删了~
在 pycharm 中的 opencv 智能提示
最终解决方案
将cv2的路径加入环境路径
研究概要
- 来自 youtrack 的相关问题，但都没有解决我的问题
- Code completion doesn't work for attributes of cv2 module of opencv-python : PY-23426
- Code completion doesn't work for cv2 module : PY-35691
- 基于 anaconda 的解决方案，接下来我们确实可以基于 anaconda 做 opencv 的分析，但当时在研究 pycharm，所以不予考虑
- 基于国人在 cv 程序里加入路径的方法，终于得到解药
研究细节
果然还是中国人才能救中国人！
pycharm 无法自动补全 opencv 已经困扰我一两周了，谷歌所有帖子俺都看了，都不得行！
后来想想，国内肯定也有这样的问题，不然那些学校里的老师和学生都不用 opencv 或者以一种常人无法忍受的姿势使用 opencv 吗？
然后百度一番 就找到解决方案了：
不过尽管问题从标上解决了，本的问题还是没理解，pycharm 理论上应该是可以自动加载的，毕竟 opencv 可不是什么野鸡包，但实在没有精力再去刨根问底了……
怎么会，继续干！
进一步研究会发现，那个 csdn 的小伙子其实改法有点多余，cv2 里面其实已经有那句导入了，所以实际上真正要改的就是把路径加到前面去，因此只要加一句就可以了，而非两句：
然后再去思考，这句话的意思其实就是把本文件所在的文件夹加到系统的环境变量里去。
因此，这就很简单了，这句代码也不用加，直接在 ide 里把环境变量配置一下：
实测可行！
所以目前得到的结论就是，当我们使用 pycharm 创建一个工程时，会自动把当前环境的 site_packages 写入 path。
理论上会遍历这个 site_package 里的包，但是对 opencv 无效，opencv 是基于 so 文件进行动态链接的。
这就导致 ide 正常撸代码时没有 opencv 的提示，但是运行时会动态加载因此不会出错；另外，如果我们使用 python console，这玩意也会执行解释器，因此 cv 在里面也会智能提示。
那么我们的问题就彻彻底底退化成了，opencv 为啥要手动配置到环境变量里去，是版本问题还是设计问题？
接着，顺着 OpenCV 的那个init.py 文件进一步跳转到底层，发现了惊人的一幕：我们的缓存文件里的init文件，竟然是一个有问题的文件！
这个问题似乎指向了在 stackoverflow 里有些人重装 python 或者重装 pycharm 可行的问题的解，因为他们的缓存文件跟我一样出现了严重的问题。
因此我们考虑把这个缓存文件夹给完全删除，然后重启 ide 试试。
但是很遗憾的是，再次重启后，仍旧是那样。
但是神奇的是，此时我已经把 cv2 库从我们的环境变量中移除了，然而 IDE 依旧能够智能提示。
这又解释了为啥 stackoverflow 上一些人回复说有些时候有，有些时候又没有。
根据俺们的经验猜测，这是因为 IDE 的.idea 工程配置文件进行了缓存存储记忆，在我们顺利导入某个库之后，之后就都能导入了。
为了验证这个想法，我们把.idea 全部删掉，然后再次重启，确认接下来是否又将无法正常提示。
果然，它再次无法正常智能提示：
基于此，一个可以接受的方案成型了，那就是每次配置 opencv 的工程时，额外把 cv 的路径加入到解释器的环境变量内。
这个可以通过 IDE 的 UI 操作完成，也可以比较破坏性地钻入 cv 库的实现里去加。
而 jb 之类的 IDE 在首次加完之后，将会把路径写入.idea，后续可以把环境变量清除而不会影响使用。
至于为啥一定要多此一步，是 opencv 的问题，还是 IDE 的问题，俺决定不再思考了，收~
剩余疑惑
那个缓存文件为啥长那样，是否就是无法正常加载
opencv的原因所在？最终到底是版本问题，还是设计问题，还是自己的操作系统问题？
console output colorful log
- download the plugin of
grep console. - configure the colors for different levels of log
!!!tip I only checked the INFO level and configured its background color to be green.
And now it looks pretty good.
ref
doc stub on class
It's sad that pycharm doesn't support documentation stub on a class.
For example, on a TypedDict.
It only works on functions, parameters and so on.
A property method hack can be seen at: https://stackoverflow.com/a/15537029/9422455
ref:
pycharm vs vscode
when configure test
pycharm is very nice when you want to configure a unit test, just right click the function you want to and the popup would lead you to auto create a test file next to your code.
And this feature, I can't find in VSCode, neither from the extension markets.
create pycharm shortcut
/usr/bin/charm
ref:
How to sort parameters of a function call
This is a very old question that I struggled with for a long time, since I started to learn python, whenever I was using pycharm, anaconda, jupyter, or so on.
Parameter Info
In VScode, the parameter hints can trigger by ⇧ + ⌘ + space default(which conflicts with MacOS's SpotlightSearch) so that I changed it into ⌥ + P as the following shows:
The experience VSCode represents the function parameter info is good and impressive, while in pycharm not.
We can easily found that contrary to the VSCode, pycharm's parameter info lacks of the detail instructions which seems a bit weak and not too nice for those who are newbies or forgot how to use this function.
Parameter Suggestions
In VSCode, the parameter is triggered automatically or by typing ⌃ + Space and sorted by groups (which is the most import), so the user can easily get to know what parameter to choose.
This are quite corresponding to developers' intuition, while in pycharm things again become hard to understand and even unbearable.
Why should the pycharm put those words such as lambda, None, not in the first place? Does my system goes wrong?
However, when I tried to search in the web, I am shocked to find the official jetbrains reply the result is out of intelligence, which seems too absurd and unacceptable since we can then find all the inner parameter are at the last.
ref: