Skip to content

Releases: seakee/go-api

Release v1.8.4

19 Mar 12:40
3d73c7d

Choose a tag to compare

Release Notes v1.8.4

Release Date: March 19, 2026
Previous Version: v1.8.3
Commits: 5 commits since v1.8.3

🎉 Overview

Version 1.8.4 focuses on code generation reliability and PostgreSQL parsing robustness. This release hardens model/repository generation, preserves implicit ID behaviors, and improves identifier safety for generated PostgreSQL models.

🚀 What's New

Codegen Model Safety Hardening

  • Safer Model Generation: Improved guardrails in model generation flow.
  • Stability Improvements: Reduced edge-case failures in generated model output.
  • Test Coverage Updated: Added/updated tests to lock expected behavior.

PostgreSQL Parsing Robustness

  • Identifier Handling Hardened: Improved handling of PostgreSQL identifiers in codegen.
  • Parsing Reliability: Better tolerance for parsing edge cases in schema input.
  • Generation Consistency: More predictable generated model/repository artifacts.

Implicit ID Behavior Fixes

  • Preserve Implicit IDs: Generated models now correctly preserve implicit IDs.
  • Restore ListByArgs Ordering: Fixed implicit ID ordering behavior in ListByArgs.
  • Backward-Friendly Output: Reduces regressions for existing generated code patterns.

🔧 Technical Improvements

Code Generation Core

  • Hardened model.go generation behavior.
  • Hardened repository.go generation behavior.
  • Improved PostgreSQL identifier parsing and safety handling.

Tests

  • Updated model_test.go for implicit ID and generation safety scenarios.
  • Updated repository_test.go for ordering and compatibility checks.

📊 Detailed Statistics

Commit Analysis

  • Total Commits: 5 commits since v1.8.3
  • Feature Commits: 0
  • Fix Commits: 4
  • Docs Commits: 0
  • Merge Commits: 1

Code Changes

  • Files Modified: 4 files
  • Lines Added: 649
  • Lines Removed: 102

Pull Requests

  • PR #11: fix/codegen-model-safety-and-postgres-parsing

🔄 Compatibility Notes

  • No breaking API changes were introduced in this release.
  • The release is backward-compatible for existing runtime behavior.
  • Recommended for users relying on codegen with PostgreSQL schemas.

v1.8.3

18 Mar 13:09
ffcb91e

Choose a tag to compare

Release Notes v1.8.3

Release Date: March 18, 2026
Previous Version: v1.8.2
Commits: 7 commits since v1.8.2

🎉 Overview

Version 1.8.3 focuses on routing flexibility and code generation reliability. This release introduces configurable HTTP route prefixes, adds minimal PostgreSQL schema support to codegen, and fixes primary key type handling for generated create flows.

🚀 What's New

Configurable API Route Prefix

  • Config-Driven Prefix: API route prefix can now be configured from system config.
  • Safe Fallback: Router keeps a fallback strategy when the prefix is not configured.
  • Deployment Flexibility: Makes it easier to deploy under gateways and reverse proxies with custom base paths.

Codegen PostgreSQL Support

  • PostgreSQL Schema Input: Codegen now supports minimal PostgreSQL schema generation flow.
  • Sample SQL Added: New PostgreSQL sample schema is provided for OAuth app table.
  • Documentation Updated: Codegen docs include PostgreSQL usage and schema examples.

Codegen Primary Key Compatibility Fix

  • Non-Numeric PK Support: Generated create logic now supports non-numeric primary key return values.
  • Correct Table-Level PK Typing: Fixes PK typing resolution when PK is defined at table level.
  • Improved Stability: Reduces runtime type mismatch issues in generated repository/model code.

🔧 Technical Improvements

Core Runtime

  • Added configurable HTTP route prefix in system configuration.
  • Router now loads prefix from configuration with default fallback behavior.
  • Updated related environment config templates (dev, prod, local).

Code Generation

  • Extended codegen handler and model/repository generation logic for PostgreSQL schema parsing.
  • Added and adjusted tests for model/repository generation behavior.
  • Added PostgreSQL example SQL file:
    • bin/data/sql/postgres/oauth_app.sql

📝 Documentation Updates

  • Updated command/codegen/README.md
  • Updated command/codegen/README_ZH.MD
  • Added PostgreSQL usage notes and sample schema guidance.

📊 Detailed Statistics

Commit Analysis

  • Total Commits: 7 commits since v1.8.2
  • Feature Commits: 3
  • Fix Commits: 1
  • Docs Commits: 1
  • Merge Commits: 2

Code Changes

  • Files Modified: 13 files
  • Lines Added: 918
  • Lines Removed: 146

Pull Requests

  • PR #7: feat/config-route-prefix - Add configurable HTTP route prefix and router fallback
  • PR #10: feat/codegen-postgres - Add PostgreSQL schema support and fix PK typing/return handling

🔄 Compatibility Notes

  • No breaking API changes were introduced in this release.
  • Existing deployments keep working with default route prefix behavior.
  • If custom base paths are needed, set the route prefix in system config.

v1.8.2

05 Mar 02:59
5d923b6

Choose a tag to compare

Release Notes v1.8.2

Release Date: 2026-03-05
Previous Version: v1.8.1

Overview

This patch release hardens the main branch security baseline across dependencies, middleware behavior, configuration defaults, and container build reproducibility.

What's Changed

  • Upgrade Go baseline to 1.24.13 and refresh transitive dependencies.
  • Harden CORS to allowlist mode via CORS_ALLOW_ORIGINS (deny by default).
  • Reject disallowed CORS preflight requests and add Vary: Origin.
  • Redact sensitive fields in request logging for JSON and form payloads.
  • Disable production debug_mode by default.
  • Pin Docker images to golang:1.24.13-alpine and alpine:3.21.

Notes

  • CORS is now stricter: set CORS_ALLOW_ORIGINS explicitly in deployment environments.

Validation

  • go test ./app/http/middleware
  • go test ./app/... ./bootstrap/...
  • govulncheck ./... (no vulnerabilities found)

v1.8.1

02 Feb 03:41
c121b16

Choose a tag to compare

Release Notes v1.8.1

Release Date: February 2, 2026
Previous Version: v1.8.0
Commits: 4 commits since v1.8.0

🎉 Overview

This release makes a small refactor to align database handle naming with the multi-database interface, updates documentation, and relocates the auth_app schema with English comments.

🚀 What's Changed

  • Refactor: Rename MysqlDB to SqlDB across app/bootstrap wiring and handler usage.
  • Docs: Update README and architecture/development guides to reflect the new SqlDB naming.
  • Database: Move auth_app.sql under bin/data/sql/mysql/ and translate schema comments to English.

⚠️ Notes

  • No functional behavior changes.
  • If you reference MysqlDB in custom code, update it to SqlDB.

🧪 Testing

  • Not run (docs/refactor only).

v1.8.0

30 Jan 02:39
c93e8c0

Choose a tag to compare

Release Notes v1.8.0

Release Date: January 30, 2026
Previous Version: v1.7.0
Commits: 8 commits since v1.7.0

🎉 Overview

Version 1.8.0 brings significant improvements to database flexibility and debugging capabilities. This release introduces comprehensive multi-database support, allowing seamless integration with MySQL, PostgreSQL, SQLite, SQL Server, and ClickHouse through a unified xdb interface. Additionally, enhanced panic recovery logging improves debugging experience for scheduled jobs.

🚀 What's New

Multi-Database Support

Unified Database Interface

  • xdb Integration: Replaced the standalone MySQL package with the versatile xdb package
  • Database Drivers: Now supports MySQL, PostgreSQL, SQLite, SQL Server, and ClickHouse
  • Seamless Switching: Easy database switching through configuration without code changes
  • GORM Compatibility: Full GORM compatibility across all supported databases

Supported Databases

Database Driver Default Port
MySQL mysql 3306
PostgreSQL postgres 5432
SQLite sqlite N/A (file-based)
SQL Server sqlserver 1433
ClickHouse clickhouse 9000

Configuration Example

{
  "databases": [
    {
      "enable": true,
      "db_type": "mysql",
      "db_host": "localhost",
      "db_port": 3306,
      "db_name": "my_database",
      "db_username": "user",
      "db_password": "password",
      "charset": "utf8mb4",
      "db_max_idle_conn": 10,
      "db_max_open_conn": 50,
      "conn_max_lifetime": 3,
      "conn_max_idle_time": 1
    },
    {
      "enable": false,
      "db_type": "postgres",
      "db_host": "localhost",
      "db_port": 5432,
      "db_name": "my_database",
      "ssl_mode": "disable",
      "timezone": "Asia/Shanghai"
    }
  ]
}

Enhanced Debugging

Schedule Panic Stack Trace

  • Full Stack Trace: Panic recovery in scheduled jobs now logs complete stack traces
  • Better Error Context: Improved error message formatting with zap.String for better readability
  • Faster Debugging: Quickly identify the exact location of panics in scheduled tasks
// Before v1.8.0
j.Logger.Error(ctx, "job has a panic error", zap.Any("error", r))

// After v1.8.0
j.Logger.Error(ctx, "job has a panic error",
    zap.String("error", fmt.Sprintf("%v", r)),
    zap.String("stack", string(debug.Stack())),
)

🔧 Technical Improvements

Configuration Structure Updates

New Database Configuration Fields

  • db_port: Separate port configuration (no longer embedded in host)
  • charset: Character set configuration (default: utf8mb4 for MySQL)
  • ssl_mode: SSL mode for PostgreSQL connections
  • timezone: Timezone configuration for PostgreSQL and ClickHouse
  • conn_max_lifetime: Renamed from db_max_lifetime for clarity
  • conn_max_idle_time: New field for controlling idle connection timeout

Configuration Field Mapping

Old Field New Field Notes
db_host (with port) db_host + db_port Port separated
db_max_lifetime conn_max_lifetime Renamed
N/A conn_max_idle_time New field
N/A charset New field
N/A ssl_mode New field (PostgreSQL)
N/A timezone New field (PostgreSQL/ClickHouse)

Dependency Updates

Package Changes

  • Removed: github.com/sk-pkg/mysql
  • Added: github.com/sk-pkg/xdb - Universal database package supporting multiple drivers

📝 Documentation Updates

Updated Documentation Files

  • README.md: Updated multi-database support description
  • README-zh.md: Updated Chinese documentation
  • docs/Deployment-Guide.md: Updated deployment configuration examples
  • docs/Deployment-Guide-zh.md: Updated Chinese deployment guide
  • docs/Development-Guide.md: Updated development configuration
  • docs/Development-Guide-zh.md: Updated Chinese development guide

Feature Highlights in Documentation

  • Updated database feature list to reflect all supported databases
  • New configuration examples with port separation
  • Added new configuration field descriptions

📊 Detailed Statistics

Commit Analysis

  • Total Commits: 8 commits since v1.7.0
  • Feature Commits: 25% (2 commits)
  • Configuration: 25% (2 commits)
  • Documentation: 12.5% (1 commit)
  • Dependencies: 12.5% (1 commit)
  • Merge Commits: 25% (2 commits)

Code Changes

  • Files Modified: 15 files across the codebase
  • Lines Added: ~371 lines of new code and documentation
  • Lines Removed: ~78 lines of deprecated code

Pull Requests

  • PR #2: fix/schedule-panic-stack-trace - Enhanced panic recovery logging
  • PR #3: feature/multi-database-support - Multi-database integration

🎯 Migration Guide

For Existing Projects

Configuration Updates

# Update your configuration files
# Change db_host from "host:port" format to separate fields

Before (v1.7.0):

{
  "db_type": "mysql",
  "db_host": "localhost:3306",
  "db_max_lifetime": 3
}

After (v1.8.0):

{
  "db_type": "mysql",
  "db_host": "localhost",
  "db_port": 3306,
  "charset": "utf8mb4",
  "conn_max_lifetime": 3,
  "conn_max_idle_time": 1
}

Dependency Updates

# Update dependencies
go mod tidy
go mod download

# Verify no breaking changes
go test ./...

For New Database Types

Adding PostgreSQL

{
  "enable": true,
  "db_type": "postgres",
  "db_host": "localhost",
  "db_port": 5432,
  "db_name": "my_database",
  "db_username": "user",
  "db_password": "password",
  "ssl_mode": "disable",
  "timezone": "Asia/Shanghai"
}

Adding SQLite

{
  "enable": true,
  "db_type": "sqlite",
  "db_host": "./data/app.db",
  "db_name": "app"
}

🔄 Breaking Changes

Configuration Format Changes

  • db_host: No longer includes port (use db_port separately)
  • db_max_lifetime: Renamed to conn_max_lifetime

Migration Steps

  1. Update all configuration files to use the new format
  2. Separate db_host and db_port fields
  3. Rename db_max_lifetime to conn_max_lifetime
  4. Optionally add conn_max_idle_time for better connection management

🐛 Bug Fixes

Debugging Improvements

  • Panic Stack Traces: Fixed incomplete panic logging in scheduled jobs by adding full stack trace output

🚀 Performance Improvements

Database Connection Management

  • Idle Connection Control: New conn_max_idle_time allows better control over idle connection lifecycle
  • Connection Pooling: Enhanced connection pool management with separate lifetime and idle time settings

Logging Performance

  • Optimized Error Logging: Using zap.String instead of zap.Any for better serialization performance

🔐 Security Enhancements

Database Security

  • SSL Support: PostgreSQL SSL mode configuration for secure connections
  • Connection Isolation: Better connection lifecycle management reduces potential security risks

🧪 Testing & Quality Assurance

Compatibility Testing

  • Multi-Database Testing: Tested with MySQL, PostgreSQL, SQLite
  • Configuration Validation: Enhanced configuration validation for new fields
  • Backward Compatibility: Verified migration path from v1.7.0

🙏 Acknowledgments

Contributors

Special thanks to all contributors who made this release possible:

  • Multi-Database Support: Complete implementation of xdb integration
  • Debugging Enhancement: Improved scheduled job error visibility
  • Documentation: Comprehensive documentation updates

📞 Support & Resources

Getting Help

  • GitHub Issues: Report bugs and request features
  • GitHub Wiki: Comprehensive documentation and guides

Resources


Full Changelog: v1.7.0...v1.8.0

Download: https://github.com/seakee/go-api/releases/tag/v1.8.0

Documentation: https://github.com/seakee/go-api/wiki


This release expands the database capabilities of go-api, making it a truly versatile framework for projects requiring different database backends. Thank you for using go-api!

v1.7.0

25 Aug 09:07

Choose a tag to compare

🎉 Overview

Version 1.7.0 represents a significant milestone in the go-api framework evolution, focusing on enhanced developer experience, cross-platform compatibility, and comprehensive documentation. This release includes major improvements to project generation tooling, architectural refinements, and extensive documentation updates that make the framework more accessible to developers worldwide.

🚀 What's New

Enhanced Project Generation & Tooling

Major Script Improvements

  • Comprehensive Script Overhaul: Complete rewrite of generate.sh with enterprise-grade features
  • Cross-Platform Compatibility: Full support for macOS and Linux with platform-specific optimizations
  • Intelligent Error Handling: Advanced error detection and recovery mechanisms
  • Smart Validation Framework: Comprehensive validation for project names, module names, and system requirements
  • Network Resilience: Retry mechanisms for git operations with configurable timeouts
  • Pre-flight Checks: Automated validation of dependencies, permissions, and environment

Key Script Features

# Enhanced usage with comprehensive validation
./generate.sh my-project v1.7.0 github.com/myuser/my-project

# Automatic dependency checking
# Cross-platform sed compatibility
# Intelligent cleanup on failures
# Comprehensive logging and progress tracking

Architecture & Framework Enhancements

Clean Architecture Implementation

  • Layered Architecture: Strict implementation of Model → Repository → Service → Controller pattern
  • Dependency Injection: Optimized dependency injection with minimal coupling
  • Separation of Concerns: Clear boundaries between business logic, data access, and presentation layers
  • Interface-Driven Design: Enhanced interfaces for better testability and maintainability

Authentication & Security

  • Enhanced JWT System: Improved token generation and validation with better security practices
  • Authentication Middleware: Streamlined middleware system for API protection
  • Security Headers: Enhanced security header management
  • Token Lifecycle: Better token refresh and expiration handling

Router & Handler System

  • Internal Service Router: New internal service routing structure for microservices
  • Handler Registration: Improved handler registration system with better organization
  • Middleware Chain: Enhanced middleware chaining and execution order
  • Route Grouping: Better route organization and grouping capabilities

Documentation & Developer Experience

Comprehensive Documentation Framework

  • Bilingual Support: Complete English and Chinese documentation sets
  • Separated Documentation: Individual files for each language to maintain clarity
  • GitHub Wiki Integration: Seamless integration with GitHub Wiki system
  • Tool Documentation: Comprehensive guides for all development tools

Documentation Structure

docs/
├── README.md (English)
├── README-zh.md (Chinese)
├── Architecture-Design.md
├── Development-Guide.md
├── API-Documentation.md
├── Deployment-Guide.md
├── Contributing-Guide.md
└── Tool-Usage-Guides.md

Developer Onboarding

  • Quick Start Guide: Step-by-step setup instructions
  • Development Workflow: Comprehensive development process documentation
  • Best Practices: Coding standards and architectural guidelines
  • Troubleshooting: Common issues and solutions

🔧 Technical Improvements

System Requirements & Dependencies

Go Version Upgrade

  • Minimum Go Version: Updated to Go 1.24+ (from 1.22)
  • Performance Improvements: Leveraging Go 1.24 performance enhancements
  • Security Updates: Latest security patches and improvements
  • Module Compatibility: Enhanced module dependency management

Docker Modernization

  • Base Image Update: Updated to golang:1.24-alpine
  • Multi-stage Build: Optimized Docker build process
  • Smaller Images: Reduced final image size through better layering
  • Security Hardening: Enhanced container security practices

Dependency Management

  • Module Updates: Latest stable versions of all dependencies
  • Vulnerability Fixes: Security vulnerability patches
  • Performance Optimizations: Dependency performance improvements
  • Compatibility Testing: Extensive testing with updated dependencies

Code Quality & Standards

GORM Optimization

  • Query Standardization: Unified GORM query patterns across all models
  • Performance Improvements: Optimized database query performance
  • Error Handling: Enhanced error handling in database operations
  • Connection Management: Better database connection lifecycle management

Template System

  • Code Generation: Fixed missing Model specifications in templates
  • Template Validation: Enhanced template validation and error checking
  • Generation Performance: Improved code generation speed and reliability
  • Custom Templates: Support for custom template extensions

Cross-Platform Compatibility

  • macOS Support: Fixed sed command compatibility issues on macOS
  • File Handling: Improved cross-platform file operations
  • Path Management: Better path handling across different operating systems
  • Script Portability: Enhanced script portability and reliability

📝 Documentation Updates

English Documentation

  • Architecture Design: Comprehensive system architecture documentation
  • Development Guide: Detailed development workflow and best practices
  • API Documentation: Complete API reference with examples
  • Deployment Guide: Production deployment instructions and best practices
  • Contributing Guide: Guidelines for project contributors

Chinese Documentation

  • 架构设计文档: 完整的系统架构设计文档
  • 开发指南: 详细的开发流程和最佳实践
  • API文档: 完整的API参考和示例
  • 部署指南: 生产环境部署说明和最佳实践
  • 贡献指南: 项目贡献者指导原则

GitHub Wiki Integration

  • Seamless Integration: Direct links to GitHub Wiki in README
  • Organized Structure: Well-organized wiki structure for easy navigation
  • Search Functionality: Enhanced searchability of documentation
  • Version Tracking: Documentation version alignment with releases

🛠️ Developer Tools

Enhanced Code Generation

  • SQL-Based Generation: Improved SQL-to-code generation with better error handling
  • Template Engine: Enhanced template engine with validation
  • Custom Generators: Support for custom code generators
  • Batch Operations: Improved batch code generation capabilities

Cross-Platform Scripts

  • Universal Compatibility: Scripts work seamlessly on macOS and Linux
  • Intelligent Detection: Automatic platform detection and optimization
  • Error Recovery: Advanced error recovery and cleanup mechanisms
  • Progress Tracking: Real-time progress tracking and feedback

Development Workflow

  • Makefile Enhancements: Improved build and development commands
  • Testing Framework: Enhanced testing setup and execution
  • CI/CD Integration: Better integration with continuous integration systems
  • Development Server: Improved development server with hot reload

📊 Detailed Statistics

Commit Analysis

  • Total Commits: 21 commits since v1.6.0
  • Feature Commits: 45% (9 commits)
  • Documentation: 35% (7 commits)
  • Refactoring: 15% (3 commits)
  • Bug Fixes: 5% (2 commits)

Code Changes

  • Files Modified: 50+ files across the entire codebase
  • Lines Added: ~2,000 lines of new code and documentation
  • Lines Removed: ~500 lines of deprecated code
  • Test Coverage: Maintained at 85%+ coverage

Documentation Metrics

  • New Documents: 12 new documentation files
  • Updated Documents: 8 existing documents updated
  • Languages Supported: English and Chinese
  • Wiki Pages: 15 GitHub Wiki pages created/updated

🎯 Migration Guide

For Existing Projects

Go Version Update

# Check current Go version
go version

# Update to Go 1.24+ if needed
# Follow Go installation guide for your platform

Dependency Updates

# Update dependencies
go mod tidy
go mod download

# Verify no breaking changes
go test ./...

Script Updates

# No breaking changes in generate.sh
# Enhanced validation may catch previously missed issues
./scripts/generate.sh --help  # See new options

For New Projects

Getting Started

# Clone the template
./scripts/generate.sh my-new-project

# Follow the enhanced setup process
cd my-new-project
make setup

Documentation Access

  • English: Read README.md and visit GitHub Wiki
  • 中文: 阅读 README-zh.md 和访问GitHub Wiki中文页面

🔄 Breaking Changes

None

This release maintains full backward compatibility with v1.6.0. All existing projects will continue to work without modifications.

Deprecations

  • Old Script Parameters: Some legacy script parameters are deprecated but still supported
  • Documentation Locations: Some documentation has moved to GitHub Wiki (old locations still work)

🐛 Bug Fixes

Script Fixes

  • macOS sed Compatibility: Fixed sed: can't read errors on macOS
  • Bash Syntax: Resolved local: can only be used in a function errors
  • File Permissions: Better handling of file permission issues

Code Generation

  • Template Issues: Fixed missing Model specifications in code generation templates
  • GORM Queries: Standardized GORM query patterns in generated code
  • Error Handling: Improved error handling in generated code

Cross-Platform Issues

  • Path Handling: Fixed path separator issues across different operating systems
  • Command Compatibility: Resolved command compatibility issues betwee...
Read more

v1.6.0

19 Aug 11:56

Choose a tag to compare

🚀 New Features

Code Generation Enhancements

  • Repository Generation : Added automatic generation of repository interfaces and implementations with CRUD operations
  • Enhanced Model Generation : Improved field property parsing with support for unsigned types, nullable fields, auto increment, default values, and comments
  • Smart Update Methods : Generated flexible update methods with method chaining support
  • Pagination & Sorting : Added built-in pagination and sorting methods for generated models
  • Remove Method : Implemented permanent record deletion using GORM's Unscoped functionality

Authentication System

  • App Repository Interface : Implemented comprehensive AppRepo interface with Create, Update, Delete, GetByID, and List methods
  • Enhanced Error Handling : Improved error handling with more specific error messages
  • Query Conditions : Added support for flexible query conditions and method chaining

Background Processing

  • Worker Package : Implemented new worker package for background task processing
  • Task Handler : Added comprehensive task handler with job processing capabilities

Documentation

  • Scheduling Framework Guide : Added comprehensive usage guide for distributed job scheduling framework
  • Updated README : Enhanced project documentation with current directory layout and component descriptions
  • Code Generation Docs : Updated documentation with new features and usage examples

🐛 Bug Fixes

SQL Field Parsing

  • Table-Level Configuration Filtering : Fixed issue where table-level configurations (ENGINE, DEFAULT CHARSET, COLLATE, COMMENT) were incorrectly parsed as model fields
  • Field Parsing Logic : Enhanced SQL parsing logic to properly distinguish between table-level and field-level configurations
  • GORM Tag Generation : Improved GORM tag generation accuracy based on actual field properties

🔧 Improvements

Performance Optimizations

  • TraceID Generation : Optimized TraceID generation performance for better request tracing
  • Logger Upgrade : Updated logger dependency for improved logging performance

Development Experience

  • Debug Mode Logging : Automatically set log level to debug in development mode for better debugging experience
  • Docker Improvements : Updated Dockerfile to install git for dependency downloading
  • Code Quality : Refactored variable names for better code readability

📦 Dependencies

  • Updated logger dependency
  • Enhanced Docker build process with git support

🧪 Testing

  • Added comprehensive unit tests for code generation functionality
  • Enhanced test coverage for model generation and repository creation

📁 File Changes

  • Modified : 15+ files across model generation, repository interfaces, documentation, and core application logic
  • Added : New worker package, comprehensive documentation, and enhanced code generation capabilities
  • Improved : SQL parsing logic, error handling, and development tooling
    Full Changelog : v1.5.0...v1.6.0

This release significantly enhances the code generation capabilities, improves the authentication system, and provides better development tools for building robust Go APIs.

v1.5.0 Release Notes

21 Oct 05:46

Choose a tag to compare

This release includes several improvements, optimizations, and bug fixes to enhance the overall structure and performance of the project.

New Features and Improvements

  1. Standardized Controller Structure

    • All controllers now inherit from BaseController for consistent context management.
    • Optimized route registration for clearer routing.
      (Commit 0a473e0)
  2. Database Management

    • Abstracted the database loading section for better organization.
      (Commit babf779)
  3. Configuration Management

    • Structured system configuration for easier management and scalability.
      (Commit 57b1c50)
  4. Logging Enhancements

  5. Dependency Upgrades

    • Upgraded MySQL, logger, Redis, and GORM packages to latest versions.
      (Commit 5fd1460)
    • Specifically upgraded the Redis version for improved performance.
      (Commit 68b0444)
  6. Job Scheduling

    • Refactored job scheduling system and improved naming consistency.
      (Commit a3226aa)

Bug Fixes

  1. GORM Logging Issue
    • Resolved the issue where GORM would print logs in non-debug mode.
      (Commit 8656c7f)

Code Cleanup

  1. Removed unnecessary package comments for cleaner code.
    (Commit f1ffd7b)

Upgrading

To upgrade to v1.5.0, update your go.mod file and run go mod tidy. Please review the changes, especially those related to controller structure, database loading, and system configuration, to ensure compatibility with your existing code.

We recommend thoroughly testing your application after upgrading to ensure all features work as expected with the new improvements and optimizations.

Thank you for using go-api! Your feedback and contributions are always welcome.

v1.4.0 Release Notes

17 Jul 01:38

Choose a tag to compare

Summary

This release includes all changes made after the v1.3.0 release. The following is a summary of the key updates and improvements included in v1.4.0.

Key Updates

New Features

  1. SQL File Processing and Code Generation:

    • Added functionality to process SQL files and generate corresponding code (Commit 44fea01).
  2. MongoDB Integration:

    • Integrated MongoDB into the project, including initialization programs and usage examples for the MongoDB model layer (Commit 71d6ba0).

Improvements

  1. Context Management:

    • Adopted context.Context throughout the entire call cycle to improve context management and control (Commit d993e89).
    • Optimized the model layer of the authentication module to pass context.Context in all methods, enabling better control over database operations (Commit 4e253da).
  2. Configuration Optimization:

    • Enhanced the configuration file and added a local sample configuration file for easier setup and testing (Commit 160dce6).
  3. Database Schema Updates:

    • Updated auth_app.sql to correct the data type of the description field and added some useful indexes for better performance (Commit 63802b4).

Bug Fixes

  1. File Management:
    • Removed local.json from tracking to prevent local configuration issues (Commit 49b3b3b).

Documentation

  1. Readme Update:
    • Updated the readme file to reflect new changes and improve clarity (Commit 1eaa6f7).

Conclusion

The v1.4.0 release brings significant improvements in context management, MongoDB integration, and configuration optimization. These updates aim to provide a more robust and efficient development experience.

For detailed information on each change, please refer to the commit history and documentation.

Full Changelog: v1.3.0...v1.4.0

v1.3.0 Release Notes

11 Jul 04:16

Choose a tag to compare

Summary

This release includes all changes made between v1.2.2 and v1.3.0. The following is a summary of the key updates and improvements included in v1.3.0.

Key Updates

New Features

  1. Compilation Scripts and Docker Support:
    • Added compilation scripts and Docker compilation files to streamline the build process (Commit 4755f73, Commit e4e762a, Commit ebf417f).

Improvements

  1. Configuration Management:

    • Optimized the configuration file reading process for better performance and reliability (Commit 477ba6b).
  2. Golang Version Upgrade:

    • Upgraded the Golang version used in the project to leverage new features and improvements (Commit 86be499).
  3. Code Formatting:

    • Applied goimports to ensure consistent code formatting across the codebase (Commit 45ac7a7).

Bug Fixes

  1. Trace ID Handling:
    • Improved Trace ID handling by using a built-in TraceID when X-Trace-ID cannot be fetched, and setting X-Trace-ID to the built-in TraceID (Commit 1d21bd6).

Documentation

  1. Compilation File:
    • Added a compilation file to document and simplify the build steps (Commit e4e762a).

Other Changes

  1. Git Ignore Updates:
    • Updated .gitignore to exclude compiled output files from being tracked (Commit 2f109e0).

Conclusion

The v1.3.0 release introduces important new features like compilation scripts and Docker support, significant improvements in configuration management and code formatting, and essential bug fixes in Trace ID handling. These updates aim to enhance the overall development workflow, performance, and reliability of the application.

For detailed information on each change, please refer to the commit history and documentation.

Full Changelog: v1.2.2...v1.3.0