服了setuptools的文档了

水木社区手机版

主题:服了setuptools的文档了
4楼|lhawk|2022-04-27 13:01:58|展开
python的文档严谨程度差Java十条街，估计就是毛子猛糙快的风格
刚学python想搞清楚file object到底有哪几个方案，愣是没找到，很多地方说file object，
如此基础的知识就没有一篇文档给你讲清楚file object到底有哪几个API，只能看代码。

【在 pcal 的大作中提到: 】
: 想在build_ext 命令中加点自定义的操作，看了官方文档还是一头雾水。那个文档真是乱七八糟
--
FROM 123.124.235.*
9楼|lhawk|2022-04-28 08:42:23|展开
查个文档还需要命令行，还需要先知道这个语法，要不然就没法查文档？
而且你这个代码一上来就报错，况且就算按照你说的执行了，出来的也不一定是所谓的file object的文档啊

Help on TextIOWrapper object:

class TextIOWrapper(_TextIOBase)
......

到底file object是个什么鬼，有地方写清楚了吗？
查文档除了一开始不会需要看帮助，还有一种情况是明确知道contract，现在连一个明确的说明都没有，想做一个duck type支持file object到底要支持哪些方法才能用？不知道不明确？
和中医一个套路，副作用不明确？
geek自己玩没问题，工程上这种搞法，且不说GIL执行效率，这种到处稀里糊涂缺乏contract的思维，只能到处埋坑，前任挖坑坑后人呗。

【在 lvsoft 的大作中提到: 】
: 启动ipython
: f=open('foo')
: help(f)
: ...................
--
FROM 123.124.235.*
10楼|lhawk|2022-04-28 08:44:28|展开
我都有点怀疑python是故意把文档做差一点，这样搜索量上去了好冲TIOBE榜单

【在 hongyan2022 的大作中提到: 】
: 文档经常大而全，写的工整
: 我个人没耐心看
: 全是搜 ... 例子
: ...................
--
FROM 123.124.235.*
12楼|lhawk|2022-04-28 08:57:37|展开
所以说是“猛糙快”
没有贬低的意思
现在公司不都是要快点上线快点圈钱嘛

【在 hongyan2022 的大作中提到: 】
: 象 dataframe 那样的文档，感觉太学究气了
: 而且还很长很长
: 说的都对，但是，急着用的时候，谁有精力看几个小时的文档
: ...................
--
FROM 123.124.235.*
15楼|lhawk|2022-04-28 09:56:18|展开
谢谢啊，我也不是说找不到这个文档，只是说从文档的严谨程度来说，是很难理解
比如在别的地方叫做file object，到了这边是IO类型，到底IO类型是不是file object
是要靠猜的，这种表述风格我认为是不严谨的

【在 freesand 的大作中提到: 】
: 文件对象的官方文档是这个 https://docs.python.org/zh-cn/3/library/io.html
--
FROM 123.124.235.*
20楼|lhawk|2022-04-28 13:37:08|展开
谢谢啊，我不是说完全无法找到，只是觉得这个文档写的不够严谨吐槽而已

【在 adoal 的大作中提到: 】
: 你是想要这个吗 https://docs.python.org/3/library/io.html#module-io
:
--
FROM 123.124.235.*