gettext-go - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #llm #rust #deep-learning #docker #macos #awesome-list #vue #ios #mcp #open-source

gettext-go

(★ 94)

:ab: GNU gettext for Go (Imported By Kubernetes)

파일 탐색기

최종 버전 다운로드 (.zip)

- - .gitignore
  - main.go
  - Makefile
  - pkg.go
  - utils.go
  - utils_test.go
- - hi.go
- hello.go
- locale.zip
- Makefile
- doc.go
- encoder.go
- encoder_test.go
- file.go
- file_test.go
- header.go
- header_test.go
- message.go
- util.go
- util_test.go
- doc.go
- formula.go
- formula_test.go
- table.go
- comment.go
- comment_test.go
- doc.go
- file.go
- file_test.go
- header.go
- header_test.go
- line_reader.go
- message.go
- message_test.go
- poedit_test.go
- re.go
- util.go
- util_test.go
- gettext-3-1.mo
- gettext-3-1.po
- gettext-3-2.mo
- gettext-3-2.po
- gettext-4.mo
- gettext-4.po
- gettext-5.mo
- gettext-5.po
- gettext-6-1.mo
- gettext-6-1.po
- gettext-6-2.mo
- gettext-6-2.po
- gettext-7.mo
- gettext-7.po
- gettextpo-1.de.mo
- gettextpo-1.de.po
- Makefile
- mm-ko-comp.euc-kr.mo
- mm-ko-comp.euc-kr.po
- mm-ko.euc-kr.mo
- mm-ko.euc-kr.po
- mm-viet.comp.mo
- mm-viet.comp.po
- poedit-1.5.7-zh_CN.mo
- poedit-1.5.7-zh_CN.po
- qttest2_de.mo
- qttest2_de.po
- qttest_pl.mo
- qttest_pl.po
- README.txt
- test.mo
- test.po
- xg-c-1.ok.po
.travis.yml
doc.go
example_test.go
fs.go
fs_json.go
fs_os.go
fs_test.go
fs_zip.go
gettext.go
gettext_test.go
go.mod
hello.go
LICENSE
locale.go
locale_test.go
README.md
testdata_test.go
testing_test.go
tr.go
tr_test.go
util.go

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/chai2010/gettext-go

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd gettext-go

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

cd cmd/xgettext-go

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

- *Go语言QQ群: 102319854, 1055927514*
- *凹语言(凹读音“Wa”)(The Wa Programming Language): https://github.com/wa-lang/wa*

----

# gettext-go: GNU gettext for Go ([Imported By Kubernetes](https://pkg.go.dev/github.com/chai2010/gettext-go@v0.1.0/gettext?tab=importedby))

- PkgDoc: [http://godoc.org/github.com/chai2010/gettext-go](http://godoc.org/github.com/chai2010/gettext-go)
- PkgDoc: [http://pkg.go.dev/github.com/chai2010/gettext-go](http://pkg.go.dev/github.com/chai2010/gettext-go)

## Install

1. `go get github.com/chai2010/gettext-go`
2. `go run hello.go`

The godoc.org or go.dev has more information.

## Examples

```Go
package main

import (
	"fmt"

"github.com/chai2010/gettext-go"
)

func main() {
	gettext := gettext.New("hello", "./examples/locale").SetLanguage("zh_CN")
	fmt.Println(gettext.Gettext("Hello, world!"))

// Output: 你好, 世界!
}
```

```Go
package main

import (
	"fmt"

"github.com/chai2010/gettext-go"
)

func main() {
	gettext.SetLanguage("zh_CN")
	gettext.BindLocale(gettext.New("hello", "locale"))

// gettext.BindLocale("hello", "locale")              // from locale dir
	// gettext.BindLocale("hello", "locale.zip")          // from locale zip file
	// gettext.BindLocale("hello", "locale.zip", zipData) // from embedded zip data

// translate source text
	fmt.Println(gettext.Gettext("Hello, world!"))
	// Output: 你好, 世界!

// if no msgctxt in PO file (only msgid and msgstr),
	// specify context as "" by
	fmt.Println(gettext.PGettext("", "Hello, world!"))
	// Output: 你好, 世界!

// translate resource
	fmt.Println(string(gettext.Getdata("poems.txt"))))
	// Output: ...
}
```

Go file: [hello.go](https://github.com/chai2010/gettext-go/blob/master/examples/hello.go); PO file: [hello.po](https://github.com/chai2010/gettext-go/blob/master/examples/locale/default/LC_MESSAGES/hello.po);

----

## API Changes (v0.1.0 vs v1.0.0)

### Renamed package path

| v0.1.0 (old)                                    | v1.0.0 (new)                            |
| ----------------------------------------------- | --------------------------------------- |
| `github.com/chai2010/gettext-go/gettext`        | `github.com/chai2010/gettext-go`        |
| `github.com/chai2010/gettext-go/gettext/po`     | `github.com/chai2010/gettext-go/po`     |
| `github.com/chai2010/gettext-go/gettext/mo`     | `github.com/chai2010/gettext-go/mo`     |
| `github.com/chai2010/gettext-go/gettext/plural` | `github.com/chai2010/gettext-go/plural` |

### Renamed functions

| v0.1.0 (old)                       | v1.0.0 (new)                |
| ---------------------------------- | --------------------------- |
| `gettext-go/gettext.*`             | `gettext-go.*`              |
| `gettext-go/gettext.DefaultLocal`  | `gettext-go.DefaultLanguage`|
| `gettext-go/gettext.BindTextdomain`| `gettext-go.BindLocale`     |
| `gettext-go/gettext.Textdomain`    | `gettext-go.SetDomain`      |
| `gettext-go/gettext.SetLocale`     | `gettext-go.SetLanguage`    |
| `gettext-go/gettext/po.Load`       | `gettext-go/po.LoadFile`    |
| `gettext-go/gettext/po.LoadData`   | `gettext-go/po.Load`        |
| `gettext-go/gettext/mo.Load`       | `gettext-go/mo.LoadFile`    |
| `gettext-go/gettext/mo.LoadData`   | `gettext-go/mo.Load`        |

### Use empty string as the default context for `gettext.Gettext`

```go
package main

// v0.1.0
// if the **context** missing, use `callerName(2)` as the context:

// v1.0.0
// if the **context** missing, use empty string as the context:

func main() {
	gettext.Gettext("hello")          
	// v0.1.0 => gettext.PGettext("main.main", "hello")
	// v1.0.0 => gettext.PGettext("", "hello")

gettext.DGettext("domain", "hello")
	// v0.1.0 => gettext.DPGettext("domain", "main.main", "hello")
	// v1.0.0 => gettext.DPGettext("domain", "", "hello")

gettext.NGettext("domain", "hello", "hello2", n)
	// v0.1.0 => gettext.PNGettext("domain", "main.main", "hello", "hello2", n)
	// v1.0.0 => gettext.PNGettext("domain", "", "hello", "hello2", n)

gettext.DNGettext("domain", "hello", "hello2", n)
	// v0.1.0 => gettext.DPNGettext("domain", "main.main", "hello", "hello2", n)
	// v1.0.0 => gettext.DPNGettext("domain", "", "hello", "hello2", n)
}
```

### `BindLocale` support `FileSystem` interface

```go
// Use FileSystem:
//	BindLocale(New("poedit", "name", OS("path/to/dir"))) // bind "poedit" domain
//	BindLocale(New("poedit", "name", OS("path/to.zip"))) // bind "poedit" domain
```

## New API in v1.0.0

`Gettexter` interface:

```go
type Gettexter interface {
	FileSystem() FileSystem

GetDomain() string
	SetDomain(domain string) Gettexter

GetLanguage() string
	SetLanguage(lang string) Gettexter

Gettext(msgid string) string
	PGettext(msgctxt, msgid string) string

NGettext(msgid, msgidPlural string, n int) string
	PNGettext(msgctxt, msgid, msgidPlural string, n int) string

DGettext(domain, msgid string) string
	DPGettext(domain, msgctxt, msgid string) string
	DNGettext(domain, msgid, msgidPlural string, n int) string
	DPNGettext(domain, msgctxt, msgid, msgidPlural string, n int) string

Getdata(name string) []byte
	DGetdata(domain, name string) []byte
}

func New(domain, path string, data ...interface{}) Gettexter
```

`FileSystem` interface:

```go
type FileSystem interface {
	LocaleList() []string
	LoadMessagesFile(domain, lang, ext string) ([]byte, error)
	LoadResourceFile(domain, lang, name string) ([]byte, error)
	String() string
}

func NewFS(name string, x interface{}) FileSystem
func OS(root string) FileSystem
func ZipFS(r *zip.Reader, name string) FileSystem
func NilFS(name string) FileSystem
```

----

## BUGS

Please report bugs to <chaishushan@gmail.com>.

Thanks!