Initial commit

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.gitignore

@@ -0,0 +1,21 @@
+# If you prefer the allow list template instead of the deny list, see community template:
+# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
+#
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Matúš Ollah
+
+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.

README.md

@@ -0,0 +1,24 @@
+# stripansi
+
+**stripansi** is a Go package for removing [ANSI escape sequences](https://en.wikipedia.org/wiki/ANSI_escape_code).
+
+## Basic Usage
+
+```go
+package main
+
+import (
+    "fmt"
+    "os"
+
+    "github.com/MatusOllah/stripansi"
+)
+
+func main() {
+    s := "\x1b[38;5;140mhello\x1b[0m world"
+
+    fmt.Println(stripansi.String(s))                // "hello world"
+    fmt.Println(string(stripansi.Bytes([]byte(s)))) // "hello world"
+    stripansi.NewWriter(os.Stdout).Write([]byte(s)) // "hello world"
+}
+```

go.mod

@@ -0,0 +1,3 @@
+module github.com/MatusOllah/stripansi
+
+go 1.23.0

stripansi.go

@@ -0,0 +1,44 @@
+// package stripansi provides utilities for removing ANSI escape sequences using regular expressions.
+package stripansi
+
+import (
+	"io"
+	"regexp"
+	"sync"
+)
+
+var re *regexp.Regexp = regexp.MustCompile("[\u001B\u009B][[\\]()#;?]*(?:(?:(?:[a-zA-Z\\d]*(?:;[a-zA-Z\\d]*)*)?\u0007)|(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PRZcf-ntqry=><~]))")
+
+// Regexp returns a copy of the underlying [regexp.Regexp].
+func Regexp() *regexp.Regexp {
+	return re.Copy()
+}
+
+// Bytes removes ANSI escape sequences from the byte slice.
+func Bytes(b []byte) []byte {
+	return re.ReplaceAll(b, nil)
+}
+
+// String removes ANSI escape sequences from the string.
+func String(s string) string {
+	return re.ReplaceAllString(s, "")
+}
+
+// Writer wraps an [io.Writer] and removes ANSI sequences from its output.
+type Writer struct {
+	w  io.Writer
+	mu sync.Mutex
+}
+
+// NewWriter creates a new [Writer].
+func NewWriter(w io.Writer) *Writer {
+	return &Writer{w: w}
+}
+
+// Write removes ANSI escape sequences and writes to the underlying writer.
+func (w *Writer) Write(p []byte) (n int, err error) {
+	w.mu.Lock()
+	defer w.mu.Unlock()
+
+	return w.w.Write(Bytes(p))
+}