feat: Improve CLI usability, help, and documentation

This commit introduces a comprehensive set of improvements to enhance the tool's usability and documentation clarity.

1.  **Correct Standard Input Handling:**
    The tool now correctly reads from standard input when no input file is specified or when '-' is used as the file name. This fixes a bug and allows for more flexible usage in command-line pipelines.

2.  **Clearer Help Message:**
    The help message (`-h` flag) has been significantly improved. It now explicitly marks required flags (`-o`, `-t`) and provides a clearer, more detailed explanation of the tool's functionality, input methods, and a practical usage example.

3.  **Synchronized Documentation:**
    The `README.md` and `README.ja.md` files have been updated to align with the actual behavior of the CLI. The "Usage" section now clearly explains the required flags and the optional nature of the input file argument, ensuring consistency between the code, help text, and documentation.

Author: magifd2

README.ja.md

@@ -35,12 +35,14 @@ make build
 
 ## 使い方
 
-このツールは入力JSONファイルと以下のフラグを必要とします。
+このツールは、必須のフラグ`-o`と`-t`に加えて、JSONデータを入力ファイルまたは標準入力経由で受け取ります。
 
 -   `-o <パス>`: **必須。** 出力先のSQLiteデータベースファイルを指定します。
 -   `-t <テーブル名>`: **必須。** 作成または更新するテーブル名を指定します。
 -   `--version`: ツールのバージョン情報を表示します。
 
+任意の引数 `[入力ファイル]` を指定すると、そのファイルからJSONを読み込みます。`[入力ファイル]` が省略されるか、`-` に設定された場合、ツールは標準入力から読み込みます。
+
 ### 使用例
 
 **1. JSONファイルを新しいデータベースに変換する:**
@@ -50,9 +52,9 @@ json-to-sqlite -o users.db -t users users.json
 
 **2. 他のコマンド（例: `curl`）からJSONデータをパイプで渡す:**
 ```bash
-curl "https://api.example.com/data" | json-to-sqlite -o api_data.db -t records -
+curl "https://api.example.com/data" | json-to-sqlite -o api_data.db -t records
 ```
-*注: 標準入力からパイプで渡す場合、`input_json_file`引数として`-`を使用してください。*
+*注: 上記のコマンドは `[入力ファイル]` 引数を省略しているため機能します。引数として `-` を使用しても (`... | json-to-sqlite -o api_data.db -t records -`) 同じ結果になります。*
 
 **3. 新しいカラムを持つ可能性のあるデータを既存のデータベースに追加する:**
 ```bash

README.md

@@ -35,12 +35,14 @@ make build
 
 ## Usage
 
-The tool requires an input JSON file and the following flags:
+The tool has two required flags, `-o` and `-t`. JSON data can be provided either as an input file argument or via standard input.
 
 -   `-o <path>`: **Required.** Specifies the path for the output SQLite database file.
 -   `-t <name>`: **Required.** Specifies the name of the table to create or update.
 -   `--version`: Prints the current version of the tool.
 
+An optional `[input_file]` argument can be provided to read from a file. If `[input_file]` is omitted or set to `-`, the tool will read from standard input.
+
 ### Examples
 
 **1. Convert a JSON file into a new database:**
@@ -50,9 +52,9 @@ json-to-sqlite -o users.db -t users users.json
 
 **2. Pipe JSON data from another command (e.g., `curl`):**
 ```bash
-curl "https://api.example.com/data" | json-to-sqlite -o api_data.db -t records -
+curl "https://api.example.com/data" | json-to-sqlite -o api_data.db -t records
 ```
-*Note: When piping from stdin, use `-` as the input_json_file argument.*
+*Note: The above command works because the `[input_file]` argument is omitted. Using `-` as the argument (`... | json-to-sqlite -o api_data.db -t records -`) achieves the same result.*
 
 **3. Add new data with potentially new columns to an existing database:**
 ```bash

main.go

@@ -28,6 +28,25 @@ func main() {
 	tableName := flag.String("t", "", "Table name to insert data into (required)")
 	versionFlag := flag.Bool("version", false, "Print version information")
 
+	flag.Usage = func() {
+		fmt.Fprintln(os.Stderr, "Usage: json-to-sqlite -o <database.db> -t <table_name> [input_file]")
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "A tool to convert JSON data into an SQLite database.")
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "Reads JSON from a file or from standard input and creates a table with a schema")
+		fmt.Fprintln(os.Stderr, "inferred from the JSON objects.")
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "If [input_file] is omitted or is '-', data is read from standard input.")
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "The JSON input must be an array of objects or a single JSON object.")
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "Options:")
+		flag.PrintDefaults()
+		fmt.Fprintln(os.Stderr, "")
+		fmt.Fprintln(os.Stderr, "Example:")
+		fmt.Fprintln(os.Stderr, "  cat data.json | json-to-sqlite -o my.db -t my_table")
+	}
+
 	flag.Parse()
 
 	if *versionFlag {
@@ -36,24 +55,18 @@ func main() {
 	}
 
 	if *outputDB == "" {
-		fmt.Println("Error: Output database file (-o) is required.")
-		flag.PrintDefaults()
+		fmt.Fprintln(os.Stderr, "Error: Output database file (-o) is required.\n")
+		flag.Usage()
 		os.Exit(1)
 	}
 
 	if *tableName == "" {
-		fmt.Println("Error: Table name (-t) is required.")
-		flag.PrintDefaults()
+		fmt.Fprintln(os.Stderr, "Error: Table name (-t) is required.\n")
+		flag.Usage()
 		os.Exit(1)
 	}
 
 	// --- Input Handling ---
-	if len(flag.Args()) == 0 {
-		fmt.Println("Usage: json-to-sqlite [options] <input_json_file>")
-		flag.PrintDefaults()
-		os.Exit(1)
-	}
-
 	reader, err := getInputReader(flag.Args())
 	if err != nil {
 		log.Fatal(err)
@@ -89,9 +102,13 @@ func main() {
 	fmt.Printf("Successfully processed %d objects into table '%s' in database '%s'.\n", len(data), *tableName, *outputDB)
 }
 
+
 func getInputReader(args []string) (io.Reader, error) {
 	if len(args) > 0 {
 		filePath := args[0]
+		if filePath == "-" {
+			return os.Stdin, nil
+		}
 		file, err := os.Open(filePath)
 		if err != nil {
 			return nil, fmt.Errorf("error opening file %s: %w", filePath, err)
@@ -292,4 +309,4 @@ func insertData(db *sql.DB, tableName string, columns []string, data []map[strin
 	}
 
 	return tx.Commit()
-}
+}