luckdb 0.1.4

A Lightweight JSON Document Database in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# Changelog


All notable changes to LuckDB will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.1.3] - 2025-11-23


### Added

- **LuckDB Server CLI** (`luckdb-server-cli`) - Comprehensive command-line interface for server management
  - Command-line argument parsing with Clap
  - Configuration file support with TOML format
  - Environment variable overrides for all settings
  - Signal handling for graceful shutdown (Ctrl+C)
  - Structured logging with multiple levels and output options
  - Security features: AES-256 encryption, authentication
  - Multi-environment configuration templates (dev/prod/test)
  - Comprehensive help documentation

- **CLI Dependencies**
  - `clap` - Command-line argument parsing
  - `tracing` and `tracing-subscriber` - Structured logging
  - `ctrlc` - Signal handling
  - `anyhow` - Enhanced error handling

- **Convenience Scripts**
  - `run-server.sh` - Linux/macOS build and run script
  - `run-server.bat` - Windows build and run script

- **Documentation**
  - `CLI_README.md` - Comprehensive CLI tool documentation
  - Updated main README with CLI information
  - Enhanced code documentation in `src/lib.rs` and `src/config.rs`
  - Comprehensive configuration examples and best practices

- **Configuration Management**
  - Enhanced `DatabaseConfig` with detailed documentation
  - Improved configuration validation and error handling
  - Better file storage path management (fixed directory creation issue)
  - Enhanced configuration file generation

### Fixed

- **Storage Path Creation Bug** - Fixed issue where `get_or_create_storage_path` was creating files as directories instead of creating parent directories only
- **Configuration File Structure** - Fixed TOML serialization structure for better compatibility

### Enhanced

- **Documentation** - Comprehensive updates to all code documentation with examples, security notes, and best practices
- **Error Messages** - More detailed and helpful error messages throughout the codebase
- **Configuration Validation** - Improved validation with clearer error reporting
- **Examples** - Added comprehensive usage examples for all major features

### Breaking Changes

- **Binary Target** - Added new binary target `luckdb-server-cli` for the CLI tool
- **Dependencies** - Added new CLI-specific dependencies (clap, tracing, etc.)

## [0.1.2] - Previous Release

- Core LuckDB functionality
- Document storage and querying
- Basic encryption and authentication
- Client-server mode