add CLI

update README.md

Author: Vitalick

README.md

@@ -6,6 +6,45 @@
 Simple Go package for reading and writing Diablo 2 saves. Supports version 1.10 through Diablo II: Resurrected (1.15).
 Supports reading both d2s (player saves) ~~and d2i (shared stash)~~ files.
 
+## Installation
+
+To install the package, use the following:
+
+```bash
+go get github.com/vitalick/d2s
+```
+
+To install command line program, use the following:
+
+```bash
+go install github.com/vitalick/d2s/d2s-conv@latest
+```
+
+## Usage
+
+### CLI
+
+For convert JSON to .d2s, use the following:
+```bash
+d2s-conv -fromjson <input files>
+```
+
+For convert .d2s to JSON, use the following:
+```bash
+d2s-conv -tojson <input files>
+```
+
+To specify the path to the output folder, we use the following:
+```bash
+d2s-conv -fromjson -o <output folder> <input files>
+d2s-conv -tojson -o <output folder> <input files>
+```
+
+### As package
+
+Coming soon...
+
+
 ## Roadmap
 
 <details>

d2s-conv/main.go

@@ -0,0 +1,77 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"github.com/vitalick/d2s"
+	"os"
+)
+
+type flags struct {
+	d2sToJSON bool
+	jsonToD2s bool
+	output    string
+	input     []string
+}
+
+var parsedFlags flags
+
+func main() {
+	parseArgs()
+
+	if parsedFlags.d2sToJSON {
+		for _, f := range parsedFlags.input {
+			c, err := d2s.Open(f)
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "Error \"%v\" on open file \"%s\", skipped \n\n", err, f)
+				continue
+			}
+			err = d2s.SaveJSON(c, parsedFlags.output)
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "Error \"%v\" on save file \"%s\", skipped \n\n", err, f)
+				continue
+			}
+		}
+	}
+
+	if parsedFlags.jsonToD2s {
+		for _, f := range parsedFlags.input {
+			c, err := d2s.OpenJSON(f)
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "Error \"%v\" on open file \"%s\", skipped \n\n", err, f)
+				continue
+			}
+			err = d2s.Save(c, parsedFlags.output)
+			if err != nil {
+				fmt.Fprintf(os.Stderr, "Error \"%v\" on save file \"%s\", skipped \n\n", err, f)
+				continue
+			}
+		}
+	}
+}
+
+func parseArgs() {
+	flag.Usage = func() {
+		fmt.Printf("Usage: %s [options] <input files>\n\n", os.Args[0])
+		flag.PrintDefaults()
+	}
+	flag.BoolVar(&parsedFlags.d2sToJSON, "tojson", parsedFlags.d2sToJSON, "Convert d2s to json.")
+	flag.BoolVar(&parsedFlags.jsonToD2s, "fromjson", parsedFlags.jsonToD2s, "Convert json to d2s.")
+	flag.StringVar(&parsedFlags.output, "o", parsedFlags.output, "Optional path of the output folder.")
+
+	// Make sure we have input paths.
+	if flag.NArg() == 0 {
+		_, err := fmt.Fprintf(os.Stderr, "Missing <input files>\n\n")
+		if err != nil {
+			return
+		}
+		flag.Usage()
+		os.Exit(1)
+	}
+
+	// Create input configurations.
+	parsedFlags.input = make([]string, flag.NArg())
+	for i := range parsedFlags.input {
+		parsedFlags.input[i] = flag.Arg(i)
+	}
+}

d2s.go

@@ -1,16 +1,26 @@
 package d2s
 
 import (
+	"encoding/json"
 	"fmt"
-	"log"
 	"os"
 )
 
-//Open returns a new Character for editing and viewing
+func beforeSave(c *Character, folder *string) error {
+	if len(c.Name) == 0 {
+		return errorBlankName
+	}
+	if len(*folder) > 0 && (*folder)[len(*folder)-1:] != "/" {
+		*folder = *folder + "/"
+	}
+	return nil
+}
+
+//Open returns a new Character from .d2s file
 func Open(filepath string) (*Character, error) {
 	file, err := os.Open(filepath)
 	if err != nil {
-		log.Println("Error while opening .d2s file")
+		fmt.Fprintln(os.Stderr, "Error while opening .d2s file")
 		return nil, err
 	}
 
@@ -19,32 +29,82 @@ func Open(filepath string) (*Character, error) {
 	c, err := NewCharacter(file)
 
 	if err != nil {
-		log.Println("Error while parsing .d2s file")
+		fmt.Fprintln(os.Stderr, "Error while parsing .d2s file")
 		return nil, err
 	}
 
 	return c, nil
 }
 
-//Save will create *.d2s file in folder with Character struct
+//Save will create .d2s file in folder with Character struct
 func Save(c *Character, folder string) error {
-	if len(c.Name) == 0 {
-		return ErrorBlankName
-	}
-	if len(folder) > 0 && folder[len(folder)-1:] != "/" {
-		folder = folder + "/"
+	if err := beforeSave(c, &folder); err != nil {
+		fmt.Fprintln(os.Stderr, errorBlankName)
+		return err
 	}
 	file, err := os.Create(fmt.Sprintf("%s%s.d2s", folder, c.Name))
 	if err != nil {
-		log.Fatalln("Error while creating .d2s file")
+		fmt.Fprintln(os.Stderr, "Error while creating .d2s file")
 		return err
 	}
 
 	defer file.Close()
 
 	err = c.ToWriterCorrect(file)
 	if err != nil {
-		log.Fatalln("Error while writing buffer file")
+		fmt.Fprintln(os.Stderr, "Error while writing buffer file")
+		return err
+	}
+	return nil
+}
+
+//OpenJSON returns a new Character from json file
+func OpenJSON(filepath string) (*Character, error) {
+	file, err := os.Open(filepath)
+	if err != nil {
+		fmt.Fprintln(os.Stderr, "Error while opening json file")
+		return nil, err
+	}
+
+	defer file.Close()
+
+	c, err := NewEmptyCharacter(97)
+
+	if err != nil {
+		fmt.Fprintln(os.Stderr, "Error while create empty Character")
+		return nil, err
+	}
+
+	d := json.NewDecoder(file)
+	err = d.Decode(&c)
+
+	if err != nil {
+		fmt.Fprintln(os.Stderr, "Error while parsing json file")
+		return nil, err
+	}
+
+	return c, nil
+}
+
+//SaveJSON will create *.d2s file in folder with Character struct
+func SaveJSON(c *Character, folder string) error {
+	if err := beforeSave(c, &folder); err != nil {
+		fmt.Fprintln(os.Stderr, errorBlankName)
+		return err
+	}
+	file, err := os.Create(fmt.Sprintf("%s%s.json", folder, c.Name))
+	if err != nil {
+		fmt.Fprintln(os.Stderr, "Error while creating json file")
+		return err
+	}
+
+	defer file.Close()
+
+	d := json.NewEncoder(file)
+	err = d.Encode(&c)
+
+	if err != nil {
+		fmt.Fprintln(os.Stderr, "Error while writing json file")
 		return err
 	}
 	return nil

errors.go

@@ -3,6 +3,6 @@ package d2s
 import "errors"
 
 var (
-	//ErrorBlankName it is error when save without character name
-	ErrorBlankName = errors.New("blank name error")
+	//errorBlankName it is error when save without character name
+	errorBlankName = errors.New("blank name error")
 )