Rosecloud客户端
rc-cli的Python项目详细描述
rosecloud cli
rosecloud cli工具。它旨在用于设置和管理 一个供教师和助教使用的RoseCloud工作区。
要求
- 巨蟒3.5+
开发
设置
使用pipenv
- 安装
pipenv
:sudo pip安装pipenv
- 运行pipenv install。
这将为您设置一个python虚拟环境。所有后续
命令应该通过
pipenv run…
运行。如果需要添加 另一个依赖项,运行pipenv install<;package\u name>;
< > > - 运行pipenv install-e.。这将创建指向此的符号链接
项目。此处的所有更改都将显示在
pipenv
- 运行
pipenv运行rc--help
< > > - 运行
pip install-r requirements.txt 这将把所有依赖项安装到您的计算机上。如果你不这么做 想搞乱虚拟环境,可以添加一些 全局依赖于您的计算机。
< > > - 运行pip install-e。
- 运行rc--help
< > >
注意事项
- 偶尔更新
requirements.txt
。建议使用pigar - 偶尔更新
setup.py
依赖项。 - 通过运行
docker build-t docker.csse.rose hulman.edu/rosebuild/rc cli/pypi deployer:major.minor.patch。--无缓存
docker push docker.csse.rose hulman.edu/rosebuild/rc cli/pypi deployer:major.minor.patch
- 我们需要测试
- click支持独立的文件系统和内部调用
测试
要对此项目运行测试,请执行以下步骤。继续之前,请确保已下载Python3.4或更高版本
设置python和pip
如果您安装了python 3.4或更高版本,pip将捆绑在安装中。但是,你可能会发现 您仍然无法在终端中使用pip命令。这是因为我们必须将pip放入 您的计算机环境变量。为此:
- 打开屏幕左下角的Windows菜单
- 右键单击"Computer"(计算机)并选择"Properties"(属性)
- 选择"高级系统设置"
- 选择"环境变量"
- 在标有"系统变量"的框中,找到"path"变量
- 选择此行并选择"编辑"
- 追加到列表末尾";{path to python install};{path to python install}\scripts"
- 重新打开终端,您应该可以使用pip命令
安装库
Pip
我们现在需要运行所有必要的安装。下面列出了这些安装。
- 如果还没有,请运行"pip install requirements.txt"
虚拟V
- 导航到rc cli文件夹
- 输入命令"virtualenv venv/script/bin"
- 输入命令"notest"
运行测试
你现在应该可以运行测试了。导航到终端中的rc_cli\restore文件夹。 现在,运行命令"notests restorertests.py"。现在,我得到了一个"坏的git可执行文件" 错误。如果有任何错误,请告诉我。
发布
Ci
你可以阅读下面的手动操作。要部署,请确保存储库 已清除(提交并推送所有文件)。
注意
在提交到master之前,请更新rc cli服务的版本。 为此,请将setup.py文件中的
version
参数更新为最新版本, 格式为major.minor.patch
设置
首先,需要安装pypi的发布工具tween。 运行,
pip install twine
您还需要
控制盘
。 运行,pip install wheel
最后,通过运行确保您拥有最新的设置工具
pip install --upgrade setuptools
您还需要设置一个pypi帐户(链接) 以及一个测试pypi帐户(链接)。
为了便于使用,您可以在主目录中创建一个名为
.pypirc
使用以下命令。对于Linux和OSX,这将是~/.pypirc
。捆绳
将使用此请求而不是 正在请求凭据。[pypi] username = <username> password = <password> [testpypi] username = <username> password = <password>
更新版本
在生成要发布的任何文件之前,我们必须首先更新软件的版本。
- 打开
setup.py
- 在第12行找到
版本
参数 - 将此参数修改为新的版本号。格式为
major.minor.patch
< > >
生成dist文件
开始之前,请确保
python
的版本为3.5+。以下命令将 生成特定于您的python
版本和一些特性的dist文件 在这个项目中使用的是特定的Python3.5+
。要生成
dist
文件,需要运行python setup.py bdist_wheel
上载新发行版
如果要上载更改,则应更新下面
setup.py中的版本 语义版本控制原则。(请参阅更新版本
运行以下命令将最新更改上载到正式的
pypi
serverstwine upload dist/*
现在可以使用
pip install rc-cli
或者,要在不干扰生产的情况下进行测试,请运行此命令
twine upload --repository-url https://test.pypi.org/legacy/ dist/*
要从测试安装,
pip install --index-url https://test.pypi.org/rc-cli rc-cli
有关PYPI发行版的更多信息,请点击链接
更多关于test pypi的信息,请点击这里的链接
推荐PyPI第三方库
- 偶尔更新