translator

README

English | 简体中文

Googletrans

Transformation of Conight/go-googletrans project, support socks5/http proxy and replace it with resty client

Download from Github

GO111MODULE=on go get github.com/solywsh/go-googletrans

Quick Start Example

Simple translate

package main

import (
	"fmt"
	"github.com/solywsh/go-googletrans"
)

func main() {
	t := translator.New()
	result, err := t.Translate("你好，世界！", "auto", "en")
	if err != nil {
		panic(err)
	}
	fmt.Println(result.Text)
}

Using proxy

package main

import (
	"fmt"
	translator "github.com/solywsh/go-googletrans"
)

func main() {
	t := translator.New(
		translator.WithProxy("http://127.0.0.1:7890"),
	)
	result, err := t.Translate(`你好，世界！`, "auto", "en")
	if err != nil {
		panic(err)
	}
	fmt.Println(result.Text)
}

Test the response time of each service

package main

import (
	"fmt"
	translator "github.com/solywsh/go-googletrans"
)

func main() {
	t := translator.New()
	t.Latency(translator.AllServiceUrls())
}

// Output
Host:  translate.google.ac Time average:  896.617266ms
Host:  translate.google.ad Time average:  787.691933ms
Host:  translate.google.ae Time average:  749.772166ms
Host:  translate.google.al Time average:  712.4626ms
Host:  translate.google.am Time average:  796.3925ms
Host:  translate.google.as Time average:  750.585733ms
Host:  translate.google.at Time average:  847.926733ms
...
Host:  translate.google.to Time average:  648.1111ms
Host:  translate.google.tt Time average:  583.769633ms
Host:  translate.google.us Time average:  540.138666ms
Host:  translate.google.vg Time average:  575.703566ms
Host:  translate.google.vu Time average:  673.641833ms
Host:  translate.google.ws Time average:  563.181933ms
fastest: translate.google.com.ec 466.401633ms

Using custom service urls or user agent

package main

import (
	"fmt"
	translator "github.com/solywsh/go-googletrans"
)

func main() {
	t := translator.New(
		translator.WithProxy("http://127.0.0.1:7890"),
		translator.WithUserAgent("Custom Agent"),
		translator.WithServiceUrl("translate.google.com.hk"),
	)
	result, err := t.Translate(`你好，世界！`, "auto", "en")
	if err != nil {
		panic(err)
	}
	fmt.Println(result.Text)
}

See Examples for more examples.

Special thanks

• Conight/go-googletrans
• py-googletrans

License

This SDK is distributed under the The MIT License, see LICENSE for more information.

Documentation

Index

• Variables
• func AllServiceUrls() []string
• type Option
  • func WithProxy(proxy string) Option
  • func WithRandomServiceUrl() Option
  • func WithRandomServiceUrlEveryTime(serviceUrlList []string) Option
  • func WithRetryTimes(times int) Option
  • func WithServiceUrl(serviceUrl string) Option
  • func WithUserAgent(userAgent string) Option
• type TokenAcquirer
  • func Token(host string, client *resty.Client) *TokenAcquirer
• type Translated
• type Translator
  • func New(options ...Option) *Translator
  • func (t *Translator) Latency(serviceUrls []string)
  • func (t *Translator) Translate(origin, src, dest string) (*Translated, error)

Variables

var ReTkk = regexp.MustCompile(`tkk:'(.+?)'`)

Functions

func AllServiceUrls

func AllServiceUrls() []string

AllServiceUrls Returns all the services that are currently available.

Types

type Option

type Option func(*Translator)

func WithProxy

func WithProxy(proxy string) Option

func WithRandomServiceUrl

func WithRandomServiceUrl() Option

func WithRandomServiceUrlEveryTime

func WithRandomServiceUrlEveryTime(serviceUrlList []string) Option

func WithRetryTimes

func WithRetryTimes(times int) Option

func WithServiceUrl

func WithServiceUrl(serviceUrl string) Option

func WithUserAgent

func WithUserAgent(userAgent string) Option

type TokenAcquirer

type TokenAcquirer struct {
	// contains filtered or unexported fields
}

func Token

func Token(host string, client *resty.Client) *TokenAcquirer

type Translated

type Translated struct {
	Src    string // source language
	Dest   string // destination language
	Origin string // original text
	Text   string // Translated text
}

Translated result object.

type Translator

type Translator struct {
	// contains filtered or unexported fields
}

func New

func New(options ...Option) *Translator

func (*Translator) Latency

func (t *Translator) Latency(serviceUrls []string)

Latency Test the delay of each service node

func (*Translator) Translate

func (t *Translator) Translate(origin, src, dest string) (*Translated, error)

Translate given content. Set src to `auto` and system will attempt to identify the source language automatically.