###### tags: `twcc`, `twccli`
# TWCC-CLI Project
The [TWCC, Taiwan Computing Cloud](https://www.twcc.ai) Command Line Interface (CLI) is an environment to create and manage your TWCC services.
[](https://twcc-cli.readthedocs.io/en/latest/?badge=latest)
The TWCC Command Line Interface (CLI) is an environment to create and manage your TWCC resources.
If you have any questions, please email us at: iservice@twcc.ai for account support, and isupport@twcc.ai for technical support
❗ ❗ Always try to upgrade your TWCC-CLI by using `pip3 install -U TWCC-CLI`. ❗ ❗ ❗
## :point_down: Release Notes :point_down:
### v0.6.1 Release Note
The "We miss you, Viga!" version
**Feature**
- Compatible for Security Group operations.
**Bug Fix**
- various bugs fixed
### v0.6.0 Release Note
**Feature**
- New CCS features for you!
- We sync VCS and CCS solutions and images with User Portal.
- VDS now can snapshot.
**Bug Fix**
- fix bug
### v0.5.24.2 Release Note
**Feature**
- CLI will remind users while config init when a new version is released.
**Bug Fix**
- fix bug
### v0.5.24.1 Release Note
**Bug Fix**
- fix bug of init
### v0.5.24 Release Note
**Feature**
- Remove VCS/CCS you are connecting to by `twccli rm me --no-dry-run`.
- TWCC-CLI supports more vcs spec feature, according to users' project. Check with `twccli ls vcs -itype ubuntu -ptype`.
**Bug Fix**
- fix #42
- fix some bugs
- fix some error message discriptio
### v0.5.23.2 Release Note
**Bug Fix**
- Remove old package
- Fix bug in ansible scripts
### v0.5.23 Release Note
**Feature**
- Users can set Elastic IP(Check more in [@twccdocs/vcs-eip](https://man.twcc.ai/@twccdocs/doc-vcs-main-zh/https%3A%2F%2Fman.twcc.ai%2F%40twccdocs%2Fguide-vcs-eip-zh)) for VCS, by `twccli [ls|mk|rm|ch] eip`
- Users can import your owned public key, check more in `mk key`
**Bug Fix**
- fix some bugs
- fix some error message discription
### v0.5.22 Release Note
**Bug Fix**
- fix major bugs
### v0.5.21 Release Note
**Feature**
- Users can protect your sites from not expected remove, check out `-keep` while `twcc ch [ccs|vcs]`.
- Enable VCS reboot, check out `-sts Reboot` while `twccli ch vcs`
**Bug Fix**
- fix ValueError: APIKEY is not validated, while `config init` , related [#34](https://github.com/twcc/TWCC-CLI/issues/34)
- fix some bugs
### v0.5.20 Release Note
**Feature**
- Users can pass any command to your CCS by using `-cmd` or `--command` right after it right after your CCS ready
**Bug Fix**
- fix some bugs while using vcs
### v0.5.19 Release Note
**Feature**
- Users can use `-ptype` to create customized CCS.
- Users can transport your credentials to your new resources. You can switch off by providing `-nokey` while `twcc mk [ccs|vcs]`.
**Bug Fix**
- fix auto migrating bugs
- fix typo error
- fix some bugs
### v0.5.18 Release Note
**Feature**
- We support auto-complete for TWCC-CLI :sparkles::sparkles:
- We support Python 3.9 :sparkles:
- We enable environment parameters in CCS
**Bug Fix**
- fix some bugs
### v0.5.17 Release Note
**Feature**
- We add sonarqube for better software quality.
- VCS `snapshot` be renamed to `custom-image` in TWCC.
- BSS(block storage service) has been renamed to [VDS(virtual disk service)](https://man.twcc.ai/@twccdocs/r1DhqHdpN) in TWCC.
- Enable envoronment variables for VCS, check out `twccli mk vcs -h`.
**Bug Fix**
- fix bug in `mk key`
- fix bug in `ls -itype`
- fix exception bug
- Update AIML Pipeline scripts.
### v0.5.16.2 Release Note
**Feature**
- Users can create VCS with windows img
**Bug Fix**
- fix some bugs
### v0.5.16.1 Release Note
**Bug Fix**
- fix some bugs
### v0.5.16 Release Note
**Feature**
- CLI is now collected users operating information by GA. If you don't want to be collect, just keep your `ga_cid` value **EMPTY** in `$HOME/.twcc_data/credential`.
- Users can turn on/off COS bucket version control feature and create public access URL for specific objects.
- Users can checkout [HFS](https://man.twcc.ai/@twccdocs/rypYCr_TN) info with CLI
- Users can list CCS log, and show more information.
- CLI now can renew your credential file automatically, keep it up-to-date.
**Bug Fix**
- fix bug in `net vcs`
### v0.5.15 Release Note
**Feature**
- BSS(Block Storage Service) is officially renamed as VDS(Virtual Disk Service).
- Users can list personal resource of VDS & [VLB](https://www.twcc.ai/doc?page=load_balancer).
- Users can create multi listener over [VLB](https://www.twcc.ai/doc?page=load_balancer).
- Users can change VCS descrption with `-d`.
- Users can multiply name their SnapShot wile createing.
**Bug Fix**
- fix #9
- fix timezone problem
- fix error response for snapshot
### v0.5.14 Release Note
**Feature**
- Users can operate volumn in [VCS](https://www.twcc.ai/doc?page=vm).
- We let `-s` support multiple site-id.
- New progress bar for [COS](https://www.twcc.ai/doc?page=object) operations.
**Preview**
- Users can operate [Vertual Network](https://www.twcc.ai/doc?page=virtual_network) (Tenant Administrator Only) and [Load Balancer](https://www.twcc.ai/doc?page=load_balancer).
**Bug Fix**
- fix unicode error, [BSS](https://www.twcc.ai/doc?page=volume) & [VCS](https://www.twcc.ai/doc?page=vm) status problems.
### v0.5.13 Release Note
**feature**
- We release a sample AI/ML pipeline task, here. Join us for understand how to use by attending TWCC classes, https://www.nchc.org.tw/Active/ActiveView/414?mid=47&page=1
- Users can create TWCC-VCS with default ubuntu 20.04
- Users can set a specified range of port for secuity group at one time.
- Multi users profile compatible.
**fix bug**
- fix typo error
- fix download error for none-file folder bucket
- `ls ccs -json` shows empty table when ccs empty
### v0.5.12 Release Note
**feature**
- We design TWCC_VCS module for ansible.
**issue**
- We fix #7
**fix bug**
- fix COS command line problems.
### v0.5.11 Release Note
**change**
- In v0.5.10, we use `--product-type` in wrong place, that has been correct.
- We change `cp cos` command structures, new command descriptions as following:
```bash=
> twccli cp cos --help
Usage: twccli cp cos [OPTIONS]
‘Upload/Download’ COS (Cloud Object Storage) files.
Options:
-upload Upload files or folders to the bucket.
-download Download files from the bucket or download the
entire bucket.
-src, --source TEXT Path of the source directory.
-okey, --object-key TEXT File in Cloud.
-fn, --file-name TEXT Files for uploading from local site.
-bkt, --bucket-name TEXT Upload files or folders to the bucket.
--help Show this message and exit.
```
**discuss**
- We are trying to laverage [Ansible](https://www.ansible.com/) for deloying any services.
Do you have any suggestions to this?
Welcome to [leave comments](https://github.com/TW-NCHC/TWCC-CLI/issues/new!!
### v0.5.10 Release Note
**change**
- VCS images showing table shows "product-type" now!
### v0.5.9 Release Note
**change**
- orginal `-itype` in `ls vcs` and `mk vcs` change to using `-ptype` and `--product-type`.
**fix bug**
- error in `rm vcs -secg` and `ls vcs -img` with filtering.
- error in `cp cos -upload` , `cp cos -download` and `rm cos` bucket.
### v0.5.7 Release Note
** We have updated our document in [TWCC-CLI α for v0.5](https://man.twcc.ai/@twccdocs/twcc-cli-v05)
**fix bug**
- fix bugs in COS and data-vol-type while creating VCS.
### v0.5.6 Release Note
**new features**
- You can create additional data volume in `ssd` and `ssd-encrypt` type.
**fix bug**
- upload file source path with slash is not work.
- adding error condition in `rm ccs -s` while entering resource name, and adding `-s` parameter in `ls ccs`.
- fix naming standard to 6-16 in length.
- support customized clone image in CCS.
### v0.5.5 Release Note
**new features**
- snapshot delete functions, `twccli rm vsc -snap -snap-id $SNAPTSHOT_ID`
**fix bug**
- delete bucket and file operation
- upload and download dir to bucket
- remove flag 'noforce' in `twccli rm`
- update listing all snapshots for Project Owner
- `rm vcs` with `-s` flag
### v0.5.4 Release Note
**new features**
- provides encoding setting, `twccli config init --set-bashrc`
**fix bug**
- no data while listing VCS
- can't delete bucket with data recursively
- can't download hierarchy directory to local site
- modify parameter and description in command "CP"
### v0.5.3 Release Note
**new features**
- We add encoding environ setting
- add keypair write and del file
- add private ip and network info while ls vcs
**fix**
- fix create keypair's bug
- fix error in `MANIFEST.in`, remove vcs cos, list vcs, --help description of cos
### v0.5.2 Release Note
**New and structured CLI commands!**
for Mar. 20th ,2020 (v0.5.2)
- Now you can use structured commands`config`, `mk`, `ls`, `rm`, `cp`, and `net` to customize and manage your TWCC Compute and Storage services, including VCS, CCS, and COS.
- In addition to CCS and COS, now you can use TWCC CLI to manage your VCS resources, including VCS instances, security groups, snapshots, as well as keypairs.
- Use commands`-table` or `-json show` to clearly diaplay your resource information in a table view or in JSON.
## Contact us
If you have any questions, please email us at:
- iservice@narlabs.org.tw for account support
- isupport@narlabs.org.tw for technical support
 | 
Raw data
{
"_id": null,
"home_page": "https://github.com/TW-NCHC/TWCC-CLI",
"name": "TWCC-CLI",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "TWS TWCC-CLI Team",
"author_email": "isupport@twcc.ai",
"download_url": "https://files.pythonhosted.org/packages/df/04/e2b92ab31f1e021c063c6a00708880a9cd53add7cb615dfdff195ae37526/TWCC-CLI-0.6.1.tar.gz",
"platform": null,
"description": "###### tags: `twcc`, `twccli`\n\n# TWCC-CLI Project\n\nThe [TWCC, Taiwan Computing Cloud](https://www.twcc.ai) Command Line Interface (CLI) is an environment to create and manage your TWCC services.\n\n[](https://twcc-cli.readthedocs.io/en/latest/?badge=latest)\n\nThe TWCC Command Line Interface (CLI) is an environment to create and manage your TWCC resources. \n\n\n\nIf you have any questions, please email us at: iservice@twcc.ai for account support, and isupport@twcc.ai for technical support\n\n \u2757 \u2757 Always try to upgrade your TWCC-CLI by using `pip3 install -U TWCC-CLI`. \u2757 \u2757 \u2757\n\n\n## :point_down: Release Notes :point_down:\n\n### v0.6.1 Release Note\n\nThe \"We miss you, Viga!\" version\n\n\n\n**Feature**\n- Compatible for Security Group operations.\n\n**Bug Fix**\n- various bugs fixed\n\n### v0.6.0 Release Note\n\n\n\n\n**Feature**\n- New CCS features for you!\n- We sync VCS and CCS solutions and images with User Portal.\n- VDS now can snapshot.\n\n**Bug Fix**\n- fix bug\n\n### v0.5.24.2 Release Note\n\n\n\n**Feature**\n- CLI will remind users while config init when a new version is released.\n\n**Bug Fix**\n- fix bug\n\n### v0.5.24.1 Release Note\n\n\n\n**Bug Fix**\n- fix bug of init\n\n### v0.5.24 Release Note\n\n\n\n**Feature**\n- Remove VCS/CCS you are connecting to by `twccli rm me --no-dry-run`.\n- TWCC-CLI supports more vcs spec feature, according to users' project. Check with `twccli ls vcs -itype ubuntu -ptype`. \n\n**Bug Fix**\n- fix #42\n- fix some bugs\n- fix some error message discriptio\n\n### v0.5.23.2 Release Note\n\n\n\n**Bug Fix**\n- Remove old package\n- Fix bug in ansible scripts\n\n### v0.5.23 Release Note\n\n\n\n**Feature**\n- Users can set Elastic IP(Check more in [@twccdocs/vcs-eip](https://man.twcc.ai/@twccdocs/doc-vcs-main-zh/https%3A%2F%2Fman.twcc.ai%2F%40twccdocs%2Fguide-vcs-eip-zh)) for VCS, by `twccli [ls|mk|rm|ch] eip`\n- Users can import your owned public key, check more in `mk key`\n\n**Bug Fix**\n- fix some bugs\n- fix some error message discription\n\n### v0.5.22 Release Note\n\n\n\n**Bug Fix**\n- fix major bugs\n\n### v0.5.21 Release Note\n\n\n\n**Feature**\n- Users can protect your sites from not expected remove, check out `-keep` while `twcc ch [ccs|vcs]`.\n- Enable VCS reboot, check out `-sts Reboot` while `twccli ch vcs`\n\n**Bug Fix**\n- fix ValueError: APIKEY is not validated, while `config init` , related [#34](https://github.com/twcc/TWCC-CLI/issues/34)\n- fix some bugs\n\n### v0.5.20 Release Note\n\n\n\n**Feature**\n- Users can pass any command to your CCS by using `-cmd` or `--command` right after it right after your CCS ready\n\n**Bug Fix**\n- fix some bugs while using vcs\n\n### v0.5.19 Release Note\n\n\n\n**Feature**\n- Users can use `-ptype` to create customized CCS.\n- Users can transport your credentials to your new resources. You can switch off by providing `-nokey` while `twcc mk [ccs|vcs]`.\n\n**Bug Fix**\n- fix auto migrating bugs\n- fix typo error\n- fix some bugs\n\n### v0.5.18 Release Note\n\n\n**Feature**\n- We support auto-complete for TWCC-CLI :sparkles::sparkles:\n- We support Python 3.9 :sparkles:\n- We enable environment parameters in CCS\n\n**Bug Fix**\n- fix some bugs\n\n### v0.5.17 Release Note\n\n\n**Feature**\n- We add sonarqube for better software quality.\n- VCS `snapshot` be renamed to `custom-image` in TWCC.\n- BSS(block storage service) has been renamed to [VDS(virtual disk service)](https://man.twcc.ai/@twccdocs/r1DhqHdpN) in TWCC.\n- Enable envoronment variables for VCS, check out `twccli mk vcs -h`.\n\n**Bug Fix**\n- fix bug in `mk key`\n- fix bug in `ls -itype`\n- fix exception bug\n- Update AIML Pipeline scripts.\n\n### v0.5.16.2 Release Note\n\n**Feature**\n- Users can create VCS with windows img\n\n**Bug Fix**\n- fix some bugs\n\n### v0.5.16.1 Release Note\n\n**Bug Fix**\n- fix some bugs\n\n### v0.5.16 Release Note\n\n\n\n**Feature**\n- CLI is now collected users operating information by GA. If you don't want to be collect, just keep your `ga_cid` value **EMPTY** in `$HOME/.twcc_data/credential`.\n- Users can turn on/off COS bucket version control feature and create public access URL for specific objects.\n- Users can checkout [HFS](https://man.twcc.ai/@twccdocs/rypYCr_TN) info with CLI\n- Users can list CCS log, and show more information.\n- CLI now can renew your credential file automatically, keep it up-to-date.\n\n**Bug Fix**\n- fix bug in `net vcs`\n\n### v0.5.15 Release Note\n\n\n\n**Feature**\n- BSS(Block Storage Service) is officially renamed as VDS(Virtual Disk Service).\n- Users can list personal resource of VDS & [VLB](https://www.twcc.ai/doc?page=load_balancer).\n- Users can create multi listener over [VLB](https://www.twcc.ai/doc?page=load_balancer).\n- Users can change VCS descrption with `-d`.\n- Users can multiply name their SnapShot wile createing.\n\n**Bug Fix**\n- fix #9\n- fix timezone problem\n- fix error response for snapshot\n\n### v0.5.14 Release Note\n\n\n**Feature**\n\n- Users can operate volumn in [VCS](https://www.twcc.ai/doc?page=vm).\n- We let `-s` support multiple site-id.\n- New progress bar for [COS](https://www.twcc.ai/doc?page=object) operations.\n\n**Preview**\n- Users can operate [Vertual Network](https://www.twcc.ai/doc?page=virtual_network) (Tenant Administrator Only) and [Load Balancer](https://www.twcc.ai/doc?page=load_balancer).\n\n**Bug Fix**\n- fix unicode error, [BSS](https://www.twcc.ai/doc?page=volume) & [VCS](https://www.twcc.ai/doc?page=vm) status problems.\n\n### v0.5.13 Release Note\n\n\n**feature**\n- We release a sample AI/ML pipeline task, here. Join us for understand how to use by attending TWCC classes, https://www.nchc.org.tw/Active/ActiveView/414?mid=47&page=1\n- Users can create TWCC-VCS with default ubuntu 20.04\n- Users can set a specified range of port for secuity group at one time.\n- Multi users profile compatible.\n\n\n**fix bug**\n- fix typo error \n- fix download error for none-file folder bucket\n- `ls ccs -json` shows empty table when ccs empty\n\n### v0.5.12 Release Note\n\n\n**feature**\n- We design TWCC_VCS module for ansible.\n\n\n**issue**\n- We fix #7 \n\n**fix bug**\n- fix COS command line problems.\n\n### v0.5.11 Release Note\n\n\n**change**\n- In v0.5.10, we use `--product-type` in wrong place, that has been correct.\n- We change `cp cos` command structures, new command descriptions as following:\n```bash=\n> twccli cp cos --help\nUsage: twccli cp cos [OPTIONS]\n\n \u2018Upload/Download\u2019 COS (Cloud Object Storage) files.\n\nOptions:\n -upload Upload files or folders to the bucket.\n -download Download files from the bucket or download the\n entire bucket.\n -src, --source TEXT Path of the source directory.\n -okey, --object-key TEXT File in Cloud.\n -fn, --file-name TEXT Files for uploading from local site.\n -bkt, --bucket-name TEXT Upload files or folders to the bucket.\n --help Show this message and exit.\n\n```\n\n**discuss**\n- We are trying to laverage [Ansible](https://www.ansible.com/) for deloying any services. \nDo you have any suggestions to this? \nWelcome to [leave comments](https://github.com/TW-NCHC/TWCC-CLI/issues/new!!\n\n\n \n### v0.5.10 Release Note\n\n\n**change**\n- VCS images showing table shows \"product-type\" now!\n\n### v0.5.9 Release Note\n\n\n\n**change**\n- orginal `-itype` in `ls vcs` and `mk vcs` change to using `-ptype` and `--product-type`.\n\n**fix bug**\n- error in `rm vcs -secg` and `ls vcs -img` with filtering.\n- error in `cp cos -upload` , `cp cos -download` and `rm cos` bucket.\n\n\n### v0.5.7 Release Note\n\n\n\n** We have updated our document in [TWCC-CLI \u03b1 for v0.5](https://man.twcc.ai/@twccdocs/twcc-cli-v05)\n\n\n**fix bug**\n- fix bugs in COS and data-vol-type while creating VCS.\n\n### v0.5.6 Release Note\n\n\n**new features**\n- You can create additional data volume in `ssd` and `ssd-encrypt` type.\n\n**fix bug**\n- upload file source path with slash is not work.\n- adding error condition in `rm ccs -s` while entering resource name, and adding `-s` parameter in `ls ccs`.\n- fix naming standard to 6-16 in length.\n- support customized clone image in CCS.\n\n### v0.5.5 Release Note\n\n\n\n**new features**\n- snapshot delete functions, `twccli rm vsc -snap -snap-id $SNAPTSHOT_ID`\n\n**fix bug**\n- delete bucket and file operation\n- upload and download dir to bucket\n- remove flag 'noforce' in `twccli rm`\n- update listing all snapshots for Project Owner\n- `rm vcs` with `-s` flag\n\n### v0.5.4 Release Note\n\n\n\n**new features**\n- provides encoding setting, `twccli config init --set-bashrc`\n\n**fix bug**\n- no data while listing VCS \n- can't delete bucket with data recursively\n- can't download hierarchy directory to local site \n- modify parameter and description in command \"CP\"\n\n### v0.5.3 Release Note\n\n\n\n**new features**\n- We add encoding environ setting\n- add keypair write and del file\n- add private ip and network info while ls vcs\n\n**fix**\n- fix create keypair's bug\n- fix error in `MANIFEST.in`, remove vcs cos, list vcs, --help description of cos\n\n\n### v0.5.2 Release Note\n**New and structured CLI commands!**\n\nfor Mar. 20th ,2020 (v0.5.2)\n - Now you can use structured commands`config`, `mk`, `ls`, `rm`, `cp`, and `net` to customize and manage your TWCC Compute and Storage services, including VCS, CCS, and COS.\n - In addition to CCS and COS, now you can use TWCC CLI to manage your VCS resources, including VCS instances, security groups, snapshots, as well as keypairs.\n - Use commands`-table` or `-json show` to clearly diaplay your resource information in a table view or in JSON.\n\n\n## Contact us\nIf you have any questions, please email us at: \n- iservice@narlabs.org.tw for account support\n- isupport@narlabs.org.tw for technical support\n\n\n | \n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "TWCC-CLI is a toolkit for operating TWCC resources.",
"version": "0.6.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3dc86f22f812c5496b94a970670c9e1f3c18f0632976f6544cde48e7eae88501",
"md5": "ccdf16591a9ef7abc2176d4f25c5c055",
"sha256": "5a78176b58a71083c1185698c35e7d067ad61c224aec73500ae7e4992875bb9f"
},
"downloads": -1,
"filename": "TWCC_CLI-0.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccdf16591a9ef7abc2176d4f25c5c055",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 98928,
"upload_time": "2023-03-13T10:27:32",
"upload_time_iso_8601": "2023-03-13T10:27:32.951586Z",
"url": "https://files.pythonhosted.org/packages/3d/c8/6f22f812c5496b94a970670c9e1f3c18f0632976f6544cde48e7eae88501/TWCC_CLI-0.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "df04e2b92ab31f1e021c063c6a00708880a9cd53add7cb615dfdff195ae37526",
"md5": "d5ab17dd8f4b4036b6450f0b4926ea3e",
"sha256": "435d2449f5ec50ddc76e90ed16a95aff4208d657c4663cac83192188f463da4c"
},
"downloads": -1,
"filename": "TWCC-CLI-0.6.1.tar.gz",
"has_sig": false,
"md5_digest": "d5ab17dd8f4b4036b6450f0b4926ea3e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 84145,
"upload_time": "2023-03-13T10:27:34",
"upload_time_iso_8601": "2023-03-13T10:27:34.888546Z",
"url": "https://files.pythonhosted.org/packages/df/04/e2b92ab31f1e021c063c6a00708880a9cd53add7cb615dfdff195ae37526/TWCC-CLI-0.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-13 10:27:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "TW-NCHC",
"github_project": "TWCC-CLI",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"circle": true,
"requirements": [],
"tox": true,
"lcname": "twcc-cli"
}
JSON
