{"id":16828083,"url":"https://github.com/kataras/rizla","last_synced_at":"2026-03-07T08:02:38.002Z","repository":{"id":37458518,"uuid":"61924870","full_name":"kataras/rizla","owner":"kataras","description":":eyes: Rizla builds, runs and monitors your Go Applications with ease. See https://github.com/kataras/iris-cli for Iris users.","archived":false,"fork":false,"pushed_at":"2020-08-08T16:04:30.000Z","size":816,"stargazers_count":191,"open_issues_count":9,"forks_count":17,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-08-13T15:59:57.419Z","etag":null,"topics":["application-monitoring","go","hot-reload"],"latest_commit_sha":null,"homepage":"","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/kataras.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","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":"2016-06-25T03:19:47.000Z","updated_at":"2025-05-14T08:20:54.000Z","dependencies_parsed_at":"2022-07-15T21:30:47.749Z","dependency_job_id":null,"html_url":"https://github.com/kataras/rizla","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kataras/rizla","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kataras%2Frizla","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kataras%2Frizla/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kataras%2Frizla/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kataras%2Frizla/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kataras","download_url":"https://codeload.github.com/kataras/rizla/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kataras%2Frizla/sbom","scorecard":{"id":551510,"data":{"date":"2025-08-11","repo":{"name":"github.com/kataras/rizla","commit":"c38afc3d0c4475303cb36aa040e4c42b3a0d94b3"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 2/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'","Warn: branch protection not enabled for branch '0.0.6'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 3 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T11:00:12.829Z","repository_id":37458518,"created_at":"2025-08-20T11:00:12.829Z","updated_at":"2025-08-20T11:00:12.829Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30209796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T05:23:27.321Z","status":"ssl_error","status_checked_at":"2026-03-07T05:00:17.256Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["application-monitoring","go","hot-reload"],"created_at":"2024-10-13T11:24:35.353Z","updated_at":"2026-03-07T08:02:37.980Z","avatar_url":"https://github.com/kataras.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Rizla builds, runs and monitors your Go Applications with ease.\n\n[![Travis Widget]][Travis] [![Release Widget]][Release] [![Report Widget]][Report] [![License Widget]][License] [![Chat Widget]][Chat]\n\nInstallation\n------------\nThe only requirement is the [Go Programming Language](https://golang.org/dl), at least 1.7.\n\n```sh\n$ go get -u github.com/kataras/rizla\n```\n\n\n# Getting Started\n\n```bash\n$ rizla main.go #single project monitoring\n$ rizla C:/myprojects/project1/main.go C:/myprojects/project2/main.go #multi projects monitoring\n$ rizla -walk main.go #prepend '-walk' only when the default file changes scanning method doesn't works for you.\n$ rizla -delay=5s main.go # if delay \u003e 0 then it delays the reload, also note that it accepts the first change but the rest of changes every \"delay\".\n```\n\nWant to use it from your project's source code? easy\n\n```sh\n$ cat from_code_simple.go\n```\n\n```go\npackage main\n\nimport (\n    \"github.com/kataras/rizla/rizla\"\n)\n\nfunc main() {\n  // Build, run \u0026 start monitoring the projects\n  rizla.Run(\"C:/iris-project/main.go\", \"C:/otherproject/main.go\")\n  // watcher, _ := rizla.WatcherFromFlag(\"-walk\")\n  // rizla.RunWith(watcher, \"./main.go\", 0)\n}\n```\n\n```sh\n$ cat from_code_pro.go\n```\n```go\npackage main\n\nimport (\n    \"path/filepath\"\n    \"runtime\"\n    \"time\"\n    \"os\"\n\n    \"github.com/kataras/rizla/rizla\"\n)\n\nfunc main() {\n  // Create a new project by the main source file\n  project := rizla.NewProject(\"C:/myproject/main.go\")\n\n  // The below are optional\n\n  // Optionally, change the out for info logs and error messages.\n  project.Out.SetOutput(os.Stdout)\n  project.Err.SetOutput(os.Stderr)\n\n  project.Name = \"My super project\"\n  // Allow reload every 3 seconds or more no less\n  project.AllowReloadAfter = time.Duration(3) * time.Second\n  // Custom subdirectory matcher, for the watcher, return true to include this folder to the watcher\n  // the default is:\n  project.Watcher = func(absolutePath string) bool {\n        base := filepath.Base(abs)\n        return !(base == \".git\" || base == \"node_modules\" || base == \"vendor\")\n  }\n  // Custom file matcher on runtime (file change), return true to reload when a file with this file name changed\n  // the default is:\n  project.Matcher = func(filename string) bool {\n        isWindows = runtime.GOOS == \"windows\"\n        goExt     = \".go\"\n        return (filepath.Ext(fullname) == goExt) ||\n        (!isWindows \u0026\u0026 strings.Contains(fullname, goExt))\n  }\n  // Add arguments, these will be used from the executable file\n  project.Args = []string{\"-myargument\",\"the value\",\"-otherargument\",\"a value\"}\n  // Custom callback before reload, the default is:\n  project.OnReload = func(string) {\n        fromproject := \"\"\n        if p.Name != \"\" {\n            fromproject = \"From project '\" + project.Name + \"': \"\n        }\n        project.Out.Infof(\"%sA change has been detected, reloading now...\", fromproject)\n   }\n   // Custom callback after reload, the default is:\n   project.OnReloaded = func(string) {\n        \n   }\n\n  // End of optional\n\n  // Add the project to the rizla container\n  rizla.Add(project)\n  //  Build, run \u0026 start monitoring the project(s)\n  rizla.Run(nil)\n}\n```\n\n\u003e That's all!\n\nFAQ\n------------\nAsk questions and get real-time answers from the [Chat][CHAT].\n\nFeatures\n------------\n- Super easy - is created for everyone.\n- You can use it either as command line tool either as part of your project's source code!\n- Multi-Monitoring - Supports monitoring of unlimited projects.\n- Rizla, by-default, uses the operating system's signals to fire a change because it is the fastest way and it consumes the minimal CPU.\n   - You 're still able to change the watcher to use the `filepath.Walk` too with `-walk` flag.\n- delay reload on detect change with `-delay`\n\nPeople\n\n------------\nIf you'd like to discuss this package, or ask questions about it, feel free to [Chat][CHAT].\n\nThe author of rizla is [@kataras](https://github.com/kataras).\n\nVersioning\n------------\n\nCurrent: **v0.1.1**\n\n[HISTORY](https://github.com/kataras/rizla/blob/master/HISTORY.md) file is your best friend!\n\nRead more about Semantic Versioning 2.0.0\n\n - http://semver.org/\n - https://en.wikipedia.org/wiki/Software_versioning\n - https://wiki.debian.org/UpstreamGuide#Releases_and_Versions\n\nTodo\n------------\n\n- [ ] Tests\n- [ ] Provide full examples.\n\nThird-Party Licenses\n------------\n\nThird-Party Licenses can be found [here](THIRDPARTY-LICENSE)\n\nLicense\n------------\n\nThis project is licensed under the MIT License.\n\nLicense can be found [here](LICENSE).\n\n[Travis Widget]: https://img.shields.io/travis/kataras/rizla.svg?style=flat-square\n[Travis]: http://travis-ci.org/kataras/rizla\n[License Widget]: https://img.shields.io/badge/license-MIT%20%20License%20-E91E63.svg?style=flat-square\n[License]: https://github.com/kataras/rizla/blob/master/LICENSE\n[Release Widget]: https://img.shields.io/badge/release-v0.1.1-blue.svg?style=flat-square\n[Release]: https://github.com/kataras/rizla/releases\n[Chat Widget]: https://img.shields.io/badge/community-chat-00BCD4.svg?style=flat-square\n[Chat]: https://kataras.rocket.chat/channel/rizla\n[ChatMain]: https://kataras.rocket.chat/channel/rizla\n[ChatAlternative]: https://gitter.im/kataras/rizla\n[Report Widget]: https://img.shields.io/badge/report%20card-A%2B-F44336.svg?style=flat-square\n[Report]: http://goreportcard.com/report/kataras/rizla\n[Language Widget]: https://img.shields.io/badge/powered_by-Go-3362c2.svg?style=flat-square\n[Language]: http://golang.org\n[Platform Widget]: https://img.shields.io/badge/platform-Any--OS-gray.svg?style=flat-square\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkataras%2Frizla","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkataras%2Frizla","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkataras%2Frizla/lists"}