samber/cc-skills-golang / skills/golang-samber-ro
golang-samber-ro
VerifiedReactive streams and event-driven programming in Golang using samber/ro — ReactiveX implementation with 150+ type-safe operators, cold/hot observables, 5 subject types (Publish, Behavior, Replay, Async, Unicast), declarative pipelines via Pipe, 40+ plugins (HTTP, cron, fsnotify, JSON, logging), automatic backpressure, error propagation, and Go context integration. Apply when using or adopting samber/ro, when the codebase imports github.com/samber/ro, or when building asynchronous event-driven pipelines, real-time data processing, streams, or reactive architectures in Go. Not for finite slice transforms (→ See `samber/cc-skills-golang@golang-samber-lo` skill).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.8 KB |
| evals/evals.json | config | 17.3 KB |
| references/operators-guide.md | markdown | 14.6 KB |
| references/patterns.md | markdown | 8.0 KB |
| references/plugin-ecosystem.md | markdown | 6.3 KB |
| references/subjects-guide.md | markdown | 6.3 KB |
references/plugin-ecosystem.md
View on GitHub# Plugin Ecosystem
samber/ro ships 40+ plugins that extend the core library with domain-specific operators. Plugins are separate Go modules — install only what you need.
```bash
go get github.com/samber/ro/plugins/<category>/<name>
```
## Table of Contents
- [Data Manipulation](#data-manipulation)
- [Encoding and Serialization](#encoding-and-serialization)
- [Scheduling](#scheduling)
- [Network and I/O](#network-and-io)
- [Observability and Logging](#observability-and-logging)
- [Rate Limiting](#rate-limiting)
- [Text Processing](#text-processing)
- [System Integration](#system-integration)
- [Validation](#validation)
- [Testing](#testing)
- [Utilities](#utilities)
- [Plugin Design Convention](#plugin-design-convention)
## Data Manipulation
| Plugin | Import | Purpose |
| --- | --- | --- |
| Bytes | `plugins/bytes` | Byte slice operations on streams |
| Strings | `plugins/strings` | String transformations (split, trim, join) |
| Sort | `plugins/sort` | Sorting operators for ordered streams |
| Strconv | `plugins/strconv` | Type conversion (string <-> numeric) |
| Iter | `plugins/iter` | Go 1.23+ iterator interop |
| SIMD (experimental) | `plugins/exp/simd` | SIMD-accelerated numeric transforms |
## Encoding and Serialization
| Plugin | Import | Purpose |
| ------ | ------------------------- | -------------------------------- |
| JSON | `plugins/encoding/json` | Marshal/unmarshal JSON in stream |
| CSV | `plugins/encoding/csv` | Parse/generate CSV rows |
| Base64 | `plugins/encoding/base64` | Encode/decode Base64 |
| Gob | `plugins/encoding/gob` | Go binary encoding |
```go
import rojson "github.com/samber/ro/plugins/encoding/json"
// Parse JSON stream: []byte -> MyStruct
parsed := ro.Pipe1(rawBytes, rojson.Unmarshal[MyStruct]())
```
## Scheduling
| Plugin | Import | Purpose |
| ------ | -------------- | ------------------------------------- |
| Cron | `plugins/cron` | Emit on cron expressions or intervals |
| ICS | `plugins/ics` | Parse iCal files into event streams |
```go
import rocron "github.com/samber/ro/plugins/cron"
// Emit every day at midnight
daily := rocron.Schedule("0 0 * * *")
```
## Network and I/O
| Plugin | Import | Purpose |
| -------- | ------------------ | ---------------------------------------- |
| HTTP | `plugins/http` | HTTP request operators (GET, POST, etc.) |
| I/O | `plugins/io` | File and stream reading/writing |
| FSNotify | `plugins/fsnotify` | File system change events |
```go
import rofsnotify "github.com/samber/ro/plugins/fsnotify"
// Watch directory for changes
events := rofsnotify.Watch("/var/log/app/")
ro.Pipe1(events, ro.Filter(func(e fsnotify.Event) bool {
return e.Op == fsnotify.Write
})).Subscribe(ro.OnNext(func(e fsnotify.Event) {
log.Println("Modified:", e.Name)
}))
```
## Observability and Logging
| Plugin | Import | Purpose |
| ------- | ------------------------------- | ------------------------------- |
| Log | `plugins/observability/log` | stdlib `log` integration |
| Zap | `plugins/observability/zap` | Uber Zap structured logging |
| Logrus | `plugins/observability/logrus` | Logrus logging |
| Slog | `plugins/observability/slog` | Go 1.21+ `log/slog` integration |
| Zerolog | `plugins/observability/zerolog` | Zerolog logging |
| Sentry | `plugins/observability/sentry` | Sentry error tracking |
| Oops | `plugins/samber/oops` | samber/oops structured errors |
```go
import roslog "github.com/samber/ro/plugins/observability/slog"
// Log all stream events via slog
ro.Pipe1(
dataStream,
roslog.Tap[Data](logger, slog.LevelInfo),
)
```
## Rate Limiting
| Plugin | Import | Purpose |
| ------ | -------------------------- | ---------------------------------- |
| Native | `plugins/ratelimit/native` | Built-in token bucket rate limiter |
| Ulule | `plugins/ratelimit/ulule` | ulule/limiter integration |
## Text Processing
| Plugin | Import | Purpose |
| -------- | ------------------ | ------------------------------------ |
| Regexp | `plugins/regexp` | Regex matching/extraction on streams |
| Template | `plugins/template` | Go text/html template rendering |
## System Integration
| Plugin | Import | Purpose |
| ------- | ---------------- | ------------------------------------------ |
| Process | `plugins/proc` | Process execution operators |
| Signal | `plugins/signal` | OS signal handling (SIGTERM, SIGINT, etc.) |
```go
import rosignal "github.com/samber/ro/plugins/signal"
// Observable that emits on SIGTERM/SIGINT
shutdown := rosignal.Notify(syscall.SIGTERM, syscall.SIGINT)
// Use as TakeUntil signal for graceful shutdown
ro.Pipe1(workStream, ro.TakeUntil[Work, os.Signal](shutdown))
```
## Validation
| Plugin | Import | Purpose |
| --- | --- | --- |
| Ozzo Validation | `plugins/ozzo/ozzo-validation` | Stream-level input validation |
## Testing
| Plugin | Import | Purpose |
| ------- | ----------------- | -------------------------------------- |
| Testify | `plugins/testify` | Test assertions for observable streams |
## Utilities
| Plugin | Import | Purpose |
| ----------- | --------------------- | -------------------------------------- |
| HyperLogLog | `plugins/hyperloglog` | Cardinality estimation on streams |
| Hot | `plugins/samber/hot` | In-memory caching integration |
| PSI | `plugins/samber/psi` | Starvation notifier / pressure metrics |
## Plugin Design Convention
All plugins follow the same pattern:
1. Import the plugin package
2. Use plugin-provided operators in `Pipe` chains
3. Plugin operators return `func(Observable[T]) Observable[R]` — standard operator signature
4. No global state — each operator instance is independent
Plugins are documented individually in their package directories. API details for each plugin are available at `pkg.go.dev/github.com/samber/ro/plugins/...`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |