3 个不稳定版本
0.2.1 | 2021年2月1日 |
---|---|
0.2.0 | 2020年11月18日 |
0.1.0 | 2020年9月1日 |
#5 in #next-cloud
47KB
1K SLoC
NXCloud
NextCloud 客户端命令行界面
关于
一个用于与 NextCloud 服务器交互的 CLI 客户端。
功能
- 允许在服务器上推送和拉取文件。
- 创建和删除远程目录。
- 列出文件。
- 通过 shell 命令进行交互式浏览
此应用程序使您能够在没有 GUI 的情况下交换客户端和 NextCloud 服务器。此 CLI 与 Linux 兼容。它还考虑到 Windows 和 MacOS,但目前尚未测试,性能可能会有所不同。
安装
对于一般的跨平台 Linux,有一个可用的 Snap 包。
sudo snap install nxcloud
如果您已安装 Rust,您可以使用 cargo。
需要安装以下包:libdbus-1-dev, build-essential, libssl-dev(Debian 名称,可能已默认安装)
cargoinstall nxcloud
其他已打包的二进制文件可在 发布 中找到
用法
二进制文件名为 nxcloud
要显示应用程序,请使用 nxcloud help
使用 nxcloud <子命令> help
获取该子命令的帮助。
示例
要开始使用与您的 NextCloud 的交互,您需要登录。
使用应用程序密码而不是账户密码。
nxcloud login<服务器> <用户名> <密码>
列出目录中的文件,支持 -l 和 -a。
nxcloud ls-la
推送和拉取非常简单。
nxcloud pull<源文件路径(远程)> <目标文件路径(本地)>
nxcloud pull<源文件路径(本地)> <目标文件路径(远程)>
进入 shell 以记住当前(远程)目录(实验性)。
允许使用 cd 子命令。
nxcloud shell
构建和测试
此存储库是标准的 Rust 项目 bin 结构。
设置
- 安装 Rust
- 安装 libdbus-1-dev, build-essential, libssl-dev(Linux)
apt install libdbus-1-dev build-essential libssl-dev
(基于 Debian) - 克隆存储库
编译和运行
Rust支持使用以下命令构建或运行:
cargo build
将在 /target/debug/
中构建一个可执行文件。
cargo run -- <args>
将构建并运行一个可执行文件。
测试
可以使用Rust内置的测试框架测试所有标准测试。
cargo测试
某些测试可能无法以100%的可靠性完成(例如,在没有网络访问的情况下可能会失败),这将运行所有被忽略的测试。
cargo测试 ----ignored
文档
Rust内置的文档工具可以生成。
cargodoc
可以使用默认浏览器打开。
cargodoc --open
贡献
完全欢迎并鼓励贡献!
贡献的例子可能包括
- 提交功能请求或错误报告。
- 请求改进文档。
- 通过创建拉取请求来编写代码。
请参阅贡献
状态
开发仍在进行中,正在计划新功能。
请随时贡献。
使用
联系方式
由Ethan Budd创建
电子邮件:[email protected]
许可证
双许可下以下任一
依赖关系
~14–33MB
~503K SLoC