{"id":15211173,"url":"https://github.com/vseplet/shelly","last_synced_at":"2025-10-03T18:10:21.829Z","repository":{"id":65860697,"uuid":"594225502","full_name":"vseplet/shelly","owner":"vseplet","description":"Interaction with command line utilities for Deno","archived":false,"fork":false,"pushed_at":"2024-11-13T14:43:16.000Z","size":56,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T04:11:11.802Z","etag":null,"topics":["bash","deno","fish","shell","shell-script","ssh","ts","typescript","zsh"],"latest_commit_sha":null,"homepage":"https://jsr.io/@vseplet/shelly","language":"TypeScript","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/vseplet.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-27T22:29:22.000Z","updated_at":"2024-11-13T14:43:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"14e14df3-04d1-4b36-823b-1a4908b703c9","html_url":"https://github.com/vseplet/shelly","commit_stats":{"total_commits":30,"total_committers":5,"mean_commits":6.0,"dds":0.6,"last_synced_commit":"18dc21f3667389cafe4792a0406eb16d3d6b0eac"},"previous_names":["vseplet/shelly"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vseplet%2Fshelly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vseplet%2Fshelly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vseplet%2Fshelly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vseplet%2Fshelly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vseplet","download_url":"https://codeload.github.com/vseplet/shelly/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238874256,"owners_count":19545145,"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":["bash","deno","fish","shell","shell-script","ssh","ts","typescript","zsh"],"created_at":"2024-09-28T08:20:27.927Z","updated_at":"2025-10-03T18:10:21.731Z","avatar_url":"https://github.com/vseplet.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# shelly\n\n[![JSR](https://jsr.io/badges/@vseplet/shelly)](https://jsr.io/@vseplet/shelly)\n[![JSR Score](https://jsr.io/badges/@vseplet/shelly/score)](https://jsr.io/@vseplet/shelly)\n\n## 👋 👋 ATTENTION!\n\n\u003e This package is under development and will be frequently updated. The author\n\u003e would appreciate any help, advice, and pull requests! Thank you for your\n\u003e understanding 😊\n\nShelly is a module designed for executing commands in TypeScript. The code\nexports a function called [shelly](./source/shelly.ts) which takes in two\narguments: a command as a string or an array of strings and an optional set of\noptions with default values.\n\n---\n\n## Basic Usage:\n\n```ts\nimport { shelly } from \"@vseplet/shelly\";\n\nconst res = await shelly([\"echo\", \"Hello, World!\"]);\nconsole.log(res.stdout);\n// -\u003e Hello, World\n```\n\nThe shelly function uses the Deno runtime to execute the specified command and\ncaptures the output in two separate variables for standard output (stdout) and\nstandard error (stderr). It also catches any errors thrown during the execution\nprocess and stores them in an error variable.\n\n## Shell\n\nTo use Shelly for calling shells, you can use one of the provided shell-specific\nfunctions: sh, zsh, bash, or fish. These functions accept a command string or an\narray of command arguments and options, and then call the shelly function\ninternally with the appropriate shell command and arguments.\n\nFor example, to execute a simple command using the bash shell, you could use the\nfollowing code:\n\n```ts\nimport { bash } from \"@vseplet/shelly\";\n\nconst res = await bash`sleep 10; echo Hello!`;\nconsole.log(res);\n// -\u003e { stderr: \"\", stdout: \"Hello!\\n\", error: null }\n```\n\n### License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvseplet%2Fshelly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvseplet%2Fshelly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvseplet%2Fshelly/lists"}