Skip to content

added README example that makes replacements in multiple files #230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

sam-mininberg
Copy link

Addresses #229

@bitfield
Copy link
Owner

Nice work @sam-mininberg!

@@ -220,6 +220,28 @@ script.Echo("a\nb\nc").FilterScan(func(line string, w io.Writer) {
// scanned line: "c"
```

Alternatively, we can use a `Filter` function that returns a `string`. For example, let's fix typos we've made in the CSV files in our working directory:
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if referencing CSV files is a red herring here. Readers might think this example is something to do with CSV parsing. Should we just talk about making arbitrary edits to all files matching a pattern?

```go
script.ListFiles("*.csv").FilterLine(func(file string) string {
search := "typ"
replace := "typo"
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should use completely different search and replace strings, as this particular search and replace would not be idempotent: if you keep running it, "typo" will become "typoo", and so on.

script.ListFiles("*.csv").FilterLine(func(file string) string {
search := "typ"
replace := "typo"
s, err := File(file).String()
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reading the whole file into a single string is a bit limiting—and unnecessarily so when we only need to read it line by line. What about using script's own Replace method, if that's possible here?

replace := "typo"
s, err := File(file).String()
if err != nil {
return fmt.Sprintf("%s %s", file, err)
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it's better after all to use Filter, then, since that can return an error and stop the pipe if necessary; something doesn't feel right about just flattening it like this and carrying on. What do you think a sensible text-replacement program should do if it hits an error with some file? What would the equivalent sed command do?

if err != nil {
return fmt.Sprintf("%s %s", file, err)
}
count := strings.Count(s, search)
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's nice to have a count of the number of replacements, but not essential—and the key to a good example is eliminating all non-essential detail. I don't deny that we probably would want a real script text-replacement program to do this, but examples like this are more effective when they're as brief and focused as possible, wouldn't you say?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants