Skip to content

v1.3.4 - Code Quality, Documentation & Examples Enhancement (2026-01-08)

Choose a tag to compare

View all tags
@cybergodev cybergodev released this 08 Jan 11:29
· 64 commits to main since this release
v1.3.4
69d185f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Code Quality

  • Eliminated code duplication: Removed duplicate validateHeaderKeyValue function from types.go, unified to use internal/validation package
  • Performance optimizations: Replaced fmt.Sprintf with strconv.Itoa/FormatInt for 2-3x faster integer conversions
  • Memory optimizations: Changed to fixed-size arrays in FormatBytes() and FormatSpeed() to eliminate heap allocations
  • Loop optimizations: Improved iteration patterns in validation and parsing functions
  • Simplified logic: Streamlined URL building in domain_client.go, removed redundant parsing
  • Code cleanup: Removed redundant comments and verbose validation logic across validation and security packages

Documentation

  • README improvements: Fixed variable naming consistency (resp → result), added missing API documentation
  • API completeness: Documented WithXML(), WithText(), WithBinary(), HasCookie(), RequestCookies(), GetRequestCookie(), SaveToFile()
  • Docs verification: Comprehensive verification of all 8 docs files, added missing WithCookieString documentation
  • Chinese README: Synchronized all changes to maintain translation consistency
  • Accuracy: Improved from 98% to 100% documentation accuracy

Examples

  • Major restructuring: Reduced from 30+ files across 6 directories to 12 files across 3 directories (60% reduction)
  • Consolidated examples: Merged related examples into comprehensive files:
    • request_options.go - merged 3 files covering body formats, auth, query params
    • response_handling.go - merged 3 files covering Result API, parsing, formatting
    • file_operations.go - merged 2 files covering upload/download
    • cookies_advanced.go - merged 5 files covering all cookie operations
    • domain_client.go - merged 4 files covering DomainClient usage
  • Quality improvements: Enhanced error handling, better documentation, reliable endpoints (httpbin.org)
  • Bug fixes: Fixed 6 compilation errors where method calls were missing parentheses (.StatusCode → .StatusCode())
  • README guides: Created comprehensive examples/README.md with learning paths and directory-specific guides

Bug Fixes

  • Fixed localhost detection logic in internal/security/validator.go
  • Fixed URL sanitization for fragments in internal/engine/errors.go
  • Fixed transport error classification patterns
  • Fixed API usage bugs in example files (method calls vs field access)

Impact

  • Code size: Reduced by ~1,000 lines through consolidation and optimization
  • Performance: 2-3x faster integer conversions, eliminated heap allocations in hot paths
  • Maintainability: Single source of truth for validation, better organized tests and examples
  • Developer experience: Complete and accurate documentation, high-quality consolidated examples
  • Backward compatibility: Zero breaking changes, all tests pass
Assets 2
Loading