feat: Add multi-translator support with DeepL backend by gilang-as · Pull Request #5 · gilang-as/translator

gilang-as · 2026-02-02T04:08:40Z

Summary

Add DeepL as a second translation backend alongside Google Translate
Introduce unified Translator interface for consistent API across backends
Restructure codebase with standardized package layout
Add comprehensive examples and documentation

Changes

New Features

DeepL Support: Full DeepL translation client with proxy and session support
Multi-translator API: Switch between backends using UseGoogle() / UseDeepL()
Translator Interface: Common interface allowing custom translator implementations
Proxy Support: Both clients now support proxy configuration via WithProxyURL()

API Additions

// Switch default translator                                                                                                        
gt.UseGoogle()                                                                                                                      
gt.UseDeepL()                                                                                                                       
                                                                                                                                    
// Use specific translator                                                                                                          
google := gt.NewGoogleTranslator()                                                                                                  
deepl := gt.NewDeepLTranslator()                                                                                                    
gt.TranslateWith(ctx, translator, text, targetLang)                                                                                 
                                                                                                                                    
Package Structure                                                                                                                   
                                                                                                                                    
Both googletranslate/ and deepl/ now share identical structure:                                                                     
- *.go - Client, options, getters/setters                                                                                           
- translate.go - Translation logic                                                                                                  
- types.go - Type definitions                                                                                                       
- utils.go - Helper functions                                                                                                       
                                                                                                                                    
Dependencies                                                                                                                        
                                                                                                                                    
- Both packages use github.com/imroc/req/v3 for HTTP                                                                                
- Both packages use github.com/tidwall/gjson for JSON parsing                                                                       
                                                                                                                                    
Breaking Changes                                                                                                                    
                                                                                                                                    
- Removed legacy gtranslate.go re-exports                                                                                           
- Module renamed to gopkg.gilang.dev/translator                                                                                     
                                                                                                                                    
Test Plan                                                                                                                           
                                                                                                                                    
- All existing tests pass                                                                                                           
- New unit tests for DeepL client                                                                                                   
- Benchmark tests for both packages                                                                                                 
- Integration tests with live APIs                                                                                                  
                                                                                                                                    
🤖 Generated with https://claude.com/claude-code                                                                                    
                                                                                                                                    
---

- Update module name from gopkg.gilang.dev/google-translate to gopkg.gilang.dev/translator - Update all import paths in source files - Update README with new module name and migration guide - Remove .idea directory - Add CLAUDE.md for development instructions The legacy module remains available on the v1 branch. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Rename api.go to gtranslate.go and api_test.go to gtranslate_test.go - Rename translateV1 function to gtranslate - Replace deprecated io/ioutil with io - Add context.Context parameter to all public API functions - Update HTTP requests to use NewRequestWithContext Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Add GoogleTranslate struct with Host and Client fields - Add functional options: WithHost, WithHTTPClient - Add NewGoogleTranslate constructor for custom configuration - Convert check and translate to methods on GoogleTranslate - Add defaultClient for backward-compatible package-level functions - Update CLAUDE.md documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

…afety - Create googletranslate package with concurrency-safe client - Add sync.RWMutex for thread-safe host/client access - Rename NewGoogleTranslate to New in googletranslate package - Add getter/setter methods: Host(), SetHost(), Client(), SetClient() - Simplify gtranslate.go to re-export only essential types - Remove unused type re-exports (TranslateFrom*, DefaultHost) - Add unit tests for googletranslate package - Update CLAUDE.md documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Create separate benchmark_test.go file - Use modern b.Loop() pattern for benchmarks - Add benchmarks for New, Host, SetHost, Translate - Add concurrent benchmarks for thread-safety testing Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Add deepl package with concurrency-safe client - Add Translator interface for unified API across backends - Add UseGoogle/UseDeepL to switch default translator - Add NewGoogleTranslator/NewDeepLTranslator factory functions - Add TranslateWith for using specific translator instance - Add proxy support (WithProxyURL) to both clients - Add DeepL session support (WithDLSession) for Pro features - Remove legacy gtranslate.go re-exports - Add comprehensive examples (basic, google, deepl, multi) - Update tests and benchmarks for both packages - Update CLAUDE.md and README.md documentation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Rename DeepLX to DeepL (TranslateByDeepLX -> TranslateByDeepL) - Rename DeepLXTranslationResult to DeepLTranslationResult - Restructure googletranslate to match deepl file structure: - googletranslate.go: client, options, getters/setters - translate.go: translation logic - types.go: type definitions - utils.go: helper functions - Use github.com/imroc/req/v3 and github.com/tidwall/gjson in googletranslate - Both packages now use identical dependencies and structure Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Update actions/checkout to v4 - Update actions/setup-go to v5 - Test against Go 1.21, 1.22, 1.23 - Add build step before tests - Run tests for all packages (./...) - Add separate benchmark job Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Add Benchmarks section with results for both packages - Include Google Translate and DeepL benchmark comparisons - Show client creation, getters/setters, and translation benchmarks Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- Add GitHub-style note callout at top of README - Link to v1 branch documentation for previous version - Include go get command for installing legacy version Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Copilot

Pull request overview

This pull request adds DeepL as a second translation backend alongside Google Translate, introducing a unified Translator interface for consistent API usage across backends. The codebase has been significantly restructured with new package organization, comprehensive examples, and updated documentation.

Changes:

Added DeepL translation backend with full client implementation including proxy and session support
Introduced Translator interface allowing switching between backends via UseGoogle() / UseDeepL() or using specific translators with TranslateWith()
Restructured codebase with googletranslate/ and deepl/ packages, each containing client, translation logic, types, and utilities
Added context.Context parameter to all translation functions for proper cancellation/timeout support
Updated module path from gopkg.gilang.dev/google-translate to gopkg.gilang.dev/translator (breaking change)

Reviewed changes

Copilot reviewed 25 out of 27 changed files in this pull request and generated 27 comments.

Show a summary per file

File	Description
translate.go	Core API with Translator interface, adapters, and package-level translation functions
translate_test.go	Updated tests with context parameters and new multi-translator tests
googletranslate/*.go	Google Translate client implementation (refactored from api.go)
googletranslate/*_test.go	Unit and benchmark tests for Google client
deepl/*.go	New DeepL client implementation with full translation support
deepl/*_test.go	Unit and benchmark tests for DeepL client
go.mod/go.sum	Updated module path and added new dependencies (req/v3, gjson, whatlanggo, etc.)
example/*	Comprehensive examples for basic usage, Google, DeepL, and multi-translator scenarios
README.md	Updated documentation covering both backends and new API
CLAUDE.md	New developer documentation file
api.go/api_test.go	Removed legacy implementation
.idea/workspace.xml	Removed IDE-specific file (good practice)

Files not reviewed (1)

.idea/workspace.xml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-02T04:50:15Z

@gilang-as I've opened a new pull request, #6, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot · 2026-02-02T04:50:43Z

@gilang-as I've opened a new pull request, #7, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot · 2026-02-02T04:51:04Z

@gilang-as I've opened a new pull request, #8, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot · 2026-02-02T04:51:15Z

@gilang-as I've opened a new pull request, #9, to work on those changes. Once the pull request is ready, I'll request review from you.

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

[WIP] WIP Address feedback on multi-translator support

[WIP] Update multi-translator support with DeepL backend

Fix typo in error messages: "is't" → "isn't"

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Fix typo in error messages: "is't" → "isn't"

Copilot · 2026-02-02T04:57:46Z

@gilang-as I've opened a new pull request, #14, to work on those changes. Once the pull request is ready, I'll request review from you.

Copilot · 2026-02-02T04:58:10Z

@gilang-as I've opened a new pull request, #15, to work on those changes. Once the pull request is ready, I'll request review from you.

…tion Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

…4a0b-9242-1a181bf1e98d [WIP] Address feedback on multi-translator support

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

…ec5ee1-7a7e-409b-8f58-0f4862985fda

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…409b-8f58-0f4862985fda Fix DeepL client to use configured HTTP client with context support

gilang-as and others added 7 commits February 2, 2026 09:47

gilang-as requested a review from Copilot February 2, 2026 04:09

ci: update GitHub Actions workflow

270ec96

- Update actions/checkout to v4 - Update actions/setup-go to v5 - Test against Go 1.21, 1.22, 1.23 - Add build step before tests - Run tests for all packages (./...) - Add separate benchmark job Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Copilot started reviewing on behalf of gilang-as February 2, 2026 04:10 View session

gilang-as and others added 2 commits February 2, 2026 11:15

docs: add benchmark results to README

c1047fe

- Add Benchmarks section with results for both packages - Include Google Translate and DeepL benchmark comparisons - Show client creation, getters/setters, and translation benchmarks Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs: add note for legacy v1 package users

8e706f2

- Add GitHub-style note callout at top of README - Link to v1 branch documentation for previous version - Include go get command for installing legacy version Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Copilot AI reviewed Feb 2, 2026

View reviewed changes

gilang-as and others added 5 commits February 2, 2026 11:21

Update readme.md

993db4b

Update README.md

e57a325

Update README.md

619cb36

chore: align v2 module references

b41cece

Initial plan

194f91b

Copilot AI mentioned this pull request Feb 2, 2026

[WIP] Address feedback on multi-translator support with DeepL backend #6

Merged

4 tasks

Initial plan

7e2e1a3

Copilot AI mentioned this pull request Feb 2, 2026

Fix typo in error messages: "is't" → "isn't" #7

Merged

Initial plan

74a0eab

Copilot AI mentioned this pull request Feb 2, 2026

fix: correct typo "is't" to "isn't" in validation error messages #8

Merged

Initial plan

3fa7a44

Copilot AI mentioned this pull request Feb 2, 2026

[WIP] WIP Address feedback on multi-translator support #9

Merged

4 tasks

Initial plan

d3748f8

Copilot AI and others added 10 commits February 2, 2026 04:53

fix: replace b.Loop() with standard for loop in benchmarks

97372ea

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Update progress - all tasks complete

1786ea6

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Update progress

ed2bfc8

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Merge pull request #9 from gilang-as/copilot/sub-pr-5-yet-again

b147922

[WIP] WIP Address feedback on multi-translator support

Merge pull request #8 from gilang-as/copilot/sub-pr-5-another-one

03d960a

[WIP] Update multi-translator support with DeepL backend

Merge pull request #7 from gilang-as/copilot/sub-pr-5-again

65d61ae

Fix typo in error messages: "is't" → "isn't"

fix: correct typo in error messages - "is't" → "isn't"

c3ec3d7

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Update progress - all tasks completed

801bba1

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Merge pull request #10 from gilang-as/copilot/sub-pr-5-one-more-time

47084e7

Fix typo in error messages: "is't" → "isn't"

Initial plan

47e5631

Copilot AI mentioned this pull request Feb 2, 2026

[WIP] Address feedback on multi-translator support #14

Merged

5 tasks

Initial plan

e498e19

Copilot AI mentioned this pull request Feb 2, 2026

Fix DeepL client to use configured HTTP client with context support #15

Merged

Copilot AI and others added 14 commits February 2, 2026 05:00

fix: pass context through DeepL translation chain for proper cancella…

670cf88

…tion Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Merge pull request #14 from gilang-as/copilot/sub-pr-5-7498da45-26e9-…

557cde3

…4a0b-9242-1a181bf1e98d [WIP] Address feedback on multi-translator support

fix: use configured HTTP client in DeepL translator

f73bbb2

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

fix: use NewClient to avoid shared req.Client instance

a5860b3

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

fix: copy additional HTTP client fields (CheckRedirect, Jar)

70e8b34

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

docs: fix comment to reflect actual HTTP client fields copied

f418e07

Co-authored-by: gilang-as <47550176+gilang-as@users.noreply.github.com>

Merge branch 'feat/multi-translator-support' into copilot/sub-pr-5-80…

8237f1f

…ec5ee1-7a7e-409b-8f58-0f4862985fda

Update deepl/translate.go

b2b9489

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update deepl/translate.go

ef66a7c

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update deepl/translate.go

4cb6813

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update deepl/translate.go

680b7aa

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge pull request #15 from gilang-as/copilot/sub-pr-5-80ec5ee1-7a7e-…

9185746

…409b-8f58-0f4862985fda Fix DeepL client to use configured HTTP client with context support

ci: expand Go matrix and checks

f616d11

chore: gofmt

8f14d42

gilang-as merged commit 51388df into main Feb 2, 2026
6 checks passed

Navigation Menu

feat: Add multi-translator support with DeepL backend - #5

feat: Add multi-translator support with DeepL backend#5
gilang-as merged 52 commits into
mainfrom
feat/multi-translator-support

gilang-as commented Feb 2, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

gilang-as commented Feb 2, 2026

Summary

Changes

New Features

API Additions

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Copilot AI commented Feb 2, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants