A collection of small but useful packages that I use in my go applications. I primarily created this collection as a way to learn go as I learn best by solving problems. As a bonus, I've grown to also learn a little bit about how things are implemented at a lower level as I am attempting to implement these packages using just the standard library.
The mail package allows you to create and send emails using a simple API.
go get github.com/mwprogrammer/go-toolkit/mail- Get and configure the email sender with your email server's credentials.
sender := mail.GetSender()
sender.Configure("host", "username", "password", "port")- Create an email message.
message := mail.CreateMessage()
// Add receipients
var receipients = [...]string{"example1@gmail.com", "example1@outlook.com"}
var cc = "example2@gmail.com"
var bcc = "example3@outlook.com"
for _, receipient := range receipients {
message.AddTo(receipient)
}
message.AddCC(cc)
message.AddBCC(bcc)
// Add a subject
message.AddSubject("TEST SIMPLE MESSAGE WITH ATTACHMENTS")
// Add a body. Note you can also add html as well.
message.AddBody("Test sending message with attachments.")
// Add an attachment
err := message.AttachFile("../path/to/file")
if err != nil {
fmt.Println("could not attach file.")
}- Send email.
err = sender.Send(message)The http package seeks to be a clean but configurable http utility library.
go get github.com/mwprogrammer/go-toolkit/http- Make GET requests.
// Add authorization tokens and other custom headers.
headers := make(map[string]string)
headers["Authorization"] = "Bearer token..."
// Send http request.
response, err := http.GET("url", headers)
if err != nil {
fmt.Println(err.Error())
}
// View output if successful.
if response != nil {
fmt.Println(response.StatusCode)
fmt.Println(response.Response)
}- Make POST requests.
// Add authorization tokens and other custom headers.
// Content-type is auto-populated by utility functions like http.JSONBody().
headers := make(map[string]string)
headers["Authorization"] = "Bearer token..."
// Create your request.
type SampleRequest struct {
SampleProperty string `json:"sampleProperty"`
}
request := SampleRequest{SampleProperty: "value"}
// Create your body. You can also create XML, Form bodies etc.
body, err := http.JSONBody(request)
if err != nil {
fmt.Println(err.Error())
}
// Send the request.
response, err := http.POST("url", body, headers)
if err != nil {
fmt.Println(err.Error())
}
// View the output.
if response != nil {
fmt.Println(response.StatusCode)
fmt.Println(response.Response)
}- You can also use other http methods (PUT, DELETE, PATCH...).
- Mail - Had fun learning a bit more about the SMTP protocol.
- Http - Learned a lot about design and extensibility in Go. Loooking forward to expanding it.
- Logging - Simple but crucially important package. Let's go.
- Databases? - I'm trying to implement my own 'mini-orm' in another application and depending on the results of that experiment ... maybe I will add this package. I dunno.
- Jobs? - I recently wrote a windows service successfully in Go. The design for what to externalize into a separate package felt finicky but the experience made me wonder if perhaps I could design a more general package for creating background jobs and the like. Would be my most ambitious package to date.
This is a project I work on primarily for learning purposes.
Sometimes I rewrite entire lines of code when I see something doesn't work in a personal application that I'm dogfooding the packages on or change significant logic that will break changes. For instance; go-toolkit used to be go-utilities which was a large package with different modules for mail etc. Now it is akin to a mono repo of sorts for different much smaller packages.
Use the packages at your own risk. I am not currently accepting contributions. Fork it instead.
On the other hand; I am accepting code reviews and suggestions for what to work on next. If interested, send an email to malawianprogrammer@gmail.com.
Distributed under the MIT license. See LICENSE.md for more details.