axiodb 15.1.0 → 16.2.1

package/README.md

@@ -30,6 +30,7 @@
   - [Simple: connect without authentication](#simple-connect-without-authentication)
   - [Advanced: TCP authentication](#advanced-tcp-authentication)
   - [Advanced: TLS encryption](#advanced-tls-encryption)
+- [AxioDB CLI — Command Line Interface](#-axiodb-cli--command-line-interface)
 - [Troubleshooting](#-troubleshooting)
 - [Docker Deployment](#-docker-deployment)
   - [Simple: run the container](#simple-run-the-container)
@@ -338,6 +339,79 @@ The rule: the `-e AXIODB_TLS_CERT_PATH=...` value must always match the *right-h
 
 ---
 
+## 💻 AxioDB CLI — Command Line Interface
+
+A Go-based CLI tool for interacting with AxioDB servers via the TCP protocol. Supports all database operations with both single-command and interactive REPL modes.
+
+### Quick Install
+
+**Linux/macOS:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/nexoral/AxioDB/main/cli/Scripts/install.ps1 | iex
+```
+
+**Or download directly:** [GitHub Releases](https://github.com/nexoral/AxioDB/releases?q=cli-v&expanded=true)
+
+### Supported Platforms
+
+| OS | Architectures |
+|------|--------------|
+| Linux | amd64, arm64, 386, armv7 |
+| macOS | amd64 (Intel), arm64 (Apple Silicon) |
+| Windows | amd64, arm64, 386 |
+| FreeBSD | amd64 |
+| OpenBSD | amd64 |
+| NetBSD | amd64 |
+
+### Usage
+
+**Single commands:**
+```bash
+axiodb -c axiodb://127.0.0.1:27019 ping
+axiodb -c axiodb://127.0.0.1:27019 db list
+axiodb -c axiodb://127.0.0.1:27019 document insert '{"name":"Alice"}' --db mydb --collection users
+axiodb -c axiodb://127.0.0.1:27019 document query '{}' --db mydb --collection users
+```
+
+**Interactive REPL (MongoDB shell style):**
+```bash
+axiodb connect
+# axiodb> use mydb
+# axiodb:mydb> show collections
+# axiodb:mydb> use mydb.users
+# axiodb:mydb:users> db.users.find({})
+# axiodb:mydb:users> db.users.insert({name: "Bob"})
+# axiodb:mydb:users> exit
+```
+
+**With authentication:**
+```bash
+axiodb -c axiodb://127.0.0.1:27019 -u admin -p admin connect
+```
+
+**With TLS:**
+```bash
+axiodb -c axiodb://127.0.0.1:27019 --tls --tls-cert ./cert.pem connect
+```
+
+### Features
+
+- **All 21 TCP commands:** database, collection, document CRUD, aggregation, indexing
+- **Interactive REPL:** MongoDB shell syntax (`use`, `show dbs`, `db.coll.find()`)
+- **TLS support:** `--tls`, `--tls-cert`, `--tls-skip-verify`
+- **Auth support:** `-u` / `-p` flags
+- **JSON output:** `--output json` for scripting
+- **Tab autocomplete** in REPL mode
+
+👉 **[Full CLI Documentation](https://github.com/nexoral/AxioDB/tree/main/cli)**
+
+---
+
 ## 🔧 Troubleshooting
 
 ### "Not connected to server" right after calling `connect()`

package/cli/VERSION

@@ -0,0 +1 @@
+16.2.1

package/cli/cmd/collection.go

@@ -0,0 +1,169 @@
+package cmd
+
+import (
+	"fmt"
+
+	"github.com/nexoral/axiodb-cli/internal/config"
+	"github.com/nexoral/axiodb-cli/pkg/commands"
+	"github.com/nexoral/axiodb-cli/pkg/protocol"
+	"github.com/spf13/cobra"
+)
+
+var collectionCmd = &cobra.Command{
+	Use:   "collection",
+	Short: "Collection operations",
+}
+
+var collectionCreateCmd = &cobra.Command{
+	Use:   "create <name>",
+	Short: "Create a collection",
+	Args:  cobra.ExactArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg, err := config.FromFlags(cmd)
+		if err != nil {
+			return err
+		}
+		if cfg.DB == "" {
+			return fmt.Errorf("--db flag is required")
+		}
+		client, err := cfg.ConnectAndAuth()
+		if err != nil {
+			return err
+		}
+		defer client.Disconnect()
+
+		resp, err := commands.CreateCollection(client, cfg.DB, args[0])
+		if err != nil {
+			return err
+		}
+		return printOutput(cfg.Output, resp)
+	},
+}
+
+var collectionDeleteCmd = &cobra.Command{
+	Use:   "delete <name>",
+	Short: "Delete a collection",
+	Args:  cobra.ExactArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg, err := config.FromFlags(cmd)
+		if err != nil {
+			return err
+		}
+		if cfg.DB == "" {
+			return fmt.Errorf("--db flag is required")
+		}
+		client, err := cfg.ConnectAndAuth()
+		if err != nil {
+			return err
+		}
+		defer client.Disconnect()
+
+		resp, err := commands.DeleteCollection(client, cfg.DB, args[0])
+		if err != nil {
+			return err
+		}
+		return printOutput(cfg.Output, resp)
+	},
+}
+
+var collectionExistsCmd = &cobra.Command{
+	Use:   "exists <name>",
+	Short: "Check if a collection exists",
+	Args:  cobra.ExactArgs(1),
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg, err := config.FromFlags(cmd)
+		if err != nil {
+			return err
+		}
+		if cfg.DB == "" {
+			return fmt.Errorf("--db flag is required")
+		}
+		client, err := cfg.ConnectAndAuth()
+		if err != nil {
+			return err
+		}
+		defer client.Disconnect()
+
+		exists, err := commands.CollectionExists(client, cfg.DB, args[0])
+		if err != nil {
+			return err
+		}
+		fmt.Printf("Collection '%s' exists: %v\n", args[0], exists)
+		return nil
+	},
+}
+
+var collectionInfoCmd = &cobra.Command{
+	Use:   "info",
+	Short: "Get collection information",
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg, err := config.FromFlags(cmd)
+		if err != nil {
+			return err
+		}
+		if cfg.DB == "" {
+			return fmt.Errorf("--db flag is required")
+		}
+		client, err := cfg.ConnectAndAuth()
+		if err != nil {
+			return err
+		}
+		defer client.Disconnect()
+
+		resp, err := commands.GetCollectionInfo(client, cfg.DB)
+		if err != nil {
+			return err
+		}
+		return printOutput(cfg.Output, resp)
+	},
+}
+
+var collectionListCmd = &cobra.Command{
+	Use:   "list",
+	Short: "List all collections in a database",
+	RunE: func(cmd *cobra.Command, args []string) error {
+		cfg, err := config.FromFlags(cmd)
+		if err != nil {
+			return err
+		}
+		if cfg.DB == "" {
+			return fmt.Errorf("--db flag is required")
+		}
+		client, err := cfg.ConnectAndAuth()
+		if err != nil {
+			return err
+		}
+		defer client.Disconnect()
+
+		resp, err := commands.GetCollectionInfo(client, cfg.DB)
+		if err != nil {
+			return err
+		}
+		return printOutput(cfg.Output, resp)
+	},
+}
+
+func init() {
+	collectionCmd.AddCommand(collectionCreateCmd)
+	collectionCmd.AddCommand(collectionDeleteCmd)
+	collectionCmd.AddCommand(collectionExistsCmd)
+	collectionCmd.AddCommand(collectionInfoCmd)
+	collectionCmd.AddCommand(collectionListCmd)
+	rootCmd.AddCommand(collectionCmd)
+}
+
+func createCollection(client *protocol.Client, dbName, collName string) (*protocol.Response, error) {
+	return commands.CreateCollection(client, dbName, collName)
+}
+
+func deleteCollection(client *protocol.Client, dbName, collName string) (*protocol.Response, error) {
+	return commands.DeleteCollection(client, dbName, collName)
+}
+
+func collectionExists(client *protocol.Client, dbName, collName string) (bool, error) {
+	return commands.CollectionExists(client, dbName, collName)
+}
+
+func getCollectionInfo(client *protocol.Client, dbName string) (*protocol.Response, error) {
+	return commands.GetCollectionInfo(client, dbName)
+}