flop
flop aims to make copying files easier in Go, and is modeled after GNU cp. Most administrators and engineers interact with GNU utilities every day, so it makes sense to utilize that knowledge and expectations for a library that does the same operation in code.
flop strategically diverges from cp where it is advantageous for the programmer to explicitly define the behavior, like cp assuming that copying from a file path to a directory path means the file should be created inside the directory. This behavior must be explicitly defined in flop by passing the option AppendNameToPath, otherwise an error will be returned.
go get -u github.com/homedepot/flop
Usage
Basic file copy.
err := flop.SimpleCopy("src_path", "dst_path")
handle(err)
Advanced file copy with options.
options := flop.Options{
Recursive: true,
MkdirAll: true,
}
err := flop.Copy("src_path", "dst_path", options)
handle(err)
Logging
flop won't throw logs at you for no reason, but if you want to follow along with what's going on giving it a logger can help expose the behavior, or aid in debugging if you are generous enough to contribute.
// the logger just takes a string so format your favorite logger to accept one
import (
"github.com/homedepot/flop"
"github.com/rs/zerolog"
zlog "github.com/rs/zerolog/log"
llog "github.com/sirupsen/logrus"
)
func logDebug(msg string) {
llog.WithFields(llog.Fields{
"application": "stuffcopy",
}).Info(msg)
}
func main() {
zlog.Logger = zlog.Output(zerolog.ConsoleWriter{Out: os.Stderr})
err := flop.Copy(src.Name(), dst.Name(), flop.Options{
InfoLogFunc: zlog.Info().Msg, // Msg already accepts a string so we can just pass it directly
DebugLogFunc: logDebug, // logrus Debug takes ...interface{} so we need to wrap it
})
handle(err)
}
300 Dec 28, 2022
20 Dec 1, 2022
48.6k Jan 9, 2023
7.7k Jan 1, 2023
1.9k Dec 30, 2022
6k Jan 9, 2023
1.7k Jan 3, 2023
18.3k Jan 9, 2023
1.1k Jan 2, 2023
788 Dec 31, 2022
1.4k Dec 27, 2022
27 Dec 5, 2022
221 Dec 30, 2022
46 Nov 30, 2022
238 Dec 31, 2022
101 Nov 16, 2022
212 Jan 3, 2023
107 Sep 25, 2022
100 Dec 22, 2021