mirror of
https://github.com/nabbar/golib.git
synced 2025-12-24 11:51:02 +08:00
25c3c8c45b
[root] - UPDATE documentation: enhanced README and TESTING guidelines - UPDATE dependencies: bump dependencies [config/components] - UPDATE mail component: apply update following changes in related package - UPDATE smtp component: apply update following changes in related package [mail] - MAJOR REFACTORING - REFACTOR package structure: reorganized into 4 specialized subpackages (queuer, render, sender, smtp) - ADD mail/queuer: mail queue management with counter, monitoring, and comprehensive tests - ADD mail/render: email template rendering with themes and direction handling (moved from mailer package) - ADD mail/sender: email composition and sending with attachments, priorities, and encoding - ADD mail/smtp: SMTP protocol handling with TLS modes and DSN support - ADD documentation: comprehensive README and TESTING for all subpackages - ADD tests: complete test suites with benchmarks, concurrency, and edge cases for all subpackages [mailer] - DEPRECATED - DELETE package: entire package merged into mail/render [mailPooler] - DEPRECATED - DELETE package: entire package merged into mail/queuer [smtp] - DEPRECATED - DELETE root package: entire package moved to mail/smtp - REFACTOR tlsmode: enhanced with encoding, formatting, and viper support (moved to mail/smtp/tlsmode) [size] - ADD documentation: comprehensive README - UPDATE interface: improved Size type methods - UPDATE encoding: enhanced marshaling support - UPDATE formatting: better unit handling and display - UPDATE parsing: improved error handling and validation [socket/server/unix] - ADD platform support: macOS-specific permission handling (perm_darwin.go) - ADD platform support: Linux-specific permission handling (perm_linux.go) - UPDATE listener: improved Unix socket and datagram listeners - UPDATE error handling: enhanced error messages for Unix sockets [socket/server/unixgram] - ADD platform support: macOS-specific permission handling (perm_darwin.go) - ADD platform support: Linux-specific permission handling (perm_linux.go) - UPDATE listener: improved Unix datagram listener - UPDATE error handling: enhanced error messages [socket/server/tcp] - UPDATE listener: improved TCP listener implementation
98 lines
3.0 KiB
Go
98 lines
3.0 KiB
Go
/*
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2020 Nicolas JUHEL
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
* SOFTWARE.
|
|
*
|
|
*/
|
|
|
|
package render
|
|
|
|
import (
|
|
"strings"
|
|
|
|
"github.com/go-hermes/hermes/v2"
|
|
)
|
|
|
|
// Themes represents the available email template themes.
|
|
// Each theme provides a different visual style for the generated emails.
|
|
//
|
|
// The themes are based on github.com/go-hermes/hermes/v2 theme implementations.
|
|
type Themes uint8
|
|
|
|
const (
|
|
// ThemeDefault is the default theme provided by Hermes.
|
|
// It offers a classic, clean email design with a centered layout.
|
|
ThemeDefault Themes = iota
|
|
|
|
// ThemeFlat is the flat theme provided by Hermes.
|
|
// It offers a modern, minimalist email design with flat colors.
|
|
ThemeFlat
|
|
)
|
|
|
|
// getHermes converts the Themes enum to the corresponding hermes.Theme implementation.
|
|
// This is an internal method used by the email generation process.
|
|
func (t Themes) getHermes() hermes.Theme {
|
|
switch t {
|
|
case ThemeDefault:
|
|
return &hermes.Default{}
|
|
case ThemeFlat:
|
|
return &hermes.Flat{}
|
|
}
|
|
|
|
return ThemeDefault.getHermes()
|
|
}
|
|
|
|
// String returns the string representation of the theme.
|
|
// The string value matches the theme name from the Hermes library.
|
|
//
|
|
// Example:
|
|
//
|
|
// theme := render.ThemeFlat
|
|
// fmt.Println(theme.String()) // Output: "flat"
|
|
func (t Themes) String() string {
|
|
return t.getHermes().Name()
|
|
}
|
|
|
|
// ParseTheme parses a theme name string and returns the corresponding Themes enum value.
|
|
// The parsing is case-insensitive.
|
|
//
|
|
// Supported theme names:
|
|
// - "default" -> ThemeDefault
|
|
// - "flat" -> ThemeFlat
|
|
//
|
|
// If the theme name is not recognized, ThemeDefault is returned.
|
|
//
|
|
// Example:
|
|
//
|
|
// theme := render.ParseTheme("flat")
|
|
// theme = render.ParseTheme("FLAT") // Also works
|
|
// theme = render.ParseTheme("unknown") // Returns ThemeDefault
|
|
func ParseTheme(theme string) Themes {
|
|
switch strings.ToLower(theme) {
|
|
case strings.ToLower(ThemeDefault.String()):
|
|
return ThemeDefault
|
|
case strings.ToLower(ThemeFlat.String()):
|
|
return ThemeFlat
|
|
}
|
|
|
|
return ThemeDefault
|
|
}
|