# Changelog ## [1.4.2](https://github.com/DeRuina/timberjack/compare/v1.4.1...v1.4.2) (2026-04-21) ### Features * feat: add Sync() method satisfying zapcore.WriteSyncer ([#100](https://github.com/DeRuina/timberjack/pull/100)) ([0e0e326](https://github.com/DeRuina/timberjack/commit/0e0e326196131c28ebca14e60befd79c5032a287)) * test: adapt test cases for Windows 10 environment ([#95](https://github.com/DeRuina/timberjack/pull/95)) ([cb7fbef](https://github.com/DeRuina/timberjack/commit/cb7fbefa63a0a2653005ca2775ed1e300e242a5c)) * fix: atomic compress write and content-based backup assertions to eliminate race failures ([#97](https://github.com/DeRuina/timberjack/pull/97)) ([0d444ed](https://github.com/DeRuina/timberjack/commit/0d444edc5e38efd580b519feaa9176516d31d2ee)) ## [1.4.1](https://github.com/DeRuina/timberjack/compare/v1.4.0...v1.4.1) (2026-04-02) ### Features * Fix preserve configured FileMode after rotation (umask bypass) ([#91](https://github.com/DeRuina/timberjack/pull/91)) ([b9823ec](https://github.com/DeRuina/timberjack/commit/b9823ec5950b3e5d8d104ce620c32414e83f5f22)) ## [1.4.0](https://github.com/DeRuina/timberjack/compare/v1.3.9...v1.4.0) (2026-03-11) ### Features * Fix duplicate rotation triggered by Write() after manual Rotate()/RotateWithReason() ([#84](https://github.com/DeRuina/timberjack/pull/84)) ([5aee542](https://github.com/DeRuina/timberjack/commit/5aee54253be72151c63904390195a34c0da05cf8)) * Fix Windows file locking in compressLogFile ([#65](https://github.com/DeRuina/timberjack/pull/65)) ([a560a29](https://github.com/DeRuina/timberjack/commit/a560a29cb76a7d6350c83f29b375a991c1a51a6d)) ## [1.3.9](https://github.com/DeRuina/timberjack/compare/v1.3.8...v1.3.9) (2025-10-21) ### Features * Make FileMode for newly created files configurable ([#59](https://github.com/DeRuina/timberjack/pull/59)) ([82320e6](https://github.com/DeRuina/timberjack/commit/82320e6d10084bf4cb32a80ced28175f66d15214)) ## [1.3.8](https://github.com/DeRuina/timberjack/compare/v1.3.7...v1.3.8) (2025-10-15) ### Fixes & Improvements * ([4c2c743](https://github.com/DeRuina/timberjack/commit/4c2c7433979b88b308dc927f10c95ee0fa221327)) * Eliminated multiple data races in concurrent rotations and mill goroutines. Internal logic now snapshots configuration and system functions once for each logger instance to ensure safe concurrent use. * Added deterministic shutdown for background goroutines (`mill` and `scheduled rotation`) via `WaitGroup` synchronization, preventing premature exits or leaks. * Strengthened `Close()` to wait safely for goroutine completion without holding locks. * Improved test suite: - Fake clock (`fakeCurrentTime`) is now lock-protected to avoid race conditions. - Tests force UTC for consistent local-time behavior. - CI now runs with `go test -race` to verify concurrency safety. ### Internal Changes * Introduced `resolveConfigLocked()` for snapshotting logger configuration (time, compression, stat/rename/remove functions) at initialization. * Simplified mill and rotation goroutine lifecycle management. * Minor refactoring for clarity and reduced global variable reads. ## [1.3.7](https://github.com/DeRuina/timberjack/compare/v1.3.6...v1.3.7) (2025-09-19) ### Features * `zstd` compression support for rotated files ([#38](https://github.com/DeRuina/timberjack/issues/38)) ([626a5bd](https://github.com/DeRuina/timberjack/pull/43/commits/626a5bd5c4b45eab8d73b906716cf4587ca5aa64)) * Manual rotate with custom reason ([#39](https://github.com/DeRuina/timberjack/issues/39)) ([cf751aa](https://github.com/DeRuina/timberjack/pull/43/commits/cf751aa14d312ecf8153234c9c57ff50ff277700)) ### Chnaged * Rename AppendAfterExt to AppendTimeAfterExt ([#37](https://github.com/DeRuina/timberjack/issues/37)) ([fea97b9](https://github.com/DeRuina/timberjack/pull/43/commits/fea97b9985f939a7f05df7a7f3f458c8b4ab02d9)) ### Deprecated - `Compress` (bool) is deprecated in favor of `Compression` (`"none" | "gzip" | "zstd"`). If `Compression` is set, it **wins**; if it’s empty and `Compress` is `true`, gzip is used. `Compress` will be removed in **v2**. ## [1.3.6](https://github.com/DeRuina/timberjack/compare/v1.3.5...v1.3.6) (2025-09-16) ### Features * Append the backupTimeFormat to the end of file name ([#37](https://github.com/DeRuina/timberjack/issues/37)) ([15c6d81](https://github.com/DeRuina/timberjack/commit/15c6d813214c9c7f1372af55f9b705d9d2a3a88e)) ## [1.3.5](https://github.com/DeRuina/timberjack/compare/v1.3.4...v1.3.5) (2025-08-19) ### Features * config option for daily rotation ([#33](https://github.com/DeRuina/timberjack/issues/33)) ([16955b7](https://github.com/DeRuina/timberjack/commit/16955b7e540f9562122590ae05f591dd43cd5860)) * bump go version to 1.21 ([9bdd903](https://github.com/DeRuina/timberjack/commit/9bdd9038638e72a7fb330fe97f8c730864b9cbd5)) ### Changed * update README ([4203c93](https://github.com/DeRuina/timberjack/commit/4203c93e80ece5d83ec387170bee3f5a69253daf)) ## [1.3.4](https://github.com/DeRuina/timberjack/compare/v1.3.3...v1.3.4) (2025-08-05) ### Features * read group permission on newly created files ([#30](https://github.com/DeRuina/timberjack/issues/30)) ([ee44715](https://github.com/DeRuina/timberjack/commit/ee447152a04d62ae12811a2212815f8960ca0d9d)) ## [1.3.3](https://github.com/DeRuina/timberjack/compare/v1.3.2...v1.3.3) (2025-07-24) ### Bug Fixes * Prevent panic on write after close and improve shutdown robustness ([#25](https://github.com/DeRuina/timberjack/issues/25)) ([332b9c2](https://github.com/DeRuina/timberjack/commit/332b9c2553d63f5eafdce47237d29b510609f823)) ## [1.3.2](https://github.com/DeRuina/timberjack/compare/v1.3.1...v1.3.2) (2025-07-21) ### Bug Fixes * millRun goroutine leak fix ([28bf784](https://github.com/DeRuina/timberjack/commit/28bf784b830e5f839054f7d82950087e323b958f)) ## [1.3.1](https://github.com/DeRuina/timberjack/compare/v1.3.0...v1.3.1) (2025-07-17) ### Features * `BackupTimeFormat` field is now required for Logger instance to work. Returns error if invalid value is passed. * Rotation Suffix Time Format ([e2c2211](https://github.com/DeRuina/timberjack/commit/e2c22115ae301c034e07c703ab9729d25b170a49)) ### Bug Fixes * truncateFractional bug fix ([9a6f908](https://github.com/DeRuina/timberjack/commit/9a6f908d270ddfa45df66621b0b12b1ff44ab28f)) ## [1.3.0](https://github.com/DeRuina/timberjack/compare/v1.2.0...v1.3.0) (2025-06-04) ### Features * **rotation:** add RotateAtMinutes support ([e4c22b6](https://github.com/DeRuina/timberjack/commit/e4c22b6858ea7ca2493a1c6af4a6032f5e2ea95c)) * **rotation:** add RotateAtMinutes support ([2e93add](https://github.com/DeRuina/timberjack/commit/2e93adddf122269e2043506a5b7a46b4106eea86)) ## [1.2.0](https://github.com/DeRuina/timberjack/compare/v1.1.0...v1.2.0) (2025-05-27) ### Features * release please script ([42d3575](https://github.com/DeRuina/timberjack/commit/42d35750d4f0f5cfac7c339ba9dcdee77527ab72)) * release please script ([7514015](https://github.com/DeRuina/timberjack/commit/751401565635ff4eecbaffdf82e2333973cfe18a)) ## [1.1.0] - 2025-05-27 ### Added - Support for time-based log rotation via `RotationInterval` configuration - Rotation reason (`-time`, `-size`) included in backup filenames - Platform-specific file ownership preservation (`chown_linux.go`) - Enhanced filename parsing to recognize timestamp and rotation reason - Extensive unit tests for time-based rotation, compression, and ownership - Default filename uses `-timberjack.log` if none is provided ### Changed - Refactored rotation logic to support time-based, size-based, and manual triggers uniformly - Replaced deprecated `ioutil.ReadDir` with modern `os.ReadDir` - Improved compression logic to handle chown and cleanup safely ### Fixed - Preserved original file mode and ownership during rotation and compression - Resolved edge cases in backup name parsing with improved robustness ### Removed - Legacy logic relying solely on size-based rotation