Move parsers/formatters back into parse/format and move main into root

Author: stilvoid

README.md

@@ -1,5 +1,17 @@
 Please is a utility for making and receiving web requests and parsing and reformatting the common data formats that are sent over them.
 
+## Installing
+
+`brew install stilvoid/tools/please`
+
+_or_
+
+Download a binary from the [releases](https://github.com/stilvoid/please/releases) page.
+
+_or_
+
+Run `go install github.com/stilvoid/please@latest`
+
 ## Usage
 
 ```

cmd/identify/identify.go

@@ -5,8 +5,8 @@ import (
 	"os"
 
 	"github.com/spf13/cobra"
-	"github.com/stilvoid/please"
 	"github.com/stilvoid/please/internal"
+	"github.com/stilvoid/please/parse"
 )
 
 var Cmd = &cobra.Command{
@@ -45,7 +45,7 @@ var order = []string{
 // If the data format could not be identified, an error will be returned
 func Identify(input []byte) (string, any, error) {
 	for _, name := range order {
-		output, err := please.Parse(name, input)
+		output, err := parse.Parse(name, input)
 		if err != nil {
 			continue
 		}

cmd/parse/parse.go

@@ -7,9 +7,10 @@ import (
 
 	"github.com/jmespath/go-jmespath"
 	"github.com/spf13/cobra"
-	"github.com/stilvoid/please"
 	"github.com/stilvoid/please/cmd/identify"
+	"github.com/stilvoid/please/format"
 	"github.com/stilvoid/please/internal"
+	"github.com/stilvoid/please/parse"
 )
 
 var inFormat string
@@ -23,12 +24,12 @@ func init() {
 
 	formats := strings.Builder{}
 	formats.WriteString("Input formats:\n")
-	for _, name := range please.Parsers {
+	for _, name := range parse.Parsers {
 		formats.WriteString(fmt.Sprintf("  %s\n", name))
 	}
 	formats.WriteString("\n")
 	formats.WriteString("Output formats:\n")
-	for _, name := range please.Formatters {
+	for _, name := range format.Formatters {
 		formats.WriteString(fmt.Sprintf("  %s\n", name))
 	}
 
@@ -58,7 +59,7 @@ var Cmd = &cobra.Command{
 			inFormat, parsed, err = identify.Identify(input)
 		} else {
 			// Try parsing
-			parsed, err = please.Parse(inFormat, input)
+			parsed, err = parse.Parse(inFormat, input)
 		}
 
 		cobra.CheckErr(err)
@@ -74,7 +75,7 @@ var Cmd = &cobra.Command{
 		}
 
 		// ...and format back out :)
-		output, err := please.Format(outFormat, parsed)
+		output, err := format.Format(outFormat, parsed)
 		cobra.CheckErr(err)
 
 		fmt.Println(output)

format/format.go

@@ -0,0 +1,36 @@
+package format
+
+import (
+	"fmt"
+	"maps"
+	"slices"
+	"sort"
+)
+
+var formatters = map[string]func(any) (string, error){
+	"bash":  Bash,
+	"dot":   Dot,
+	"json":  Json,
+	"xml":   Xml,
+	"yaml":  Yaml,
+	"query": Query,
+	"toml":  Toml,
+}
+
+// Formatters are the names of data formats that please can output
+var Formatters []string
+
+func init() {
+	Formatters = slices.Collect(maps.Keys(formatters))
+	sort.Strings(Formatters)
+}
+
+// Format converts input data into format as a byte array
+func Format(format string, input any) (string, error) {
+	formatter, ok := formatters[format]
+	if !ok {
+		return "", fmt.Errorf("Invalid formatter: %s", format)
+	}
+
+	return formatter(input)
+}

cmd/main.go main.gocmd/main.go renamed to main.go

@@ -0,0 +1,37 @@
+package parse
+
+import (
+	"fmt"
+	"maps"
+	"slices"
+	"sort"
+)
+
+var parsers = map[string]func([]byte) (any, error){
+	"csv":   Csv,
+	"html":  Html,
+	"json":  Json,
+	"mime":  Mime,
+	"xml":   Xml,
+	"yaml":  Yaml,
+	"query": Query,
+	"toml":  Toml,
+}
+
+// Parsers are the names of data formats that please can read
+var Parsers []string
+
+func init() {
+	Parsers = slices.Collect(maps.Keys(parsers))
+	sort.Strings(Parsers)
+}
+
+// Parse reads input as format and returns data
+func Parse(format string, input []byte) (any, error) {
+	parser, ok := parsers[format]
+	if !ok {
+		return nil, fmt.Errorf("Invalid parser: %s", format)
+	}
+
+	return parser(input)
+}