5 Commits

Author SHA1 Message Date
d79e413e8e chore(release): 1.0.1 2020-12-07 10:48:40 +00:00
cc372da881 Merge pull request #3 from jimeh/remove-leading-line-break-on-undented-values
fix(whitespace): remove leading line-break from input
2020-12-07 10:46:31 +00:00
b2057429a1 fix(whitespace): remove leading line-break from input
This effectively cleans up what I consider syntactical sugar required
due to Go's syntax. For example:

    str := undent.String(`
        hello
        world`,
    )

In the above example I would consider the initial line-break after the
opening back-tick (`) character syntactical sugar, and hence should be
discarded from the final undented string.

However if the literal string contains more than one initial line-break,
only the first one should be removed, as the rest would intentionally be
part of the input.
2020-12-07 10:43:26 +00:00
24e64f6c39 docs(readme): fix readme description to match godoc description 2020-11-26 12:42:41 +00:00
30dba69951 docs(readme): add Benchmarks section, update Go Reference link 2020-11-26 12:32:58 +00:00
5 changed files with 115 additions and 31 deletions

View File

@@ -2,6 +2,13 @@
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
### [1.0.1](https://github.com/jimeh/undent/compare/v1.0.0...v1.0.1) (2020-12-07)
### Bug Fixes
* **whitespace:** remove leading line-break from input ([b205742](https://github.com/jimeh/undent/commit/b2057429a1181724ae50acaed26fe434231362b4))
## 1.0.0 (2020-11-26)

View File

@@ -4,8 +4,8 @@
<p align="center">
<strong>
Go package which removes leading indentation/white-space from multi-line
strings and byte slices.
Go package which removes leading indentation/white-space from strings and
byte slices.
</strong>
</p>
@@ -52,8 +52,14 @@ fmt.Println(s)
## Documentation
Please see the [Go Reference](https://pkg.go.dev/github.com/jimeh/undent) for
documentation and examples.
Please see the
[Go Reference](https://pkg.go.dev/github.com/jimeh/undent#section-documentation)
for documentation and examples.
## Benchmarks
Benchmark reports and graphs are available here:
https://jimeh.me/undent/dev/bench/
## License

View File

@@ -11,6 +11,10 @@ var matcher = regexp.MustCompile(`(?m)^([ \t]*)(?:\S)`)
// Bytes removes leading indentation/white-space from given byte slice.
func Bytes(b []byte) []byte {
if len(b) > 0 && b[0] == '\n' {
b = b[1:]
}
matches := matcher.FindAll(b, -1)
if len(matches) == 0 {
return b
@@ -39,6 +43,10 @@ func Bytes(b []byte) []byte {
// String removes leading indentation/white-space from given string.
func String(s string) string {
if len(s) > 0 && s[0] == '\n' {
s = s[1:]
}
matches := matcher.FindAllString(s, -1)
if len(matches) == 0 {
return s

View File

@@ -15,7 +15,6 @@ func ExampleBytes() {
fmt.Println(string(b))
// Output:
//
// {
// "hello": "world"
// }
@@ -29,7 +28,6 @@ func ExampleString() {
)
fmt.Println(s)
// Output:
//
// {
// "hello": "world"
// }
@@ -44,7 +42,6 @@ func ExampleStringf() {
)
fmt.Println(s)
// Output:
//
// {
// "hello": "world"
// }

View File

@@ -35,8 +35,7 @@ var stringTestCases = []struct {
"bar"
]
}`,
want: `
{
want: `{
"hello": "world",
"foo": [
"bar"
@@ -46,6 +45,24 @@ var stringTestCases = []struct {
{
name: "multi-line space indented",
s: `
{
"hello": "world",
"foo": [
"bar"
]
}`,
want: `{
"hello": "world",
"foo": [
"bar"
]
}`,
},
{
name: "multi-line space indented with leading line-breaks",
s: `
{
"hello": "world",
"foo": [
@@ -53,6 +70,7 @@ var stringTestCases = []struct {
]
}`,
want: `
{
"hello": "world",
"foo": [
@@ -63,6 +81,24 @@ var stringTestCases = []struct {
{
name: "multi-line tab indented",
s: `
{
"hello": "world",
"foo": [
"bar"
]
}`,
want: `{
"hello": "world",
"foo": [
"bar"
]
}`,
},
{
name: "multi-line tab indented with leading line breaks",
s: `
{
"hello": "world",
"foo": [
@@ -70,6 +106,7 @@ var stringTestCases = []struct {
]
}`,
want: `
{
"hello": "world",
"foo": [
@@ -86,8 +123,7 @@ var stringTestCases = []struct {
"bar"
]
}`,
want: `
{
want: `{
"hello": "world",
"foo": [
"bar"
@@ -105,8 +141,7 @@ var stringTestCases = []struct {
]
}`,
want: `
{
want: `{
"hello": "world",
"foo": [
@@ -126,8 +161,7 @@ var stringTestCases = []struct {
]
}`,
want: `
{
want: `{
"hello": "world",
"foo": [
@@ -143,8 +177,7 @@ var stringTestCases = []struct {
world
foo
bar`,
want: `
hello
want: ` hello
world
foo
bar`,
@@ -156,8 +189,7 @@ world
world
foo
bar`,
want: `
hello
want: ` hello
world
foo
bar`,
@@ -197,8 +229,7 @@ var stringfTestCases = []struct {
]
}`,
a: []interface{}{"world", 42},
want: `
{
want: `{
"hello": "world",
"foo": [
42
@@ -208,6 +239,25 @@ var stringfTestCases = []struct {
{
name: "multi-line space indented",
s: `
{
"hello": "%s",
"foo": [
%d
]
}`,
a: []interface{}{"world", 42},
want: `{
"hello": "world",
"foo": [
42
]
}`,
},
{
name: "multi-line space indented with leading line-breaks",
s: `
{
"hello": "%s",
"foo": [
@@ -216,6 +266,7 @@ var stringfTestCases = []struct {
}`,
a: []interface{}{"world", 42},
want: `
{
"hello": "world",
"foo": [
@@ -233,7 +284,27 @@ var stringfTestCases = []struct {
]
}`,
a: []interface{}{"world", 42},
want: `{
"hello": "world",
"foo": [
42
]
}`,
},
{
name: "multi-line tab indented with leading line-breaks",
s: `
{
"hello": "%s",
"foo": [
%d
]
}`,
a: []interface{}{"world", 42},
want: `
{
"hello": "world",
"foo": [
@@ -251,8 +322,7 @@ var stringfTestCases = []struct {
]
}`,
a: []interface{}{"world", 42},
want: `
{
want: `{
"hello": "world",
"foo": [
42
@@ -271,8 +341,7 @@ var stringfTestCases = []struct {
]
}`,
a: []interface{}{"world", 42},
want: `
{
want: `{
"hello": "world",
"foo": [
@@ -293,8 +362,7 @@ var stringfTestCases = []struct {
]
}`,
a: []interface{}{"world", 42},
want: `
{
want: `{
"hello": "world",
"foo": [
@@ -311,8 +379,7 @@ var stringfTestCases = []struct {
foo
%d`,
a: []interface{}{"world", 42},
want: `
hello
want: ` hello
world
foo
42`,
@@ -325,8 +392,7 @@ world
foo
%d`,
a: []interface{}{"world", 42},
want: `
hello
want: ` hello
world
foo
42`,