{"id":16674090,"url":"https://github.com/melbahja/ron","last_synced_at":"2025-04-09T20:10:19.847Z","repository":{"id":95756771,"uuid":"260955559","full_name":"melbahja/ron","owner":"melbahja","description":"Ron: A simple bash task runner to run any executable file inside a .ron directory or `ron.yaml` file!","archived":false,"fork":false,"pushed_at":"2020-08-28T00:43:57.000Z","size":32,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-23T22:06:49.972Z","etag":null,"topics":["bash","bash-scripting","build-automation","cli","command-line-tool","deployment-automation","go","golang","golang-tools","makefile","ron","task-runner","test-runner"],"latest_commit_sha":null,"homepage":"https://git.io/.ron","language":"Go","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/melbahja.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":"2020-05-03T15:13:56.000Z","updated_at":"2023-05-27T01:36:18.000Z","dependencies_parsed_at":"2023-07-27T01:47:53.545Z","dependency_job_id":null,"html_url":"https://github.com/melbahja/ron","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbahja%2Fron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbahja%2Fron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbahja%2Fron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/melbahja%2Fron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/melbahja","download_url":"https://codeload.github.com/melbahja/ron/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248103871,"owners_count":21048245,"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","bash-scripting","build-automation","cli","command-line-tool","deployment-automation","go","golang","golang-tools","makefile","ron","task-runner","test-runner"],"created_at":"2024-10-12T12:29:17.311Z","updated_at":"2025-04-09T20:10:19.822Z","avatar_url":"https://github.com/melbahja.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\n\t\u003ch1\u003eRon\u003c/h1\u003e\n    \u003ch4 align=\"center\"\u003e\n\t  The simple command line task runner.\n\t\u003c/h4\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e ❘\n    \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e ❘\n    \u003ca href=\"#bash-autocomplete\"\u003eBash Autocomplete\u003c/a\u003e ❘\n    \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\n## Installation\n\nStart by download latest version for your OS:\n```bash\n# Linux\ncurl -fSL https://github.com/melbahja/ron/releases/latest/download/ron_linux -o ron\n\n\n# MacOS\ncurl -fSL https://github.com/melbahja/ron/releases/latest/download/ron_macos -o ron\n\n\n# Windows\ncurl -fSL https://github.com/melbahja/ron/releases/latest/download/ron_windows.exe -o ron.exe\n```\n\nThen make the binary executable and move it to bin path:\n```bash\nchmod +x ron\nsudo mv ron /usr/bin/ron\n```\n\nfor Gophers you can `go get github.com/melbahja/ron`.\n\n## Usage\n\nRon is a very simple task runner that execute any executable file inside a `.ron` directory for example if you have this tree in your project: \n\n```\n.ron/\n├── foo/\n│   ├── .default\n│   ├── bar\n│   └── baz\n├── .default\n└── serve\n```\n\n`.default` file is the default executable for directories.\n\nTo execute `.ron/.default` run:\n```bash\nron\n```\n\nTo execute `.ron/serve` file run:\n```bash\nron serve\n```\n\nTo execute `.ron/foo/.default` run:\n```bash\nron foo\n```\n\nTo execute `.ron/foo/bar` run:\n```bash\nron foo bar\n```\n\nNote: also you can use binary files inside `.ron` directory.\n\nSee Ron's [.ron](https://github.com/melbahja/ron/tree/master/.ron) directory. \n\n## Bash Autocomplete\n\nAdd this to your bash profile (`.bashrc`):\n\n```bash\n_ron_bash_autocomplete() {\n  if [[ \"${COMP_WORDS[0]}\" != \"source\" ]]; then\n    local cur opts base\n    COMPREPLY=()\n    cur=\"${COMP_WORDS[COMP_CWORD]}\"\n    if [[ \"$cur\" == \"-\"* ]]; then\n      opts=$( ${COMP_WORDS[@]:0:$COMP_CWORD} ${cur} --generate-bash-completion )\n    else\n      opts=$( ${COMP_WORDS[@]:0:$COMP_CWORD} --generate-bash-completion )\n    fi\n    COMPREPLY=( $(compgen -W \"${opts}\" -- ${cur}) )\n    return 0\n  fi\n}\n\ncomplete -F _ron_bash_autocomplete ron\n```\n\n## License\n\nRon is provided under the [MIT License](https://github.com/melbahja/ron/blob/master/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelbahja%2Fron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelbahja%2Fron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelbahja%2Fron/lists"}