[库推荐] 自荐Python开源的基础库CUP给大家

[Gallon Ma]

CUP基础库是百度开源的Python语言基础库，致力将DEV从涉及底层操作、Util操作类解放出来，使其更关注构建service上层业务逻辑。

目前已涵盖了构建一个服务的各个方面，大家可以从基础库的代码结构、wiki、doc中进行简单了解。

CUP

    |-- cache.py                  module              缓存相关模块 （Memory cache related module）

    |-- decorators.py           module              python修饰符，比如@Singleton单例模式 (Decorators of python)

    |-- err.py                        module              异常exception类, Exception classes for CUP

    |-- __init__.py                module              默认__init__.py, Default __init__.py

    |-- log.py                       module              打印日志类，CUP的打印日志比较简洁、规范，设置统一、简单(cup logging module)

    |-- mail.py                     module              发送邮件 （CUP Email module (send emails)）

    |-- net                           package             网络相关操作（Network operations, such as net handler parameter tuning）

    |-- oper.py                    module              一些混杂操作(Mixin operations)

    |-- platforms.py            module              跨平台、平台相关操作函数(Cross-platform operations)

    |-- res                          package             资源获取、实时用量统计等，所有在/prco可获得的系统资源、进程、设备等信息 （Resource usage queries (in /proc)、Prcoess query、etc）

    |-- shell                       package             命令Shell操作pakcage（Shell Operations、cross-hosts execution）

    |-- services                 package             构建服务支持的类（比如心跳、线程池based执行器等等）Heartbeat、Threadpool based executors、file service、etc

    |-- thirdp                     package             第三方依赖纯Py模块（Third-party modules： pexpect、httplib2）

    |-- timeplus.py           module              时间相关的模块(Time related module)

    |-- unittest.py             module              单元测试支持模块（Unittest、assert、noseClass）

    |-- util                         package             线程池、可打断线程、语义丰富的配置文件支持（ThreadPool、Interruptable-Thread、Rich configuration、etc）

    |-- version.py             module              内部版本文件，CUP Version

如果你觉得CUP很棒，请帮我们start，并推荐给厂内、厂外的 亲朋砖友。更欢迎为CUP撰写patch、新feature，一起添砖加瓦！

Github:  https://github.com/Baidu/CUP

感谢， ---Gallon

[laike9m]

基础库还是要支持一下

--

laike9m.com

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

[Leo Xu]

支持基础库建设

laike9m <lai...@gmail.com>于2018年9月12日周三 下午3:25写道：

[80x24]

2018-09-12 14:51 GMT+08:00 Gallon Ma <myt...@gmail.com>:
> CUP基础库是百度开源的Python语言基础库，致力将DEV从涉及底层操作、Util操作类解放出来，使其更关注构建service上层业务逻辑。
> 目前已涵盖了构建一个服务的各个方面，大家可以从基础库的代码结构、wiki、doc中进行简单了解。

支持一个，基础库文档与示例比较重要，有个user guide之类的似乎会更好？发现文档里基本上是API doc。

[Guannan Ma]

--------有个user guide之类的似乎会更好？--------

恩，wiki上有一部分常见的:

https://github.com/Baidu/CUP/wiki

针对“每个”API或者module的当前确实没有，这块是个TODO。 当前的api-doc是走sphinx生成的，想法是慢慢直接在func/package注释里直接做示例，然后自动生成。

P.S., 以前show me the code理念被灌得猛，完全不想写example.  现在想法不一样了， 哈哈。 

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---

您收到此邮件是因为您订阅了 Google 网上论坛的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要向此群组发帖，请发送电子邮件至 pyth...@googlegroups.com。
要查看更多选项，请访问 https://groups.google.com/d/optout。

[wangchuan2008888]

百度最近几年很爱开源啊😊

发自我的小米手机

在 Guannan Ma <myt...@gmail.com>，2018年9月12日 下午4:42写道：

您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。

[yegle]

看到中文注释…有点辣眼睛…开源前至少得把中文全去掉吧…

--

[Leo Jay]

中文辣眼睛？
是什么导致了您的眼睛看不了中文呢？

[yegle]

写“singleton你的类”这种半通不通的中文另说，用中文做注释有几个问题：

1. 开源的用户可能来自世界各地，写中文影响更广泛adoption

2. PEP8里提到了，Python2源码应该用ascii https://www.python.org/dev/peps/pep-0008/#source-file-encoding

您收到此邮件是因为您订阅了 Google 网上论坛的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。

要向此群组发帖，请发送电子邮件至 pyth...@googlegroups.com。
要查看更多选项，请访问 https://groups.google.com/d/optout。

--

Yuchen Ying
https://about.me/yegle

[yegle]

为什么需要重新发明一个Unittest lib呢？看起来功能和stdlib里功能严重重叠，而且里面的assert_eq/assert_ne和stdlib unittest完全不一样，并且居然直接用 %s 打印对比的对象。

https://github.com/baidu/CUP/blob/master/cup/unittest.py

--

邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

Yuchen Ying
https://about.me/yegle

[yegle]

Python2 only

flag.py 里并不是命令行参数相关代码

timeplus.py 说是时间相关lib，但是里面只有一个time.strftime的wrapper

整体上看虽然说的是基础库，但是更多的只是SA日常处理常用的函数，例如 http://docs.iobusy.com/docs/cup/cup.res.html 获取系统资源， http://docs.iobusy.com/docs/cup/cup.html#module-cup.oper 常见SA操作。

[李者璈]

不针对作者，只是来杠一杠的话

尽可能减少中英混杂，Singleton 又不是没有对应通用的翻译

而且对于中英文混用的时候，有空格是个基本的排版共识

所以的确算是辣眼睛

李者璈 & Zheaoli

Email: lizhea...@gmail.com

Github: https://github.com/Zheaoli

Leo Jay <python...@gmail.com> 于2018年9月13日周四 上午3:23写道：

您收到此邮件是因为您订阅了 Google 网上论坛的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。

[Ngai-Fung Yip]

哈哈，以前我们的注释用的粤语，只是不会开源出来而已。

> 您收到此邮件是因为您订阅了 Google 网上论坛的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
> 要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。

> 要向此群组发帖，请发送电子邮件至 pyth...@googlegroups.com。
> 要查看更多选项，请访问 https://groups.google.com/d/optout。

--


Ngai-Fung Yip(叶毅锋)
yyfeng88625@twitter
DYFeng@github
DYFeng@behance

[YS.Zou]

人家楼主可能只是在这个中文列表前期先说一下而已，挑剔中文注释没意义吧。

别一来就什么全世界的开发者，持续作下去，哪怕只偏安一隅也没什么不好。

虽然就我个人的情况来说，我觉得 Python 各方面电池都挻足的。虽然有些模块起手是麻烦了一点，但是做过一次完整的流程之后，其实也理解现实的情况确实就是比较麻烦的，比如 logging 。

yegle <cny...@gmail.com> 于2018年9月13日周四 上午12:08写道：

--

进出自由才是游戏者的生存之道。

http://www.zouyesheng.com

[Shell Xu]

你是想说“请帮我们star“么？

因为”请帮我们start“差不多就是”来我们team干活吧“的意思。这俩有点区别。

--

邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。
要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

彼節者有間，而刀刃者無厚；以無厚入有間，恢恢乎其於游刃必有餘地矣。
blog: http://shell909090.org/

twitter: @shell909090
about.me: http://about.me/shell909090

[Young King]

不能用 pip 从 pypi 下载安装吗？

Blog : http://blog.flyzen.com
Zhihu: http://zhi.hu/y
Sina:  http://weibo.com/wayhome
Twitter: http://twitter.com/wayhome
douban: http://www.douban.com/people/wayhome/

[Guannan Ma]

不同代码和文档成型于不同时期（也可能是不同的人），确实有标准不一的历史包袱。有些地方无论代码逻辑还是文档注释有瑕疵是肯定的。 

 

欢迎大家提建议，社区本来就是开放性的。所以各类批评和建议我们都欢迎：） 一潭死水反而有悖初衷了。 哈哈 

集中回答下几个问题：

a.  中英文混杂：

这里有历史包袱问题，后面的patch/new feature会全面转向英文。 

b. 【yegle兄弟的问题】 整体上看虽然说的是基础库，但是更多的只是SA日常处理常用的函数

res只是一角，线程池、网络通信库cup.net.async、心跳、执行器这些其实是为了构建service准备的。 

这两年目标是围绕构建一个service开展的。 Utils和Service支撑是两个关键点

c. 关于其他方面。

欢迎大家提patch， 哈哈。 

之前并没有做过对外介绍，最近才算渐渐走到社区。 

有建议、批评都欢迎。  保持开放态度，大家一起建设、一起写代码才更有趣 ：）

哈哈， --Gallon

On Thu, Sep 13, 2018 at 10:47 AM Shell Xu <shell...@gmail.com> wrote:

[Guannan Ma]

pip安装在近期开展，我开个issue去

[Guannan Ma]

恩， 搞cup.log的其中的一个原因，就是为了标准化日志打印，方便debug、日志数据格式化、分析之类的。

日志打印不规范的现象其实挺普遍的。 

几个关键信息， pid tid timestamp code_line 等等关键信息需要输出，但不是所有项目、人都遵守。

[fy]

中文注释有啥可挑剔的，各国语言的开发者或多或少搞点母语注释很普遍吧，尤其是在项目的初创期。

不过没有pypi差评，py2也差评……我机器上都没有py2很久了

YS.Zou <yeshe...@gmail.com> 于2018年9月13日周四 上午10:43写道：

--

我的github: http://github.com/fy0

[Guannan Ma]

恩， 以前roadmap问题。 

厂子内部支持了 jumbo（一个软件包管理安装工具)和优先支持了pypy兼容（某些业务需要）.

py3兼容和pypi以前优先级排的低。 

最近开始接轨社区，很快会有的， 哈哈。

[Gelin Yan]

百度也用pypy?

看到中文注释…有点辣眼睛…开源前至少得把中文全去掉吧…

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+unsubscribe@googlegroups.com。
要发帖到此群组，请发送电子邮件至python-cn@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+unsubscribe@googlegroups.com。
要发帖到此群组，请发送电子邮件至python-cn@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

进出自由才是游戏者的生存之道。

http://www.zouyesheng.com

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+unsubscribe@googlegroups.com。
要发帖到此群组，请发送电子邮件至python-cn@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

我的github: http://github.com/fy0

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+unsubscribe@googlegroups.com。
要发帖到此群组，请发送电子邮件至python-cn@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+unsubscribe@googlegroups.com。
要发帖到此群组，请发送电子邮件至python-cn@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

[Guannan Ma]

有些业务会用，不是大范围的

看到中文注释…有点辣眼睛…开源前至少得把中文全去掉吧…

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

进出自由才是游戏者的生存之道。

http://www.zouyesheng.com

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

我的github: http://github.com/fy0

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--
邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

[Zagfai]

幾年前我也搞過一個webtul，搞不下去了，哈哈。

[zhangyangyu]

支持一下，学习列表+1

On Wednesday, September 12, 2018 at 2:51:06 PM UTC+8, Gallon Ma wrote:

[bosby j]

可以先中文注释，中文文档做起来。

但是最好不要中英混杂，尤其是非术语英文部分。

--

邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。

[Guannan Ma]

恩, 之前有些历史包袱,  这周基本上全部英文化了.    

Regards,

Guannan Ma

---

https://github.com/baidu/CUP  (Common Useful Python Lib's waiting for you to discover)

可以先中文注释，中文文档做起来。

要退订此群组并停止接收此群组的电子邮件，请发送电子邮件到python-cn+...@googlegroups.com。
要发帖到此群组，请发送电子邮件至pyth...@googlegroups.com。
要查看更多选项，请访问https://groups.google.com/d/optout。

--

邮件来自: `CPyUG`华蟒用户组(中文Python技术邮件列表)
规则: http://code.google.com/p/cpyug/wiki/PythonCn
详情: http://code.google.com/p/cpyug/wiki/CpyUg
严正: 理解列表! 智慧提问! http://wiki.woodpecker.org.cn/moin/AskForHelp
---
您收到此邮件是因为您订阅了Google网上论坛上的“python-cn(华蟒用户组,CPyUG 邮件列表)”群组。