https://www.packagr.app的cli
packagr-cli的Python项目详细描述
packagr cli
什么是packagr?
packagr是您的私有python包的云托管私有存储库。包装袋 cli是一个独立的开源项目,旨在通过允许您执行packagr的大部分功能来支持它 通过API
安装
packagr cli可以通过pip安装:
pip install packagr-cli
然后可以通过任何终端窗口中的packagr
命令调用它:
packagr [command][args]
命令
配置
packagr configure<;hash id>;<;email>;<;password>;
安装packagr cli后,应直接调用configure
命令。此命令将存储您的凭据
对于其他许多packagr cli命令引用的配置文件packagr_conf.toml
,并删除
需要packagr cli持续提示您输入密码(与pip
/tween
的情况一样)
参数
哈希ID
:请参见下面的电子邮件
:您向packagr注册的电子邮件地址密码
:您为packagr注册的密码
在哪里可以获得我的packagr散列ID?
当您第一次注册apackagr帐户时,将为您分配一个唯一的存储库url 看起来像这样:
https://api.packagr.app/u893rj/
这个url的最后一部分是您的hash id
初始化
packagr init<;name>;[--覆盖]
为了创建包,packagr需要一个名为packagr.toml
的文件,其中包含有关包的信息。
package init
命令为您创建此文件
name
参数是可选的-如果未指定,则该名称将默认为调用该调用的文件夹的名称
从
此外,如果还不存在名为name
的子文件夹,则init
命令还将创建该子文件夹。默认情况下,
packagr假定要打包的代码存储在此文件夹中。但是,如果你想定制它,你可以
可以通过编辑packagr.toml
中的packages
参数轻松完成此操作。也可以修改任何值
手动进入配置文件。
参数
名称
(可选):包的名称--overwrite
(可选):如果试图在已经存在packagr.toml
文件的文件夹中运行packagr init
,则 系统将提示您确认是否要覆盖现有文件。传递此参数将覆盖提示
SET
packagr set<;key>;<;value>;
创建packagr.toml
文件后,可以使用set
命令在其中设置值。例如,如果
如果要在配置中添加说明,可以输入以下命令:
packagr set description "some information"
您也可以进入packagr.toml
文件,手动添加行description="some information"
,
但建议的方法是使用cli—最终,cli将验证键的值以确保
有效。
如果输入了重复的键,系统将提示您确认是否要覆盖它
参数
键
:设置键值
:设置值
packagr add<;key>;<;value>;
add
命令的工作方式与set
命令类似,但其目的是已经将数据附加到数组
在配置中定义。例如,如果您的配置已经如下所示:
Authors=['Chris <chris@packagr.app>']
然后可以使用packagr add authors"some guy<;me@example.com&g更新这个值t;"将其更改为以下内容:
Authors=[ "Chris <chris@packagr.app>", "Some guy <me@example.com>",]
add
命令还将为不存在的键添加值。
参数
键
:设置键值
:设置值
安装
packagr install<;some package>;
install
命令的工作方式与pip install类似-它使用当前环境的
pip
安装。但是,此命令还将在packagr存储库以及
公共pypi存储库。一旦软件包安装正确,它也将被添加到您的配置中
章节
参数
软件包
:要安装的软件包列表--忽略错误
:如果有多个包,传递此参数意味着packagr将继续尝试 如果有一个软件包失败,请安装列表中的其余软件包
卸载
packagr uninstall<;some package>;
此命令与install相反-它卸载给定的包并将其从依赖项列表中删除。
参数
软件包
:要卸载的软件包列表--忽略错误
:如果有多个包,传递此参数意味着packagr将继续尝试
颠簸
packagr bump<;version>;[--次要][--主要]
bump
命令增加包的版本号。不带参数使用,例如packagr bump
,它
增加版本号,例如1.0.0
变为1.0.0
。使用--minor
参数会增加minor版本
数字,例如1.0.0>;1.1.0
和--major
参数将1.0.0
转换为2.0.0
。--major
和--minor
参数可以相互结合使用。
或者,可以使用packagr bump 4.5.6
为特定值设置版本。如果您不使用semver
,
这意味着bump
命令可能无法解析现有版本号,然后可以使用此选项
取而代之的是< /P>
参数
版本
(可选):要设置的版本号。与任何其他参数都不兼容--次要版本
(可选):增加次要版本号--主版本
(可选):增加主版本号
包装
packagr包
根据配置文件创建sdist
和/或wheel
包。使用不带参数的命令将创建
两种格式的包。使用--no wheel
或no sdist
将阻止创建特定格式
参数
--没有sdist
:不要构建tarball--没有轮子
:不要制造轮子
上传
packagr upload[--ignore-409]
此命令将把您的包推送到packagr。如果同时上载多个包,则可以选择使用
--ignore-409
参数,如果遇到409错误(url冲突),它将跳到下一个包。将来,
packagr cli将能够显示packagr的详细日志,与tween
相比,packagr具有很大的优势
处理错误响应的能力有限
创建标记
packagr create token<;package>;<;email>;[--写访问]
此命令为给定的包和用户创建访问令牌。如果提供了--write access
标志,则
创建的令牌将具有写入权限。
删除标记
packagr token delete<;包>;<;电子邮件>;。代码>
此命令删除给定包和用户的访问令牌。
即将推出
以下命令将添加到未来版本的packagr cli中:
packagr set readme<;readme file>;
:将自述文件的内容传递到说明
packagr set public<;my package>;
:将包设置为public
packagr set private<;my package>;
:将包设置为private