vos is a set of python modules and scripts that ease access to VOSpace.
The default installation of vos is tuned for accessing the VOSpace provided by the Canadian Advanced Network For Astronomical Research (CANFAR)
VOSpace is a Distributed Cloud storage service for use in Astronomy.
There are two ways to use vos:
access VOSpace using the command-line script: eg. vcp
use the vos module inside a Python script: import vos
Authentication to the CANFAR VOSpace service is performed using X509 security certificates, header tokens or username/password pairs. The authentication system is managed by the CADC Group Management Service (GMS).
To retrieve an X509 security certificate for use with the vos tools use the cadc-get-cert script included with this package.
Additional information is available in the CANFAR documentation
System Requirments
A CANFAR VOSpace account (required for WRITE access, READ access can be anonymous)
Python 3.10 through 3.14
Installation
vos is distributed via PyPI/vos and PyPI is the most direct way to get the latest stable release:
pip install vos --upgrade --user
Or, you can retrieve the github distribution and use
python setup.py install --user
Tutorial
Get a CANFAR account
Install the vos package.
Retrieve a X509/SSL certificate using the cadc-get-cert script installed as part of the cadcutils package that is automatically installed wiht vos.
Example Usage.
Commandline usage:
vls -l vos: [List a vospace]
vcp vos:jkavelaars/test.txt ./ [copies test.txt to the local directory from vospace]
vchmod g+q vos:VOSPACE/foo/bar.txt 'GROUP1, GROUP2, GROUP3' to give three user GROUPs permission to write to this file.
vmkdir --help [get a list of command line options and arguments]
vmkdir, vrm, vrmdir, vsync vcat, vchmod and vln
The complete list of vos commmand line tools can be found using pydoc vos.commands
In a Python script (the example below provides a listing of a vospace container)
#!python import vos client = vos.Client() client.listdir('vos:jkavelaars')
Integration Tests
The integration tests are, at present, designed to run only with the CADC VOSpace and test accounts credentials. Tests assume that vos and/or vofs packages have been installed.
Run the tests:
$ ./test/scripts/vospace-all.tcsh
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vos-3.7.tar.gz.
File metadata
- Download URL: vos-3.7.tar.gz
- Upload date:
- Size: 103.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
073cde0ec3ffe52f283ba6505870e760492a73743986797686e7dc57d30ca563
|
|
| MD5 |
d266eaf541c43a0a0a6f7cfafa9205e4
|
|
| BLAKE2b-256 |
2f7135b07ebde34232b4f3deca8cb320c3ad615b15818fbb3b10a5209c14aadc
|
Provenance
The following attestation bundles were made for vos-3.7.tar.gz:
Publisher:
cibuild.yml on opencadc/vostools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vos-3.7.tar.gz -
Subject digest:
073cde0ec3ffe52f283ba6505870e760492a73743986797686e7dc57d30ca563 - Sigstore transparency entry: 2362355559
- Sigstore integration time:
-
Permalink:
opencadc/vostools@b74878d8e87575d85e91907418fdd46adddc4eae -
Branch / Tag:
refs/tags/vos=3.7 - Owner: https://github.com/opencadc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cibuild.yml@b74878d8e87575d85e91907418fdd46adddc4eae -
Trigger Event:
push
-
Statement type:
File details
Details for the file vos-3.7-py3-none-any.whl.
File metadata
- Download URL: vos-3.7-py3-none-any.whl
- Upload date:
- Size: 153.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1cb23f33f9a9779ed7d0fe2a30c23ee021d0a0c29e65fdaf65bba91ee297a356
|
|
| MD5 |
3973001eef2146aa411495a3087553b6
|
|
| BLAKE2b-256 |
7e98638365ca3336412689407606a0d10512ea01b3c1ecdfd5b3a7e1d31bb563
|
Provenance
The following attestation bundles were made for vos-3.7-py3-none-any.whl:
Publisher:
cibuild.yml on opencadc/vostools
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vos-3.7-py3-none-any.whl -
Subject digest:
1cb23f33f9a9779ed7d0fe2a30c23ee021d0a0c29e65fdaf65bba91ee297a356 - Sigstore transparency entry: 2362355679
- Sigstore integration time:
-
Permalink:
opencadc/vostools@b74878d8e87575d85e91907418fdd46adddc4eae -
Branch / Tag:
refs/tags/vos=3.7 - Owner: https://github.com/opencadc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cibuild.yml@b74878d8e87575d85e91907418fdd46adddc4eae -
Trigger Event:
push
-
Statement type:
