# Command-Line Transfer
Command-Line Transfer (CLT) is a command-line interface (CLI) used to download multiple files and directories from the Globus file transfer service. The CLT initiates a transfer from a Globus endpoint to the [Globus Connect Personal](https://www.globus.org/globus-connect-personal) application. CLT provides `hubmap-clt` and `sennet-clt` command-line interfaces for HuBMAP and SenNet, respectively.
## Usage
CLT provides `hubmap-clt` and `sennet-clt` command-line interfaces. The following documentation uses `<consortium>-clt` in examples. Please replace `<consortium>` with `hubmap` or `sennet`.
Usage documentation can also be found by running the following command:
```
<consortium>-clt -h
```
### Login
A one-time login is required for any download session. For non-public data, you must log in with your HuBMAP or SenNet account. For publicly available data, you can log in with any account accepted by the login form (Google and ORCID). Log in can be initiated using the following command:
```
<consortium>-clt login
```
### Logout
Logout can be used to log out the current user.
```
<consortium>-clt logout
```
### Transfer
A data transfer and download can be initiated using the transfer command and a manifest file. You must be logged in to use the transfer command.
```
<consortium>-clt transfer <PATH/TO/MANIFEST/FILE>
```
An optional destination argument can be specified. The destination is the directory on the user's computer where data will be downloaded. The directory will be created if it doesn't exist. The destination argument is relative to the user's home directory (~). For example, `--destination Desktop/<consortium>-data` corresponds to an absolute path of `~/Desktop/<consortium>-data`. The default destination directory is `~/<consortium>-downloads`.
```
<consortium>-clt transfer <PATH/TO/MANIFEST/FILE> --destination <PATH/TO/DESTINATION/DIRECTORY>
```
### Whoami
Whoami can be used to display the information of the currently logged in user.
```
<consortium>-clt whoami
```
## Additional Documentation
Additional documentation can be found at the [HuBMAP](https://software.docs.hubmapconsortium.org/clt) and [SenNet](https://docs.sennetconsortium.org/libraries/clt) documentation pages.
## Development
A `src/atlas_consortia_clt/common/app.cfg` configuration file is required to build the CLT. An example `app.cfg.example` file is located in the `src/atlas_consortia_clt/common` directory. Replace the values in `app.cfg.example` and rename the file to `app.cfg`.
When contributing to the CLT, run the following commands in the root directory to install the editable package.
```
python3 -m pip install --upgrade pip setuptools
python3 -m pip install -e .
```
### Building and Publishing
Install the `build` package and build the project by running the following commands in the root directory. These commands should generate a `dist` directory.
```
python3 -m pip install --upgrade build
python3 -m build
```
Install the `twine` package and upload the build files to PyPI by running the following commands. The second command will prompt for a PyPI username and password.
```
python3 -m pip install --upgrade twine
python3 -m twine upload dist/*
```
See the [Python Documentation](https://packaging.python.org/en/latest/tutorials/packaging-projects/#generating-distribution-archives) for more detailed instructions on building and publishing.
Raw data
{
"_id": null,
"home_page": "",
"name": "atlas-consortia-clt",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "HuBMAP CLT,SenNet CLT,HuBMAP,SenNet,CLT,Command Line Transfer,Manifest",
"author": "",
"author_email": "Atlas Consortia <api-developers@hubmapconsortium.org>",
"download_url": "https://files.pythonhosted.org/packages/6c/fb/49b5a37c6a0a56ac0802dfe4ac06cac4fc66734465709a721f3a919c18b1/atlas-consortia-clt-1.0.1.tar.gz",
"platform": null,
"description": "# Command-Line Transfer\n\nCommand-Line Transfer (CLT) is a command-line interface (CLI) used to download multiple files and directories from the Globus file transfer service. The CLT initiates a transfer from a Globus endpoint to the [Globus Connect Personal](https://www.globus.org/globus-connect-personal) application. CLT provides `hubmap-clt` and `sennet-clt` command-line interfaces for HuBMAP and SenNet, respectively.\n\n## Usage\n\nCLT provides `hubmap-clt` and `sennet-clt` command-line interfaces. The following documentation uses `<consortium>-clt` in examples. Please replace `<consortium>` with `hubmap` or `sennet`.\n\nUsage documentation can also be found by running the following command:\n```\n<consortium>-clt -h\n```\n### Login\n\nA one-time login is required for any download session. For non-public data, you must log in with your HuBMAP or SenNet account. For publicly available data, you can log in with any account accepted by the login form (Google and ORCID). Log in can be initiated using the following command:\n\n``` \n<consortium>-clt login\n```\n\n### Logout\n\nLogout can be used to log out the current user.\n```\n<consortium>-clt logout\n```\n\n### Transfer\n\nA data transfer and download can be initiated using the transfer command and a manifest file. You must be logged in to use the transfer command.\n```\n<consortium>-clt transfer <PATH/TO/MANIFEST/FILE> \n```\nAn optional destination argument can be specified. The destination is the directory on the user's computer where data will be downloaded. The directory will be created if it doesn't exist. The destination argument is relative to the user's home directory (~). For example, `--destination Desktop/<consortium>-data` corresponds to an absolute path of `~/Desktop/<consortium>-data`. The default destination directory is `~/<consortium>-downloads`.\n```\n<consortium>-clt transfer <PATH/TO/MANIFEST/FILE> --destination <PATH/TO/DESTINATION/DIRECTORY>\n```\n\n### Whoami\n\nWhoami can be used to display the information of the currently logged in user.\n``` \n<consortium>-clt whoami\n```\n\n## Additional Documentation\n\nAdditional documentation can be found at the [HuBMAP](https://software.docs.hubmapconsortium.org/clt) and [SenNet](https://docs.sennetconsortium.org/libraries/clt) documentation pages.\n\n\n## Development\n\nA `src/atlas_consortia_clt/common/app.cfg` configuration file is required to build the CLT. An example `app.cfg.example` file is located in the `src/atlas_consortia_clt/common` directory. Replace the values in `app.cfg.example` and rename the file to `app.cfg`.\n\nWhen contributing to the CLT, run the following commands in the root directory to install the editable package.\n```\npython3 -m pip install --upgrade pip setuptools\npython3 -m pip install -e .\n```\n\n### Building and Publishing\n\nInstall the `build` package and build the project by running the following commands in the root directory. These commands should generate a `dist` directory.\n```\npython3 -m pip install --upgrade build\npython3 -m build\n```\n\nInstall the `twine` package and upload the build files to PyPI by running the following commands. The second command will prompt for a PyPI username and password. \n```\npython3 -m pip install --upgrade twine\npython3 -m twine upload dist/*\n```\n\nSee the [Python Documentation](https://packaging.python.org/en/latest/tutorials/packaging-projects/#generating-distribution-archives) for more detailed instructions on building and publishing.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "HuBMAP and SenNet command-line interface to download data using a manifest file.",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/x-atlas-consortia/clt/issues",
"Homepage": "https://github.com/x-atlas-consortia/clt"
},
"split_keywords": [
"hubmap clt",
"sennet clt",
"hubmap",
"sennet",
"clt",
"command line transfer",
"manifest"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5b2c53bf1cd1cf009246e74cb2215609aa6603ceeb5ce5d1ddaa4e89f0e5d292",
"md5": "8b9f422c488854dfebdb1d03deb7ebc4",
"sha256": "d0ca4d7df5e0f445bb76ee07ae953447def3fa04d07ad28e5db28418f29006b5"
},
"downloads": -1,
"filename": "atlas_consortia_clt-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8b9f422c488854dfebdb1d03deb7ebc4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 10567,
"upload_time": "2023-08-03T17:28:00",
"upload_time_iso_8601": "2023-08-03T17:28:00.787565Z",
"url": "https://files.pythonhosted.org/packages/5b/2c/53bf1cd1cf009246e74cb2215609aa6603ceeb5ce5d1ddaa4e89f0e5d292/atlas_consortia_clt-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6cfb49b5a37c6a0a56ac0802dfe4ac06cac4fc66734465709a721f3a919c18b1",
"md5": "41114b90e26d66b3bad3e5abce88eed0",
"sha256": "be3fede05d7b2047ec6a03a99c1094c0a6fc7b870449f49ab6b1cec2ab7ea4a7"
},
"downloads": -1,
"filename": "atlas-consortia-clt-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "41114b90e26d66b3bad3e5abce88eed0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 9881,
"upload_time": "2023-08-03T17:28:02",
"upload_time_iso_8601": "2023-08-03T17:28:02.211134Z",
"url": "https://files.pythonhosted.org/packages/6c/fb/49b5a37c6a0a56ac0802dfe4ac06cac4fc66734465709a721f3a919c18b1/atlas-consortia-clt-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-03 17:28:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "x-atlas-consortia",
"github_project": "clt",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "atlas-consortia-clt"
}
JSON
