52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
|
# Changelog
|
||
|
|
|
||
|
|
All notable changes to this project 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).
|
||
|
|
|
||
|
|
## [1.0.0] - 2025-09-30
|
||
|
|
|
||
|
|
### Added
|
||
|
|
- Initial release as standalone tool
|
||
|
|
- Extracted from go-zero project and made independent
|
||
|
|
- Support for converting go-zero `.api` files to OpenAPI 2.0 (Swagger) specification
|
||
|
|
- JSON and YAML output formats
|
||
|
|
- Command-line interface using cobra
|
||
|
|
- Support for all go-zero API features:
|
||
|
|
- Info properties (title, description, version, host, basePath, etc.)
|
||
|
|
- Type definitions (structs, arrays, maps, pointers)
|
||
|
|
- Tag-based parameter handling (json, form, path, header)
|
||
|
|
- Validation options (range, enum, default, example, optional)
|
||
|
|
- Security definitions
|
||
|
|
- Code-msg wrapper for responses
|
||
|
|
- Definition references
|
||
|
|
- Internal utility functions to replace go-zero dependencies
|
||
|
|
- Comprehensive documentation
|
||
|
|
- Example API files
|
||
|
|
- Makefile for easy building
|
||
|
|
- MIT License
|
||
|
|
|
||
|
|
### Changed
|
||
|
|
- Module name from `github.com/zeromicro/go-zero` to `go-doc`
|
||
|
|
- Removed dependency on `go-zero/tools/goctl/internal/version`
|
||
|
|
- Removed dependency on `go-zero/tools/goctl/util/*`
|
||
|
|
- Removed dependency on `google.golang.org/grpc/metadata`
|
||
|
|
- Project structure reorganized to follow Go best practices
|
||
|
|
- `cmd/go-doc/` for main entry point
|
||
|
|
- `internal/swagger/` for core logic
|
||
|
|
- `internal/util/` for utilities
|
||
|
|
|
||
|
|
### Removed
|
||
|
|
- Dependency on go-zero runtime components
|
||
|
|
- Go-zero specific version information
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Attribution
|
||
|
|
|
||
|
|
This project was originally part of the [go-zero](https://github.com/zeromicro/go-zero)
|
||
|
|
project's swagger generation plugin. We are grateful to the go-zero team for their
|
||
|
|
excellent work.
|
||
|
|
|