学术, 其他笔记

Python开源项目Guan

在使用其他的软件包时,往往会遇到包装过度、调用接口少、文档复杂等问题。这里把自己常用的一些函数打包成 package 上传至 PyPI,方便后续的调用。函数和版本会根据需求不定期更新。

Guan软件包官网:https://py.guanjihuan.com

安装或更新命令:

pip install --upgrade guan

如果无法获取最新版本,可以指定默认源安装,安装命令为:

pip install --upgrade guan -i https://pypi.python.org/simple

使用方法:

import guan

项目说明:

  1. 该项目最初的目的是方便自己的调用,在使用相同功能函数时不需要复制到新的py文件中,直接使用“import guan”。您如果觉得某些函数有用,也可安装使用。如果觉得某些函数不能完全达到自己的要求,可复制函数源码自行修改,同时也可邮件反馈,在后续版本更新中会修改或者补充。
  2. 不包装成类(class),全部以函数(function)的形式实现功能,使用时无需查询某个函数归为哪个类,方便直接调用。不额外增加繁杂的说明文档,在函数中会尽量避免对各种情况的判断,只实现某种单一功能,同时变量名也尽量会通俗化,方便源码的阅读。
  3. 在使用前建议大概浏览下源码,了解函数具体的输入输出格式,不建议生搬硬套,不然容易出现错误。另外,注意随着版本的更新,函数名字可能会发生改变,如果遇到函数无法使用,需改为最新版本所对应的名字。

如果是离线机器,可以在联网的机器上先下载 .whl 文件:

pip download guan

然后将 .whl 文件转移到离线机器上安装:

pip install guan-***.whl

一些学习示例:GUAN软件包学习示例

其他开源项目:凝聚态物理中的一些开源软件包

项目上传方法:PyPi上传流程

我的项目版本管理步骤:

  1. 修改项目的源码;修改网站的 API。
  2. 通过命令将最新版本上传至 PyPi;本地 pip install --upgrade guan 更新。
  3. 同步到 GitHub;同步到 Cloud。
1,630 次浏览

【说明:本站主要是个人的一些笔记和代码分享,内容可能会不定期修改。为了使全网显示的始终是最新版本,这里的文章未经同意请勿转载。引用请注明出处:https://www.guanjihuan.com

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

Captcha Code