{"id":19349058,"url":"https://github.com/digineo/sisimai-web","last_synced_at":"2025-04-23T06:30:46.425Z","repository":{"id":40752808,"uuid":"269566810","full_name":"digineo/sisimai-web","owner":"digineo","description":"Microservice to analyze bounce messages","archived":false,"fork":false,"pushed_at":"2025-04-14T16:18:18.000Z","size":68,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-14T17:28:03.923Z","etag":null,"topics":["bounce-handling","bounce-mails","docker","microservice","sinatra-applications","sisimai"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/digineo.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,"zenodo":null}},"created_at":"2020-06-05T07:59:03.000Z","updated_at":"2025-04-14T16:17:41.000Z","dependencies_parsed_at":"2024-03-04T10:47:43.395Z","dependency_job_id":"e528b0db-a074-4f34-b691-daf9301a8615","html_url":"https://github.com/digineo/sisimai-web","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digineo%2Fsisimai-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digineo%2Fsisimai-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digineo%2Fsisimai-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digineo%2Fsisimai-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digineo","download_url":"https://codeload.github.com/digineo/sisimai-web/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250384701,"owners_count":21421779,"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":["bounce-handling","bounce-mails","docker","microservice","sinatra-applications","sisimai"],"created_at":"2024-11-10T04:24:29.863Z","updated_at":"2025-04-23T06:30:46.023Z","avatar_url":"https://github.com/digineo.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sisimai-web\n\nSimple [Sinatra][] web application to inspect bounce emails using [Sisimai][].\n\nWe try to follow the [Sisimai releases][sisimai-releases]. Feel free to\n[open an issue][issues] or create a pull request, should we fall behind.\n\n## Installation from source\n\nDownload the code, install the dependencies and start the server.\n\n```console\n$ git clone https://github.com/digineo/sisimai-web\n$ cd sisimai-web\n$ bundle install\n$ bundle exec rackup --host 127.0.0.1 --port 3000\n```\n\n## Installation with Docker\n\nWe automatically build and push Docker images the project's [container registry][ghcr].\n\n```console\n$ docker pull ghcr.io/digineo/sisimai-web\n$ docker run -d -p 3000:3000 ghcr.io/digineo/sisimai-web\n```\n\n| Image tag | corresponds to |\n|:----------|:---------------|\n| `ghcr.io/digineo/sisimai-web:master`  | latest Git master branch |\n| `ghcr.io/digineo/sisimai-web:4`       | latest Release in the 4.x series |\n| `ghcr.io/digineo/sisimai-web:4.25.15` | a specific release |\n| `ghcr.io/digineo/sisimai-web:latest`  | the latest build from the above |\n\nNote: You might find earlier versions on the Docker Hub, as `digineode/sisimai-web`;\nthese releases are now deprecated and unsupported. Expect the Docker Hub repository\nto vanish in the near future.\n\n## Usage\n\nAfter starting the application, the (API only) endpoint becomes available\nat http://localhost:3000/.\n\nHave a bounce mail:\n\n```console\n$ head -5 message.eml\nReceived: by m.sender.com (Postfix)\n\tid 7A3371230; Sun, 22 Jan 2012 22:17:05 -0800 (PST)\nDate: Sun, 22 Jan 2012 22:17:05 -0800 (PST)\nFrom: MAILER-DAEMON@sender.com (Mail Delivery System)\nSubject: Undelivered Mail Returned to Sender\n```\n\n... and POST it to the endpoint:\n\n```\n$ curl -sXPOST --data-binary @message.eml http://localhost:3000/ | \\\n  jq 'with_entries(select(.key == (\"action\",\"reason\",\"softbounce\")))'\n{\n  \"action\": \"failed\",\n  \"reason\": \"userunknown\",\n  \"softbounce\": 0\n}\n```\n\n## Credits\n\n[Sisimai][] is an excellent bounce mail parser library by [azumakuniyuki][].\n\nThe test messages for the test suite were extracted from\n[emiles-go-bounce-parser][].\n\n## License\n\nCopyright (c) 2020, Dominik Menke, Digineo GmbH\n\nMIT, see [LICENSE](./LICENSE) for details.\n\n[Sinatra]: http://sinatrarb.com\n[Sisimai]: https://libsisimai.org\n[sisimai-releases]: https://rubygems.org/gems/sisimai/versions\n[issues]: https://github.com/digineo/sisimai-web/issues\n[ghcr]: https://github.com/digineo/sisimai-web/packages/\n[azumakuniyuki]: https://github.com/azumakuniyuki\n[emiles-go-bounce-parser]: https://github.com/e-miles/emiles-go-bounce-parser/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigineo%2Fsisimai-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigineo%2Fsisimai-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigineo%2Fsisimai-web/lists"}