https://github.com/egasimov/aznum2words
[AZ] Azərbaycan dilində ədədlərin sözlə yazılış təsviri üçün Go dilində yazılmış kitabxana. [EN] The library for converting numbers to words in the Azerbaijan language written in Go.
https://github.com/egasimov/aznum2words
azerbaijan azerbaijani azerbaijani-translation conversion converter ededlerin-yazilishi go golang golang-library integer num2words number-converter number-to-words numbers numbers-text numbers-to-text numbers-to-words numbers-words numbersapi words
Last synced: 3 months ago
JSON representation
[AZ] Azərbaycan dilində ədədlərin sözlə yazılış təsviri üçün Go dilində yazılmış kitabxana. [EN] The library for converting numbers to words in the Azerbaijan language written in Go.
- Host: GitHub
- URL: https://github.com/egasimov/aznum2words
- Owner: egasimov
- License: mit
- Created: 2022-06-12T09:44:09.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-22T21:42:22.000Z (10 months ago)
- Last Synced: 2025-02-22T22:25:27.916Z (10 months ago)
- Topics: azerbaijan, azerbaijani, azerbaijani-translation, conversion, converter, ededlerin-yazilishi, go, golang, golang-library, integer, num2words, number-converter, number-to-words, numbers, numbers-text, numbers-to-text, numbers-to-words, numbers-words, numbersapi, words
- Language: Go
- Homepage:
- Size: 2.68 MB
- Stars: 18
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
- - -
[](https://goreportcard.com/report/github.com/egasimov/aznum2words)
[](https://github.com/egasimov/aznum2words/stargazers)
[](https://codecov.io/gh/egasimov/aznum2words)
[](./LICENSE)
[](https://godoc.org/github.com/egasimov/aznum2words)
[//]: # ([]())
[//]: # ()
**AzNum2Words** - Azərbaycan dilində ədədlərin sözlə yazılışı(və ya təsviri) üçün nəzərdə tutulan Go
dilində yazılmış, açıq qaynaqlı kitabxanadır.
- - -
## Məqsəd | Goal
Azərbaycan dilində ədədlərin(və ya rəqəmlərin) sözlə yazılış təsvirinə ehtiyac yarandığı hallar olur. Proqram səviyyəsində bu kimi ehtiyacları qarşılamaq üçün vahid bir kitabxananın olması, proqramçıların işini xeyli asanlaşdırır.
Kitabxana tam və ya kəsr ədədlərin Azərbaycan dilində sözlə yazılışı(və ya təsviri) üçün nəzərdə tutulub.
- - -
## İstifadə formaları | Usage forms
Həm [library](#kitabxana-kimi-istifadə-qaydası--guideline-for-using-as-library), həm
də [command-line tool](#cli-kimi-istifadə-qaydası--guideline-for-using-as-cli-app) kimi istifadə edilə bilər.
Bundan əlavə [web-app](#web-app-kimi-istifadə-qaydası--guideline-for-using-as-web-app) kimi də istifadə edərək mövcud sisteminə integrasiya etmək mümkündür.
Bu kitabxana vasitəsilə - müsbət, mənfi tam və ya kəsr ədədlərin sözlə yazılış təsvirini əldə etmək mümkündür.
- - -
## İstifadə yerləri | Use cases
Azərbaycan dilində ədədlərin təsvirinə ehtiyac duyulan hallarda istifadə oluna bilər.
* Statistik hesabatların tərtib olunması.
* Maliyyə əməliyyatları zamanı məbləğin sözlə təsvir olunması.
* Hüquqi və maliyyə sənədləri tez-tez çaşqınlığın qarşısını almaq və dəqiqliyi təmin etmək
üçün rəqəmlərin ifadə sözünün istifadəsini tələb edir.
* Çek yazarkən, dəyişikliklərin və ya saxtakarlığın qarşısını almaq üçün rəqəmsal məbləğə əlavə olaraq məbləğin sözlə
ifadəsini də yazmaq adi bir təcrübədir.
- - -
## Özəlliklər | Features
* Tam ədədlərin sözlə təsvir olunması
* Kəsr ədədlərin sözlə təsvir olunması
* Müsbət vəya mənfi ədədlərin sözlə təsvir olunması
* Söz ilə təsvir oluna biləcək maksimum tam ədəd: 10^63
* Söz ilə təsvir oluna biləcək minumum kəsr ədəd: (10^-15)
- - -
## Kitabxananın proyektə əlavə edilməsi | Add library into the project
```shell
go get github.com/egasimov/aznum2words@latest
```
## Kitabxana kimi istifadə qaydası | Guideline for using as library
```go
package main
import (
"fmt"
"github.com/egasimov/aznum2words"
)
func main() {
// in real use, do not discard errors, rather handle it properly :)
result1, _ := aznum2words.SpellNumber("-95412")
result2, _ := aznum2words.SpellNumber("-2.7021")
result3, _ := aznum2words.SpellNumber("5611113210")
fmt.Println(result1)
fmt.Println(result2)
fmt.Println(result3)
}
```
**NƏTİCƏ | OUTPUT**
```text
mənfi doxsan beş min dörd yüz on iki
mənfi iki tam on mində yeddi min iyirmi bir
beş milyard altı yüz on bir milyon bir yüz on üç min iki yüz on
```
- - -
## CLI kimi quraşdırılması | CLI-Installation
```shell
// installs the binaries into $GOPATH/bin
go install github.com/egasimov/aznum2words/cmd/aznum2words-cli@latest
```
## CLI kimi istifadə qaydası | Guideline for using as CLI app
```shell
$ aznum2words-cli -- 12.3
on iki tam onda üç
$ aznum2words-cli -- -12.3
mənfi on iki tam onda üç
```
- - -
## Web app kimi quraşdırılması | Web-App Installations
```shell
// Clone the repository
git clone https://github.com/egasimov/aznum2words.git@latest
```
## Web app kimi istifadə qaydası | Guideline for using as Web app
```shell
$ cd ./cmd/aznum2words-webapp/
$ go run ./aznum2words-webapp.go
```
```shell
curl --location 'http://localhost:8080/api/v1/conversion/to-word' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"number": "123.45"
}'
```
_Qeyd: [open-api-spec contract](cmd/aznum2words-webapp/api/open-api-spec.yaml) istifadə edərək [online swagger-ui](https://editor.swagger.io/), Postman kimi alətlər ilə REST APİ-ni interaktiv test etmək mümkündür._
- - -
## Test caseləri yoxlanması | Check test cases
```shell
go test -coverprofile=coverage.out ./... ; go tool cover -html=coverage.out
```
## Benchmark yoxlanılması
```shell
go test -bench=. -run=^# -benchmem
```
- - -
## Versiyalar | Releases
Kitabxananın versiyaları [Semver](http://semver.org/) yanaşması ilə tənzimlənir.
- - -
## Lisenziya | License
Kitabxana MIT Lisenziya altında lisenziyalaşdırılmışdır. Ətraflı məlumat üçün
[LICENSE](./LICENSE) faylını nəzərdən keçirin.
- - -
## Proyektə necə dəstək olmaq olar | How to contribute to project ?
Proyektə contribute etmək üçün aşağıdakı təlimatları nəzərə ala bilərsiniz.
*Testləri olmayan vəya nəzərə alınmayan PRlar qəbul edilməyəcək*
1. Reponu fork et
2. Yeni feature branch yarat (`git checkout -b my-new-feature`)
3. Dəyişiklikləri commit et (`git commit -am 'Added some feature'`)
4. Local branchı origin(remote repo) push et (`git push origin my-new-feature`)
5. Yeni Pull Request yarat
- - -
## Contributorlar
Bu layihəyə aşağıdakı şəxslər töhfə verib:
