跳转到主要内容

CADC VOS类库

项目描述

https://img.shields.io/pypi/v/vos.svg

vos是一组Python模块和脚本,可简化对VOSpace的访问。

vos的默认安装针对访问由加拿大高级天文学网络 (CANFAR) 提供的VOSpace进行了优化

VOSpace是天文学中使用的分布式云存储服务。

使用vos有两种方式

  1. 使用命令行脚本访问VOSpace:例如 vcp

  2. 在Python脚本中使用vos模块: import vos

对CANFAR VOSpace服务的认证采用X509安全证书、头部令牌或用户名/密码对进行。认证系统由CADC群组管理服务(GMS)管理。

要获取用于与vos工具一起使用的X509安全证书,请使用本包中包含的cadc-get-cert脚本。

更多信息请参阅CANFAR文档

系统需求

  • CANFAR VOSpace账户(写入访问需要,读取访问可以是匿名的)

  • python3.7或更高版本

安装

vos通过PyPI/vos分发,PyPI是获取最新稳定版本的最直接方式

pip install vos --upgrade --user

或者,您可以获取github分发并使用

python setup.py install --user

教程

  1. 获取一个CANFAR账户

  2. 安装vos包。

  3. 使用随vos一起自动安装的cadcutils包中的cadc-get-cert脚本获取X509/SSL证书。

  4. 示例用法。

    1. 命令行用法

      • vls -l vos: [列出vospace]

      • vcp vos:jkavelaars/test.txt ./ [将test.txt从vospace复制到本地目录]

      • vchmod g+q vos:VOSPACE/foo/bar.txt 'GROUP1, GROUP2, GROUP3' 为三个用户GROUP赋予对此文件的写入权限。

      • vmkdir --help [获取命令行选项和参数列表]

      • vmkdir, vrm, vrmdir, vsync, vcat, vchmodvln

      • 使用pydoc vos.commands可以找到vos命令行工具的完整列表

    2. 在Python脚本中(以下示例提供对vospace容器的列表)

      #!python
      import vos
      client = vos.Client()
      client.listdir('vos:jkavelaars')

集成测试

目前,集成测试仅设计为使用CADC VOSpace和测试账户凭据运行。测试假设已经安装了vos和/或vofs包。

运行测试

$ ./test/scripts/vospace-all.tcsh

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码发行版

vos-3.6.1.1.tar.gz (103.3 kB 查看哈希值)

上传时间 源代码

构建发行版

vos-3.6.1.1-py3-none-any.whl (153.3 kB 查看哈希值)

上传时间 Python 3

支持