Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/detectlanguage/detectlanguage-go
Detect Language API Go Client
https://github.com/detectlanguage/detectlanguage-go
detect-language language-detection
Last synced: about 2 months ago
JSON representation
Detect Language API Go Client
- Host: GitHub
- URL: https://github.com/detectlanguage/detectlanguage-go
- Owner: detectlanguage
- License: mit
- Created: 2019-12-14T23:30:44.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-30T15:03:20.000Z (over 2 years ago)
- Last Synced: 2024-07-31T20:52:33.020Z (4 months ago)
- Topics: detect-language, language-detection
- Language: Go
- Homepage: https://detectlanguage.com
- Size: 26.4 KB
- Stars: 25
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - detectlanguage - Language Detection API Go Client. Supports batch requests, short phrase or single word language detection. (Natural Language Processing / Language Detection)
- zero-alloc-awesome-go - detectlanguage - Language Detection API Go Client. Supports batch requests, short phrase or single word language detection. (Natural Language Processing / Language Detection)
- awesome-go-extra - detectlanguage-go - 12-14T23:30:44Z|2022-04-30T15:03:20Z| (Bot Building / Language Detection)
README
Detect Language API Go Client
========
[](http://godoc.org/github.com/detectlanguage/detectlanguage-go)
[](https://github.com/detectlanguage/detectlanguage-go/actions)
[](https://goreportcard.com/report/github.com/detectlanguage/detectlanguage-go)
Detects language of the given text. Returns detected language codes and scores.
Before using Detect Language API client you have to setup your personal API key.
You can get it by signing up at https://detectlanguage.com
## Installation
```
go get -u github.com/detectlanguage/detectlanguage-go
```
### Configuration
```go
client := detectlanguage.New("YOUR API KEY")
```
## Usage
### Language detection
```go
detections, err := client.Detect("Buenos dias señor")
if err != nil {
fmt.Fprintln(os.Stderr, "error detecting language:", err)
os.Exit(1)
return
}
fmt.Fprintln(os.Stdout, "Language:", detections[0].Language)
fmt.Fprintln(os.Stdout, "Reliable:", detections[0].Reliable)
fmt.Fprintln(os.Stdout, "Confidence:", detections[0].Confidence)
```
### Single language code detection
If you need just a language code you can use `DetectCode`. It returns first detected language code.
```go
language, err := client.DetectCode("Buenos dias señor")
if err != nil {
fmt.Fprintln(os.Stderr, "error detecting language:", err)
os.Exit(1)
return
}
fmt.Fprintln(os.Stdout, "Language:", language)
```
### Batch detection
It is possible to detect language of several texts with one request.
This method is significantly faster than doing one request per text.
To use batch detection just pass multiple texts to `DetectBatch` method.
```go
texts := []string{"labas rytas", "good morning"}
results, err := client.DetectBatch(texts)
if err != nil {
fmt.Fprintln(os.Stderr, "error detecting language:", err)
os.Exit(1)
return
}
fmt.Fprintln(os.Stdout, "First text language:", detections[0][0].Language)
fmt.Fprintln(os.Stdout, "Second text language:", detections[1][0].Language)
```
### Getting your account status
```go
result, err := client.UserStatus()
if err != nil {
fmt.Fprintln(os.Stderr, "error getting user status:", err)
os.Exit(1)
return
}
fmt.Fprintln(os.Stdout, "Status:", result.Status)
fmt.Fprintln(os.Stdout, "Requests sent today:", result.Requests)
fmt.Fprintln(os.Stdout, "Bytes sent today:", result.Bytes)
fmt.Fprintln(os.Stdout, "Plan:", result.Plan)
fmt.Fprintln(os.Stdout, "Plan expires:", result.PlanExpires)
fmt.Fprintln(os.Stdout, "Daily requests limit:", result.DailyRequestsLimit)
fmt.Fprintln(os.Stdout, "Daily bytes limit:", result.DailyBytesLimit)
fmt.Fprintln(os.Stdout, "Date:", result.Date)
```
### Getting list supported languages
```go
languages, err := client.Languages()
if err != nil {
fmt.Fprintln(os.Stderr, "error getting languages list:", err)
os.Exit(1)
return
}
fmt.Fprintln(os.Stdout, "Supported languages:", len(languages))
fmt.Fprintln(os.Stdout, "First language code:", languages[0].Code)
fmt.Fprintln(os.Stdout, "First language name:", languages[0].Name)
```
## License
Detect Language API Go Client is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.