{"id":13509187,"url":"https://github.com/navinpeiris/ex_unit_notifier","last_synced_at":"2025-04-04T21:08:56.211Z","repository":{"id":48597156,"uuid":"54632113","full_name":"navinpeiris/ex_unit_notifier","owner":"navinpeiris","description":"Desktop notifications for ExUnit","archived":false,"fork":false,"pushed_at":"2024-08-13T16:24:27.000Z","size":322,"stargazers_count":132,"open_issues_count":7,"forks_count":18,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T20:07:27.371Z","etag":null,"topics":["desktop-notifications","elixir","exunit","notifications"],"latest_commit_sha":null,"homepage":"","language":"Elixir","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/navinpeiris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2016-03-24T09:58:30.000Z","updated_at":"2025-03-24T10:06:54.000Z","dependencies_parsed_at":"2024-12-06T13:32:23.667Z","dependency_job_id":null,"html_url":"https://github.com/navinpeiris/ex_unit_notifier","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/navinpeiris%2Fex_unit_notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/navinpeiris%2Fex_unit_notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/navinpeiris%2Fex_unit_notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/navinpeiris%2Fex_unit_notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/navinpeiris","download_url":"https://codeload.github.com/navinpeiris/ex_unit_notifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249527,"owners_count":20908212,"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":["desktop-notifications","elixir","exunit","notifications"],"created_at":"2024-08-01T02:01:04.262Z","updated_at":"2025-04-04T21:08:56.182Z","avatar_url":"https://github.com/navinpeiris.png","language":"Elixir","funding_links":[],"categories":["Testing"],"sub_categories":[],"readme":"# ExUnit Notifier\n\n[![Build Status](https://github.com/navinpeiris/ex_unit_notifier/workflows/CI/badge.svg)](https://github.com/navinpeiris/ex_unit_notifier/actions?query=workflow%3ACI)\n[![Hex version](https://img.shields.io/hexpm/v/ex_unit_notifier.svg \"Hex version\")](https://hex.pm/packages/ex_unit_notifier)\n[![Hex docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/ex_unit_notifier/)\n[![Hex downloads](https://img.shields.io/hexpm/dt/ex_unit_notifier.svg \"Hex downloads\")](https://hex.pm/packages/ex_unit_notifier)\n[![License](http://img.shields.io/:license-mit-blue.svg)](http://doge.mit-license.org)\n[![Last Updated](https://img.shields.io/github/last-commit/navinpeiris/ex_unit_notifier.svg)](https://github.com/navinpeiris/ex_unit_notifier/commits/master)\n\n![screenshot](http://i.imgur.com/xywj5C1.png)\n\nShow desktop notifications for ExUnit runs. Works very well with automatic test runners such as [mix-test.watch](https://github.com/lpil/mix-test.watch). (Yes, TDD is awesome!)\n\nCurrently notifications on OS X and Linux are supported.\n\n## Installation\n\nFirst, add `ExUnitNotifier` to your `mix.exs` dependencies:\n\n```elixir\ndef deps do\n  [\n    {:ex_unit_notifier, \"~\u003e 1.3\", only: :test}\n  ]\nend\n```\n\nThen, update your dependencies:\n\n```bash\n$ mix deps.get\n```\n\n### For macOS\n\nFollow [installation instruction](https://github.com/julienXX/terminal-notifier) of `terminal-notifier` if you need to install a particular version.\n\nOtherwise, install current version via Homebrew:\n\n```bash\n$ brew install terminal-notifier\n```\n\n### For GNU/Linux\n\nInstall `notify-send`:\n\n```bash\n$ sudo apt install libnotify-bin\n```\n\n## Usage\n\nAdd `ExUnitNotifier` to your `ExUnit` configuration in `test/test_helper.exs` file.\n\n```elixir\nExUnit.configure formatters: [ExUnit.CLIFormatter, ExUnitNotifier]\nExUnit.start\n```\n\nNow run `mix test` and you'll see notifications popping up :)\n\n## Notification Types\n\nNotifications will be sent from the first available notifier that is deemed available in the order specified below:\n\n- terminal-notifier (ExUnitNotifier.Notifiers.TerminalNotifier)\n- notify-send (ExUnitNotifier.Notifiers.NotifySend)\n- tmux (ExUnitNotifier.Notifiers.TmuxNotifier)\n- Terminal Title if non of the above match (ExUnitNotifier.Notifiers.TerminalTitle)\n\nTo force a specific type of notifier to be used, specify the notifier using the following configuration:\n\n```elixir\nconfig :ex_unit_notifier, notifier: ExUnitNotifier.Notifiers.TerminalNotifier\n```\n\nYou can use one of the available notifiers found in [lib/ex_unit_notifier/notifiers](lib/ex_unit_notifier/notifiers), or you can write your own.\n\n## Notification Options\n\nFor `notify-send` users, it is possible to clear the notifications from notifications center history using the following configuration, defaults to `false`:\n\n```elixir\nconfig :ex_unit_notifier, clear_history: true\n```\n\n### Copyright and License\n\nCopyright (c) 2016 Navin Peiris\n\nSource code is released under [the MIT license](./LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnavinpeiris%2Fex_unit_notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnavinpeiris%2Fex_unit_notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnavinpeiris%2Fex_unit_notifier/lists"}