{"id":13600633,"url":"https://github.com/mrz1836/go-mail","last_synced_at":"2025-03-17T01:31:48.374Z","repository":{"id":39879249,"uuid":"214665131","full_name":"mrz1836/go-mail","owner":"mrz1836","description":":incoming_envelope: Simple email interface across multiple service providers (ses, postmark, mandrill, smtp)","archived":false,"fork":false,"pushed_at":"2025-03-14T16:34:56.000Z","size":516,"stargazers_count":42,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-14T17:33:31.941Z","etag":null,"topics":["aws","email","go","gomodule","mail","mandrill","postmark","ses","smtp"],"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/mrz1836.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mrz1836","custom":"https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=go-mail\u0026utm_term=go-mail\u0026utm_content=go-mail"}},"created_at":"2019-10-12T14:55:53.000Z","updated_at":"2025-03-14T16:34:53.000Z","dependencies_parsed_at":"2024-01-02T11:29:27.971Z","dependency_job_id":"4f131494-2c02-4bc0-b5ab-44c40a49dc0d","html_url":"https://github.com/mrz1836/go-mail","commit_stats":null,"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fgo-mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fgo-mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fgo-mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrz1836%2Fgo-mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrz1836","download_url":"https://codeload.github.com/mrz1836/go-mail/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243836015,"owners_count":20355615,"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":["aws","email","go","gomodule","mail","mandrill","postmark","ses","smtp"],"created_at":"2024-08-01T18:00:45.438Z","updated_at":"2025-03-17T01:31:47.818Z","avatar_url":"https://github.com/mrz1836.png","language":"Go","funding_links":["https://github.com/sponsors/mrz1836","https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=go-mail\u0026utm_term=go-mail\u0026utm_content=go-mail"],"categories":["Go"],"sub_categories":[],"readme":"# go-mail\n\u003e Lightweight email package with multi-provider support ([ses](https://aws.amazon.com/ses/), [mandrill](https://mailchimp.com/features/transactional-email/), [postmark](https://postmarkapp.com/))\n\n[![Release](https://img.shields.io/github/release-pre/mrz1836/go-mail.svg?logo=github\u0026style=flat\u0026v=1)](https://github.com/mrz1836/go-mail/releases)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/mrz1836/go-mail/run-tests.yml?branch=master\u0026logo=github\u0026v=3)](https://github.com/mrz1836/go-mail/actions)\n[![Report](https://goreportcard.com/badge/github.com/mrz1836/go-mail?style=flat\u0026v=1)](https://goreportcard.com/report/github.com/mrz1836/go-mail)\n[![codecov](https://codecov.io/gh/mrz1836/go-mail/branch/master/graph/badge.svg)](https://codecov.io/gh/mrz1836/go-mail)\n[![Go](https://img.shields.io/github/go-mod/go-version/mrz1836/go-mail)](https://golang.org/)\n\u003cbr\u003e\n[![Mergify Status](https://img.shields.io/endpoint.svg?url=https://api.mergify.com/v1/badges/mrz1836/go-mail\u0026style=flat\u0026v=1)](https://mergify.io)\n[![Sponsor](https://img.shields.io/badge/sponsor-MrZ-181717.svg?logo=github\u0026style=flat\u0026v=3)](https://github.com/sponsors/mrz1836)\n[![Donate](https://img.shields.io/badge/donate-bitcoin-ff9900.svg?logo=bitcoin\u0026style=flat)](https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=go-mail\u0026utm_term=go-mail\u0026utm_content=go-mail)\n\n\u003cbr/\u003e\n\n## Table of Contents\n- [Installation](#installation)\n- [Documentation](#documentation)\n- [Examples \u0026 Tests](#examples--tests)\n- [Benchmarks](#benchmarks)\n- [Code Standards](#code-standards)\n- [Usage](#usage)\n- [Maintainers](#maintainers)\n- [Contributing](#contributing)\n- [License](#license)\n\n\u003cbr/\u003e\n\n## Installation\n\n**go-mail** requires a [supported release of Go](https://golang.org/doc/devel/release.html#policy).\n```shell script\ngo get -u github.com/mrz1836/go-mail\n```\n\n\u003cbr/\u003e\n\n## Documentation\nView the generated [documentation](https://pkg.go.dev/github.com/mrz1836/go-mail)\n\n[![GoDoc](https://godoc.org/github.com/mrz1836/go-mail?status.svg\u0026style=flat)](https://pkg.go.dev/github.com/mrz1836/go-mail)\n\n### Features\n- Supports multiple service providers _(below)_\n- Support basic [SMTP](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol)\n- Plain-text and HTML content\n- Multiple file attachments\n- Open \u0026 click tracking _(provider dependant)_\n- Inject css into html content\n- Basic template support\n- Max restrictions on `To`, `CC` and `BCC`\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eSupported Service Providers\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n- [AWS SES](https://docs.aws.amazon.com/ses/)\n- [Mandrill](https://mandrillapp.com/api/docs/)\n- [Postmark](https://postmarkapp.com/developer)\n- [SMTP](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003ePackage Dependencies\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n- domodwyer's [mailyak](https://github.com/domodwyer/mailyak)\n- keighl's [postmark](https://github.com/mrz1836/postmark)\n- mattbaird's [gochimp](https://github.com/mattbaird/gochimp)\n- mrz's [go-ses](https://github.com/mrz1836/go-ses)\n- aymerick's [douceur](https://github.com/aymerick/douceur)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eLibrary Deployment\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n[goreleaser](https://github.com/goreleaser/goreleaser) for easy binary or library deployment to GitHub and can be installed via: `brew install goreleaser`.\n\nThe [.goreleaser.yml](.goreleaser.yml) file is used to configure [goreleaser](https://github.com/goreleaser/goreleaser).\n\nUse `make release-snap` to create a snapshot version of the release, and finally `make release` to ship to production.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e\u003ccode\u003eMakefile Commands\u003c/code\u003e\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\nView all `makefile` commands\n```shell script\nmake help\n```\n\nList of all current commands:\n```text\nall                  Runs multiple commands\nclean                Remove previous builds and any test cache data\nclean-mods           Remove all the Go mod cache\ncoverage             Shows the test coverage\ndiff                 Show the git diff\ngenerate             Runs the go generate command in the base of the repo\ngodocs               Sync the latest tag with GoDocs\nhelp                 Show this help message\ninstall              Install the application\ninstall-go           Install the application (Using Native Go)\nlint                 Run the golangci-lint application (install if not found)\nrelease              Full production release (creates release in Github)\nrelease              Runs common.release then runs godocs\nrelease-snap         Test the full release (build binaries)\nrelease-test         Full production test release (everything except deploy)\nreplace-version      Replaces the version in HTML/JS (pre-deploy)\nrun-examples         Runs all the examples\ntag                  Generate a new tag and push (tag version=0.0.0)\ntag-remove           Remove a tag if found (tag-remove version=0.0.0)\ntag-update           Update an existing tag to current commit (tag-update version=0.0.0)\ntest                 Runs lint and ALL tests\ntest-ci              Runs all tests via CI (exports coverage)\ntest-ci-no-race      Runs all tests via CI (no race) (exports coverage)\ntest-ci-short        Runs unit tests via CI (exports coverage)\ntest-no-lint         Runs just tests\ntest-short           Runs vet, lint and tests (excludes integration tests)\ntest-unit            Runs tests and outputs coverage\nuninstall            Uninstall the application (and remove files)\nupdate-linter        Update the golangci-lint package (macOS only)\nvet                  Run the Go vet application\n```\n\u003c/details\u003e\n\n\u003cbr/\u003e\n\n## Examples \u0026 Tests\nAll unit tests and [examples](examples) run via [GitHub Actions](https://github.com/mrz1836/go-mail/actions) and\nuses [Go version 1.19.x](https://golang.org/doc/go1.19). View the [configuration file](.github/workflows/run-tests.yml).\n\nRun all tests (including integration tests)\n```shell script\nmake test\n```\n\nRun tests (excluding integration tests)\n```shell script\nmake test-short\n```\n\nRun the examples:\n```shell script\nmake run-examples\n```\n\n\u003cbr/\u003e\n\n## Benchmarks\nRun the Go benchmarks:\n```shell script\nmake bench\n```\n\n\u003cbr/\u003e\n\n## Code Standards\nRead more about this Go project's [code standards](.github/CODE_STANDARDS.md).\n\n\u003cbr/\u003e\n\n## Usage\nView the [examples](examples/examples.go)\n\n\u003cbr/\u003e\n\n## Maintainers\n| [\u003cimg src=\"https://github.com/mrz1836.png\" height=\"50\" alt=\"MrZ\" /\u003e](https://github.com/mrz1836) |\n|:------------------------------------------------------------------------------------------------:|\n|                                [MrZ](https://github.com/mrz1836)                                 |\n\n\u003cbr/\u003e\n\n## Contributing\n\nView the [contributing guidelines](.github/CONTRIBUTING.md) and follow the [code of conduct](.github/CODE_OF_CONDUCT.md).\n\n### How can I help?\nAll kinds of contributions are welcome :raised_hands:! \nThe most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:. \nYou can also support this project by [becoming a sponsor on GitHub](https://github.com/sponsors/mrz1836) :clap: \nor by making a [**bitcoin donation**](https://mrz1818.com/?tab=tips\u0026utm_source=github\u0026utm_medium=sponsor-link\u0026utm_campaign=go-mail\u0026utm_term=go-mail\u0026utm_content=go-mail) to ensure this journey continues indefinitely! :rocket:\n\n[![Stars](https://img.shields.io/github/stars/mrz1836/go-mail?label=Please%20like%20us\u0026style=social)](https://github.com/mrz1836/go-mail/stargazers)\n\n\u003cbr/\u003e\n\n## License\n\n[![License](https://img.shields.io/github/license/mrz1836/go-mail.svg?style=flat\u0026v=1)](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrz1836%2Fgo-mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrz1836%2Fgo-mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrz1836%2Fgo-mail/lists"}