deepl

README

deepl

free deepl translate api in go

reference deepLX ,Reverse-engineering the DeepL Windows client has improved several details.

deepL windows Client download Url： https://appdownload.deepl.com/windows/0install/deepl.xml

Example:

import "github.com/lib-x/deepl"
translateResp, err := Translate("", "zh", "I love Go programming language")
	if err != nil {
		t.Fatal(err)
	}
log.Println(translateResp.Result.Texts[0].Text)

also you an set proxy to use the deepl lib.see in the test

Documentation

Index

• Variables
• type CommonJobParameters
• type ErrorInfo
• type JsonRpcRequest
• type JsonRpcResponse
  • func Translate(sourceLanguage, targetLanguage, textToTranslate string, options ...Option) (jsonRpcResponse *JsonRpcResponse, err error)
• type Lang
• type Option
  • func WithDeeplProSession(dlSession string) Option
  • func WithHttpProxy(proxy string) Option
  • func WithHttpProxyEx(proxy string, ignoreSSLVerification bool) Option
  • func WithSocket5Proxy(socket5Proxy string, userName string, password string) Option
  • func WithSocket5ProxyEx(socket5Proxy string, userName string, password string, ...) Option
  • func WithTagHandling(handingType TagHandlingType) Option
• type TagHandlingType
• type Text
• type TextParam
• type TextTranslationJsonResponse
• type TextTranslationJsonRpcRequestParams
• type TextWithAlternatives

Variables

var (
	ErrorNoTranslateTextFound = errors.New("no Translate Text Found")
	ErrorInvalidTargetLang    = errors.New("invalid Target Lang")
	ErrorTooManyRequests      = errors.New("too Many Requests")

	ErrorInvalidResponse = errors.New("invalid response")
)

Types

type CommonJobParameters

type CommonJobParameters struct {
	WasSpoken       bool   `json:"wasSpoken,omitempty"`
	TranscribeAS    string `json:"transcribe_as,omitempty"`
	RegionalVariant string `json:"regionalVariant,omitempty"`
}

type ErrorInfo

type ErrorInfo struct {
	ErrorCode int `json:"code"`
}

type JsonRpcRequest

type JsonRpcRequest struct {
	Jsonrpc string                              `json:"jsonrpc"`
	Method  string                              `json:"method"`
	Id      int64                               `json:"id"`
	Params  TextTranslationJsonRpcRequestParams `json:"params"`
}

type JsonRpcResponse

type JsonRpcResponse struct {
	Jsonrpc   string                      `json:"jsonrpc"`
	Id        int64                       `json:"id"`
	Result    TextTranslationJsonResponse `json:"result"`
	ErrorInfo *ErrorInfo                  `json:"error,omitempty"`
}

func Translate

func Translate(sourceLanguage, targetLanguage, textToTranslate string, options ...Option) (jsonRpcResponse *JsonRpcResponse, err error)

Translate request data. support lang code using deepL api DE: German EN: English ES: Spanish FR: French IT: Italian JA: Japanese NL: Dutch PL: Polish PT: Portuguese RU: Russian ZH: Chinese BG: Bulgarian CS: Czech DA: Danish EL: Greek ET: Estonian FI: Finnish HU: Hungarian LT: Lithuanian LV: Latvian RO: Romanian SK: Slovakian SL: Slovenian SV: Swedish

type Lang

type Lang struct {
	SourceLangUserSelected string `json:"source_lang_user_selected"`
	TargetLang             string `json:"target_lang"`
}

type Option

type Option func(option *deepLClientOption)

func WithDeeplProSession

func WithDeeplProSession(dlSession string) Option

WithDeeplProSession set deepl pro session.if session is set,

func WithHttpProxy

func WithHttpProxy(proxy string) Option

WithHttpProxy set http proxy.if both httpProxy and sock5 proxy are set, http proxy will be over-wrote by sock5 proxy .example http://127.0.0.1:1080

func WithHttpProxyEx

func WithHttpProxyEx(proxy string, ignoreSSLVerification bool) Option

WithHttpProxyEx set http proxy.if both httpProxy and sock5 proxy are set, http proxy will be over-wrote by sock5 proxy .example http://http://127.0.0.1:1080 ignoreSSLVerification: ignore SSL verification

func WithSocket5Proxy

func WithSocket5Proxy(socket5Proxy string, userName string, password string) Option

WithSocket5Proxy set socket5Proxy.if both httpProxy and sock5 proxy are set, http proxy will be over-wrote by sock5 proxy example 127.0.0.1:1080

func WithSocket5ProxyEx

func WithSocket5ProxyEx(socket5Proxy string, userName string, password string, ignoreSSLVerification bool) Option

WithSocket5ProxyEx set socket5Proxy.if both httpProxy and sock5 proxy are set, http proxy will be over-wrote by sock5 proxy example 127.0.0.1:1080 ignoreSSLVerification: ignore SSL verification

func WithTagHandling

func WithTagHandling(handingType TagHandlingType) Option

WithTagHandling TagHandling: type of tags to parse before translation, options are "html" and "xml" Todo: support xml options，see https://www.nuget.org/packages/DeepL.net/

type TagHandlingType

type TagHandlingType int

const (
	TagHandlingHtml TagHandlingType = iota
	TagHandlingXml  TagHandlingType = iota
)

type Text

type Text struct {
	Text string `json:"text"`
}

type TextParam

type TextParam struct {
	Text
	RequestAlternatives int `json:"requestAlternatives,omitempty"`
}

type TextTranslationJsonResponse

type TextTranslationJsonResponse struct {
	Texts               []TextWithAlternatives `json:"texts"`
	LanguageCode        string                 `json:"lang"`
	LanguageIsConfident bool                   `json:"lang_is_confident"`
	DetectedLanguages   map[string]float64     `json:"detectedLanguages"`
}

type TextTranslationJsonRpcRequestParams

type TextTranslationJsonRpcRequestParams struct {
	Texts           []TextParam         `json:"texts"`
	Splitting       string              `json:"splitting"`
	Lang            Lang                `json:"lang"`
	Timestamp       int64               `json:"timestamp"`
	CommonJobParams CommonJobParameters `json:"commonJobParams"`
	TagHandling     string              `json:"tag_handling"`
}

type TextWithAlternatives

type TextWithAlternatives struct {
	Text
	Alternatives []Text `json:"alternatives,omitempty"`
}