googletrans

README

Googletrans

G文⚡️: Concurrency-safe, free and unlimited golang library that implemented Google Translate API.

Inspired by py-googletrans.

Features

• Out of the box
• Auto language detection
• Customizable service URL

Installation

go get -u github.com/miphik/googletrans

Usage

Detect language

package main

import (
	"fmt"

	"github.com/miphik/googletrans"
)

func main() {
	detected, err := googletrans.Detect("hello googletrans")
	if err != nil {
		panic(err)
	}

	format := "language: %q, confidence: %0.2f\n"
	fmt.Printf(format, detected.Lang, detected.Confidence)
}

// Output:
// language: "en", confidence: 1.00

Translate

package main

import (
	"fmt"

	"github.com/miphik/googletrans"
	"golang.org/x/text/language"
)

func main() {
	params := googletrans.TranslateParams{
		Src:  "auto",
		Dest: language.SimplifiedChinese.String(),
		Text: "Go is an open source programming language that makes it easy to build simple, reliable, and efficient software. ",
	}
	translated, err := googletrans.Translate(params)
	if err != nil {
		panic(err)
	}
	fmt.Printf("text: %q \npronunciation: %q", translated.Text, translated.Pronunciation)
}

// Output:
// text: "Go是一种开放源代码编程语言，可轻松构建简单，可靠且高效的软件。"
// pronunciation: "Go shì yī zhǒng kāifàng yuán dàimǎ biānchéng yǔyán, kě qīngsōng gòujiàn jiǎndān, kěkào qiě gāoxiào de ruǎnjiàn."

Customize service URLs

package main

import "github.com/miphik/googletrans"

func main() {
	serviceURLs := []string{
		"https://translate.google.com/",
		"https://translate.google.pl/"}
	googletrans.Append(serviceURLs...)
}

Documentation

Index

• func Append(serviceURLs ...string)
• type Detected
  • func Detect(text string) (Detected, error)
• type TranslateParams
• type Translated
  • func Translate(params TranslateParams) (Translated, error)
• type Translator
  • func New(serviceURLs ...string) *Translator
  • func NewWithClient(client *http.Client, serviceURLs ...string) *Translator
  • func (t *Translator) Append(serviceURLs ...string)
  • func (t *Translator) Detect(text string) (Detected, error)
  • func (t *Translator) Translate(params TranslateParams) (Translated, error)

Functions

func Append

func Append(serviceURLs ...string)

Append appends serviceURLs to defaultTranslator's serviceURLs

Types

type Detected

type Detected struct {
	Lang       string  `json:"lang"`       // detected language
	Confidence float64 `json:"confidence"` // the confidence of detection result (0.00 to 1.00)
}

Detected represents language detection result

func Detect

func Detect(text string) (Detected, error)

Detect uses defaultTranslator to detect language

type TranslateParams

type TranslateParams struct {
	Src  string `json:"src"`  // source language (default: auto)
	Dest string `json:"dest"` // destination language
	Text string `json:"text"` // text for translating
}

TranslateParams represents translate params

type Translated

type Translated struct {
	Params        TranslateParams `json:"params"`
	Text          string          `json:"text"`          // translated text
	Pronunciation string          `json:"pronunciation"` // pronunciation of translated text
}

Translated represents translated result

func Translate

func Translate(params TranslateParams) (Translated, error)

Translate uses defaultTranslator to translate params.text

type Translator

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

Translator is responsible for translation

func New

func New(serviceURLs ...string) *Translator

New initializes a Translator

func NewWithClient

func NewWithClient(client *http.Client, serviceURLs ...string) *Translator

func (*Translator) Append

func (t *Translator) Append(serviceURLs ...string)

Append appends serviceURLS to t's serviceURLs

func (*Translator) Detect

func (t *Translator) Detect(text string) (Detected, error)

Detect detects text's language

func (*Translator) Translate

func (t *Translator) Translate(params TranslateParams) (Translated, error)

Translate translates text from src language to dest language