【github项目创建、代码上传与审查】
在GitHub上开源项目或者记录自己的学习心得成了一个程序员会做的事情,其中如何对我们已写好的demo利用GtiHub和Pycharm进行代码审查呢?
目录
1.GitHub创建项目
-
进入github网站,点击New按钮
-
输入项目名称和全选选项,点击创建
-
然后我们就创建成功了,得到三个初始文件
-
README.md:说明项目内容 使用markdown语法
middle title
------------
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
*强调*
@Override
protected void onDestroy() {
EventBus.getDefault().unregister(this); // code
super.onDestroy();
}
表头 | 表头 | 表头
---- | ----- | ------
单元格内容 | 单元格内容 | 单元格内容
单元格内容 | 单元格内容 | 单元格内容
![图片名称](https://www.baidu.com/img/bd_logo1.png)
1. 项目1
2. 项目2
3. 项目3
* 项目1 (注意一个*号会显示为一个黑点,注意⚠️有空格,否则直接显示为*项目1)
* 项目2
> 第一行引用文字
>> 第二行引用文字
2.上传代码文件
2.1CodeFactor
这是一个非常简洁的工具,可以用来检查你的代码质量。它可以免费用于所有的公共库,以及1个私有库。
首先,请先去官方网站codefactor.io,并通过GitHub登录,创建一个新账号。(要完成此操作的)图标应该是位于主页的右上角。
注册后,单击右上角的加号,将1个库添加到你的控制面板。
从列表中选中你要分析的库,然后单击页面底部的import。
然后就好啦!现在你应该已经转到一个包含着已发现的所有问题的列表的控制面板了。太棒了!
2.2wemake-python-styleguide
让我们接着讲第二个工具。这个工具能够检查代码是否符合官方Python风格指南。
这次我们不用在任何Web服务中创建新账号。我们将搭建起一个GitHub Actions工作流,每当一个pull request被创建出来时,该工作流都会被触发,并会在发现潜在问题时添加评论。
给那些还不了解GitHub Actions的人介绍一下:它是GitHub上的一项新功能,可以实现许多任务的自动化,通常被视为CI / CD工具(Continuous Integration/Continuous Deployment,持续集成/持续部署),能够进行测试,进行质量检查,然后部署。但这还不是它的唯一目标。
开始时,首先在项目的根文件夹中创建一个.github / workflows文件夹,你的工作流的定义将会被放在这里。
然后创建一个新文件,命名为workflow-pr.yaml。
name: Python Pull Request Workflow
on: [pull_request]
jobs:
qa:
name: Quality check
runs-on: ubuntu-20.04
steps:
- uses: actions/checkout@v1
- name: Set up Python
uses: actions/setup-python@master
with:
python-version: 3.8
- name: Run unit tests
run: |
pip install pytest
pytest
- name: Wemake Python Stylguide
uses: wemake-services/wemake-python-styleguide@0.13.4
continue-on-error: true
with:
reporter: 'github-pr-review'
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
这是一个非常简单的工作流,全名为Python Pull Request Workflow。每个pull request都能触发它,因此无论何时创建新的或更新现有的作业,都会运行。
上面的工作流仅包含一个qa工作,分为4个步骤:
- actions / checkout @ v1——必须让GitHub Actions工作流知道它可以使用库中的代码
- 使用actions/setup-python@master的Set up Python配置好一个Python版本,在本例中为使用的是python-version: 3.8。
- Run unit tests将运行位于项目中的所有单元测试。为此,我使用的是pytest,首先需要安装pip install pytest,以便可以运行下一个命令pytest。如果这一步上有任何一个测试失败,则下一个测试将不会运行。
- Wemake Python Styleguide的这一个步骤是我们最感兴趣的。它使用wemake-services/wemake-python-styleguide@0.13.4操作,这是工作流的基本组成单位。你可以在GitHub Marketplace上找到它们(https://github.com/marketplace),就像上述提到的一样(https://github.com/marketplace/actions/wemake-python-styleguide)。将此代码配置为(with 语句)以使用github-pr-review reporter,就可以在code review中启用内联注释了。在官方网站上可以找到更多受支持的reporter选项。最后,此工作流需要传递你的GIHUB_TOKEN,这就是添加env语句的原因。
为了测试它的运行,你需要创建一个新的branch,提交一些更改并将其推送到GitHub。然后创建一个pull request,就能触发此工作流了。要检查它,请转到项目中的“Actions”选项,如果一切顺利则应如下图所示:
如果单击“Run unit tests”,则在console log中,你将看到测试报告:
如果返回到Pull request,则应该看到添加的注释。就像这里那样:algorithms-python
2.3Codecov
最后,我们想要一份涵盖范围的测试报告。为此,我们再次使用pytest库,它将为我们生成报告,然后我们将其上传到Codecov,后续的可视化就由它完成。
在定义一个新的工作流之前,你首先需要先创建一个Codecov账号。因此,你需要先单击右上角的“Sign Up”按钮转到https://about.codecov.io/。
然后选择GitHub注册。
然后,你将被带到GitHub项目的控制面板,然后需要单击Add new repository按钮。
然后会出现一个带有令牌(token)的页面。把它保存下来,因为下一步中会用到。
现在回到GitHub的项目上,然后单击其“Settings”按钮。单击“Secrets”,然后添加一个新的secret,这时就可以用上你在Codecov网站上生成的令牌了。要完成这一步,单击Add secret。
好的,一切都已设置好了,接下来就可以继续定义GitHub工作流了。
name: Python Master Workflow
on:
push:
branches:
- 'master'
jobs:
codecov:
name: Codecov Workflow
runs-on: ubuntu-20.04
steps:
- uses: actions/checkout@v1
- name: Set up Python
uses: actions/setup-python@master
with:
python-version: 3.8
- name: Generate coverage report
run: |
pip install pytest
pip install pytest-cov
pytest --cov=./ --cov-report=xml
- name: Upload coverage to Codecov
uses: codecov/codecov-action@v1
with:
token: ${{ secrets.CODECOV_TOKEN }}
file: ./coverage.xml
flags: unittests
再次,我们创建一个单独的文件,命名为workflow-master.yaml,因为这次我们不想在创建pull request时触发此工作流。这个工作流仅当在master branch上推送了新的提交时才会运行。
在jobs部分中,只有一个名为codecov的作业,包括四步:
- uses: actions/checkout@v1——这个步骤,跟上次一样,也只是为了告诉GitHub Actions我们要使用当前库里的文件
- uses: actions/setup-python@master——这个步骤之前也提到过,这里我们设置的Python版本是3.8
- 然后是一个新步骤,负责生成覆盖率报告(Generate coverage report);这包含一系列脚本,涵盖了安装pytests(pip install pytest),pytest-cov(pip install pytest-cov)和运行实际测试(pytest-cov =./-cov-report = xml),
- 最终,生成的测试覆盖率报告可以上传到Codecov(Upload coverage to Codecov)。在这里我们使用uses: codecov / codecov-action @ v1(https://github.com/marketplace/actions/codecov)。在其中,我们提供3个参数:token: ${{ secrets.CODECOV_TOKEN }},取值自我们放置在GitHub Secrets保管库的文件,(之前的步骤生成的)测试覆盖率报告的位置是file:./coverage.xml,而flags:unittests是对我们的单元测试进行分组的标志。
要进行测试,你需要将一些提交push到master branch。这可以直接在你的本地库中完成,也可以通过合并一个pull request完成。如果一切顺利,那页面应该是像这样的:
现在,如果你回到Codecov,回到你的项目控制面板,你应该能看到类似的输出:
在结尾之前,我想告诉你的是,能帮你写出更高质量代码的工具并非只有CodeFactor,Codecov或wemake-python-styleguide。实际上,这样的工具有很多,例如SonarCloud,Pylint,Coveralls,DeepSource等等。其中一些可以在GitHub Marketplace上找到,如果你不喜欢我提议的这几个工具,那么最好从那上面的地方为起点开始寻找。
3.利用Pycharm IDE审查代码
3.1查看代码运行时间
Run->Concurrency Diagram for’xx.py’
3.2项目代码覆盖率
Run->'xx.py’with Coverage
如果只是针对单个文件进行代码覆盖率审查,可以浏览Python代码覆盖率分析工具Coverage这篇文章。
覆盖率只是一个参考指标,不要过于达到100%覆盖率
3.3代码之间的调用关系
Run->Profile’xx.py’with Coverage
以下图是代码之间的调用关系,以及花费时间
参考资料
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)