{"id":20252978,"url":"https://github.com/torus-tools/cli","last_synced_at":"2025-07-25T13:33:49.473Z","repository":{"id":42835076,"uuid":"262424347","full_name":"torus-tools/cli","owner":"torus-tools","description":"An easy to full feature command line interface for Torus Tools.  Made with OCLIF","archived":false,"fork":false,"pushed_at":"2023-01-06T14:31:05.000Z","size":74253,"stargazers_count":5,"open_issues_count":61,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T20:12:06.231Z","etag":null,"topics":["babel","cli","css","es2020","html","javascript","livereload","nodejs","npm","sass","static-site","webpack"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/torus-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-08T20:40:53.000Z","updated_at":"2022-06-07T21:57:37.000Z","dependencies_parsed_at":"2023-02-06T05:16:08.128Z","dependency_job_id":null,"html_url":"https://github.com/torus-tools/cli","commit_stats":null,"previous_names":["arjan-tools/cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/torus-tools","download_url":"https://codeload.github.com/torus-tools/cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248313566,"owners_count":21082878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["babel","cli","css","es2020","html","javascript","livereload","nodejs","npm","sass","static-site","webpack"],"created_at":"2024-11-14T10:20:29.526Z","updated_at":"2025-04-10T23:24:49.172Z","avatar_url":"https://github.com/torus-tools.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Torus CLI\n========\n\nMutli CLI for torus tools\n\n[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)\n[![Version](https://img.shields.io/npm/v/toruscli.svg)](https://npmjs.org/package/toruscli)\n[![Downloads/week](https://img.shields.io/npm/dw/@torus-tools/cli.svg)](https://npmjs.org/package/@torus-tools/cli)\n[![License](https://img.shields.io/npm/l/@torus-tools/cli.svg)](https://github.com/torus-tools/cli/blob/master/package.json)\n\n\u003c!-- toc --\u003e\n* [Usage](#usage)\n* [Commands](#commands)\n\u003c!-- tocstop --\u003e\n# Usage\n\u003c!-- usage --\u003e\n```sh-session\n$ npm install -g @torus-tools/cli\n$ torus COMMAND\nrunning command...\n$ torus (-v|--version|version)\n@torus-tools/cli/0.0.124 linux-x64 node-v14.4.0\n$ torus --help [COMMAND]\nUSAGE\n  $ torus COMMAND\n...\n```\n\u003c!-- usagestop --\u003e\n# Commands\n\u003c!-- commands --\u003e\n* [`torus content ACTION [FILES]`](#torus-content-action-files)\n* [`torus help [COMMAND]`](#torus-help-command)\n* [`torus init`](#torus-init)\n* [`torus stack ACTION [SETUP]`](#torus-stack-action-setup)\n\n## `torus content ACTION [FILES]`\n\nList/download/upload/delete all of your content (or the specified files).\n\n```\nUSAGE\n  $ torus content ACTION [FILES]\n\nARGUMENTS\n  ACTION  (list|download|upload|delete) given action to carry out with the content of your site\n\n  FILES   local paths or object keys of the files/directories you want to upload/download to/from your bucket. For\n          example suppose theres a directory img inside the cwd the path of image1.jpg would be img/image1.jpg. For\n          local files the root is the current working directory unless specifiecd otherwise with the -i flag. By\n          default, if no paths are provided all files/dirs in the root will be used.\n\nOPTIONS\n  -a, --all            Upload all files. By default only updated files are uploaded.\n  -d, --domain=domain  Domain of your site (i.e. yoursite.com).\n  -i, --input=input    Path of the root directory of your project (if different to the current working driectory).\n  -o, --output=output  [default: ./] Path to save downloaded content into. Default is the current working directory.\n  -r, --reset          Reset the cache in all edge locations for the given files.\n  -s, --sort           Sorts listed files by last modified date.\n\nDESCRIPTION\n  ...\n  By default only modified files are uploaded; to upload all files provide the --all flag. To automatically update cache \n  in cloudfront for the given files add the --reset flag.\n```\n\n_See code: [src/commands/content.js](https://github.com/torus-tools/cli/blob/v0.0.124/src/commands/content.js)_\n\n## `torus help [COMMAND]`\n\ndisplay help for torus\n\n```\nUSAGE\n  $ torus help [COMMAND]\n\nARGUMENTS\n  COMMAND  command to show help for\n\nOPTIONS\n  --all  see all commands in CLI\n```\n\n_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v3.2.0/src/commands/help.ts)_\n\n## `torus init`\n\nConfigure torus globally in your machine, or on a per-project basis\n\n```\nUSAGE\n  $ torus init\n\nOPTIONS\n  -d, --domain=domain\n      The valid desired/existing domain of your site i.e. yoursite.com\n\n  -g, --global\n      Create a global torus configuration file. The command will guide you through the steps to generate the required API \n      keys for each of your desired providers, set up your global environment variables and your deisred default settings.\n\n  -p, --providers=aws|godaddy\n      Desired cloud/domain providers to be used with torus. You must have an existing account in all of the providers you \n      choose.\n\n  -r, \n  --region=us-east-2|us-east-1|us-west-1|us-west-2|af-south-1|ap-east-1|ap-south-1|ap-northeast-2|ap-southeast-1|ap-sout\n  heast-2|ap-northeast-1|ca-central-1|cn-north-1|cn-northwest-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1|me\n  -south-1|sa-east-1|us-gov-east-1|us-gov-west-1\n      [default: us-east-1] Desired AWS region\n\n  -u, --user=user\n      [default: torus_admin] Desired name for the AWS IAM user\n\nDESCRIPTION\n  ...\n  The init command helps you configure torus in your site/project. Providing the -g (--global) flag helps you configure \n  torus globally (for all of your projects). When using the torus CLI, you can always overwrite global settings by \n  including a project config file. You can also overwrite global environment variables by including a .env file. If you \n  are using the init command without the -g flag make sure to run it from the root of your project.\n```\n\n_See code: [src/commands/init.js](https://github.com/torus-tools/cli/blob/v0.0.124/src/commands/init.js)_\n\n## `torus stack ACTION [SETUP]`\n\nDeploy static sites to AWS\n\n```\nUSAGE\n  $ torus stack ACTION [SETUP]\n\nARGUMENTS\n  ACTION  (create|update|import|delete|pull|push) choose an action to perform. you can create, update, import your stack\n          or upload files to your bucket.\n\n  SETUP   (dev|test|prod|custom) [default: dev] setup for the site - dev, test, production or custom\n\nOPTIONS\n  -b, --bucket=aws|true                   Enables a cloud storage bucket to be used as the websites origin. You can\n                                          provide this flag without the =string to use aws s3.\n\n  -c, --cdn=aws|true                      Add a CDN to your site. CDNs enable faster website load times by caching your\n                                          content around the globe (the edge). You can provide this flag without the\n                                          =string to use aws Cloudfront.\n\n  -d, --domain=domain                     The domain of your site i.e. yoursite.com\n\n  -e, --error=error                       name of the error document. Default is error.html\n\n  -i, --index=index                       name of the index document. Default is index.html\n\n  -o, --overwrite                         By default, torus always reads your template in the cloud and only adds\n                                          changes (updated resources or additional resources). If you want to eliminate\n                                          the resources that arent prvoided in the CLI flags you can add this flag.\n\n  -p, --publish                           Publish the sites content\n\n  -r, --registrar=aws|godaddy|other|true  The current domain name registrar of your sites domain. Using AWS or godaddy\n                                          enables automatic namserver updates if the DNS provider is different to the\n                                          registrar. Selecting other will require manual nameserver updates. true\n                                          evaluates to other.\n\n  -s, --ssl=aws|true                      Enables https by creating and validating an SSL certificate for your site. You\n                                          can provide this flag without the =string to use aws certificate manager.\n\n  -w, --www=true                          creates a www reroute bucket.\n\n  --dns=aws|godaddy|other|true            Desired DNS provider for your site. The aws option adds a route53 hosted zone\n                                          to your stack. You can provide this flag without the =string to use aws.\n\nDESCRIPTION\n  ...\n  Deploy static sites to the AWS Cloud using Cloudformation templates.\n```\n\n_See code: [src/commands/stack.js](https://github.com/torus-tools/cli/blob/v0.0.124/src/commands/stack.js)_\n\u003c!-- commandsstop --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorus-tools%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorus-tools%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorus-tools%2Fcli/lists"}