https://github.com/devkcud/salvation
💀 A generic Go wrapper for optional values, inspired by Rust's Option and Haskell's Maybe. Brings Possibly[T] to your codebase for safe, expressive nothingness.
https://github.com/devkcud/salvation
functional-programming generics golang maybe monads-but-shhh nullable option zero-values
Last synced: 8 months ago
JSON representation
💀 A generic Go wrapper for optional values, inspired by Rust's Option and Haskell's Maybe. Brings Possibly[T] to your codebase for safe, expressive nothingness.
- Host: GitHub
- URL: https://github.com/devkcud/salvation
- Owner: devkcud
- License: unlicense
- Created: 2025-07-08T22:08:09.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-07-09T00:07:25.000Z (9 months ago)
- Last Synced: 2025-07-09T00:26:57.276Z (9 months ago)
- Topics: functional-programming, generics, golang, maybe, monads-but-shhh, nullable, option, zero-values
- Language: Go
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 🌀 Salvation
`salvation` is a package containing a generic Go wrapper for optional values.
Inspired by Rust's `Option` and Haskell's `Maybe`, `Possibly[T]` gives you a way to wrap things that may or may not exist, and then reflect on their Nothingness.
## ✨ Features
- Generic support for any type `T`
- Reflection-powered nil checking
- Precomputable "Nothingness" for less overhead
- Configurable rules (empty slices can be something... if you _believe_)
- Matcher flow control
- Fully documented (yes, this is a feature)
## 🧠 Why?
Honestly? I don't know. But it seemed fun enough to build.
## 🚀 Usage
Usage examples below. A full Wiki is coming soon (probably just so I can pretend it matters).
```go
opt := salvation.NewPossibility[*MyStruct](nil)
if opt.IsSomething() {
// yay!
}
if opt.IsNothing() {
// aww!
}
```
```go
opt.Match().
Case(func(v int) bool { return v > 10 }, func(v int) { fmt.Println("Large number", v) }).
Default(func(_ Possibly[int]) {
fmt.Println("Nothing matched. Or maybe there was Nothing at all.")
})
```
## 🫠 Contributing
Thinking of contributing? That's adorable.
Before submitting a PR, feature request, or unhinged philosophical improvement, please consult the [`CONTRIBUTING.md`](CONTRIBUTING.md). It's full of helpful guidelines, emotional red flags, and vague threats.
If you're still interested after reading it, I can't stop you. No one can.
## ⭐️ Validation
If this repo made you feel something (anything at all) you can click the star. It won't fix your life, but it'll make this repo slightly more visible to other souls.
> I made this section against my own will...
## 🧯 License
This project uses **The Unlicense** license (just copy and paste into your code and believe in yourself)