{"id":31801336,"url":"https://github.com/egasimov/aznum2words","last_synced_at":"2026-02-18T11:03:37.669Z","repository":{"id":79219131,"uuid":"502574956","full_name":"egasimov/aznum2words","owner":"egasimov","description":"[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. ","archived":false,"fork":false,"pushed_at":"2025-02-22T21:42:22.000Z","size":2806,"stargazers_count":18,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-22T22:25:27.916Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/egasimov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-12T09:44:09.000Z","updated_at":"2025-02-22T21:42:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"d6905c8b-bc11-4c8f-afa4-617903577db3","html_url":"https://github.com/egasimov/aznum2words","commit_stats":null,"previous_names":["egasimov/aznum2word","egasimov/num2words"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/egasimov/aznum2words","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egasimov%2Faznum2words","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egasimov%2Faznum2words/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egasimov%2Faznum2words/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egasimov%2Faznum2words/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/egasimov","download_url":"https://codeload.github.com/egasimov/aznum2words/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/egasimov%2Faznum2words/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005574,"owners_count":26083921,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-10-10T23:58:59.877Z","updated_at":"2025-10-10T23:59:09.994Z","avatar_url":"https://github.com/egasimov.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!---\n![aznum2words logo](./assets/img/logo-go-ref-2-crop.png)\n\n![aznum2words logo](./assets/img/logo-go-ref-crop.png)\n\n![aznum2words logo](assets/img/v3.png)\n\n--\u003e\n\n![aznum2words logo](assets/img/logo-v2.png)\n- - -\n![CI](https://github.com/egasimov/aznum2words/actions/workflows/ci.yml/badge.svg?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/egasimov/aznum2words)](https://goreportcard.com/report/github.com/egasimov/aznum2words)\n![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/egasimov/aznum2words?sort=semver)\n[![GitHub stars](https://img.shields.io/github/stars/egasimov/aznum2words.svg?style=social\u0026label=Stars\u0026style=plastic)](https://github.com/egasimov/aznum2words/stargazers)\n[![codecov](https://codecov.io/gh/egasimov/aznum2words/branch/master/graph/badge.svg?token=LDWMTI4VU4)](https://codecov.io/gh/egasimov/aznum2words)\n\n[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)\n[![GoDoc](https://godoc.org/github.com/egasimov/aznum2words?status.svg)](https://godoc.org/github.com/egasimov/aznum2words)\n\n[//]: # ([![Github Last Commit]\u0026#40;https://img.shields.io/github/last-commit/egasimov/aznum2words?color=61dfc6\u0026label=last%20commit\u0026#41;]\u0026#40;\u0026#41;)\n[//]: # (![GitHub all releases]\u0026#40;https://img.shields.io/github/downloads/egasimov/aznum2words/total\u0026#41;)\n\n\n**AzNum2Words** - Azərbaycan dilində ədədlərin sözlə yazılışı(və ya təsviri) üçün nəzərdə tutulan Go \ndilində yazılmış, açıq qaynaqlı kitabxanadır.\n\n- - -\n\n## Məqsəd | Goal\nAzə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.\nKitabxana tam və ya kəsr ədədlərin Azərbaycan dilində sözlə yazılışı(və ya təsviri) üçün nəzərdə tutulub.\n\n- - -\n\n## İstifadə formaları | Usage forms\n\nHəm [library](#kitabxana-kimi-istifadə-qaydası--guideline-for-using-as-library), həm\ndə [command-line tool](#cli-kimi-istifadə-qaydası--guideline-for-using-as-cli-app) kimi istifadə edilə bilər.\nBundan ə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.\n\nBu 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.\n\n- - -\n\n## İstifadə yerləri | Use cases\n\nAzərbaycan dilində ədədlərin təsvirinə ehtiyac duyulan hallarda istifadə oluna bilər.\n\n* Statistik hesabatların tərtib olunması.\n* Maliyyə əməliyyatları zamanı məbləğin sözlə təsvir olunması.\n* 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  üçün rəqəmlərin ifadə sözünün istifadəsini tələb edir.\n* Ç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ə\n  ifadəsini də yazmaq adi bir təcrübədir.\n\n- - -\n\n## Özəlliklər | Features\n\n* Tam ədədlərin sözlə təsvir olunması\n* Kəsr ədədlərin sözlə təsvir olunması\n* Müsbət vəya mənfi ədədlərin sözlə təsvir olunması\n* Söz ilə təsvir oluna biləcək maksimum tam ədəd: 10^63\n* Söz ilə təsvir oluna biləcək minumum kəsr ədəd: (10^-15)\n\n- - -\n\n## Kitabxananın proyektə əlavə edilməsi | Add library into the project\n\n```shell\ngo get github.com/egasimov/aznum2words@latest\n```\n\n## Kitabxana kimi istifadə qaydası | Guideline for using as library\n\n```go\npackage main\n\nimport (\n\t\"fmt\"\n\t\"github.com/egasimov/aznum2words\"\n)\n\nfunc main() {\n\t// in real use, do not discard errors, rather handle it properly :)\n\tresult1, _ := aznum2words.SpellNumber(\"-95412\")\n\tresult2, _ := aznum2words.SpellNumber(\"-2.7021\")\n\tresult3, _ := aznum2words.SpellNumber(\"5611113210\")\n\n\tfmt.Println(result1)\n\tfmt.Println(result2)\n\tfmt.Println(result3)\n}\n\n```\n\n\u003cbr/\u003e**NƏTİCƏ | OUTPUT**\n\n```text\nmənfi doxsan beş min dörd yüz on iki\nmənfi iki tam on mində yeddi min iyirmi bir\nbeş milyard altı yüz on bir milyon bir yüz on üç min iki yüz on\n```\n\n- - -\n\n## CLI kimi quraşdırılması | CLI-Installation\n\n```shell\n// installs the binaries into $GOPATH/bin\ngo install github.com/egasimov/aznum2words/cmd/aznum2words-cli@latest\n```\n\n## CLI kimi istifadə qaydası | Guideline for using as CLI app\n\n```shell\n$ aznum2words-cli -- 12.3\non iki tam onda üç\n\n$ aznum2words-cli -- -12.3\nmənfi on iki tam onda üç\n\n```\n- - -\n\n## Web app kimi quraşdırılması | Web-App Installations\n\n```shell\n// Clone the repository\ngit clone https://github.com/egasimov/aznum2words.git@latest\n```\n\n## Web app kimi istifadə qaydası | Guideline for using as Web app\n\n```shell\n$ cd ./cmd/aznum2words-webapp/ \n$ go run ./aznum2words-webapp.go\n```\n\n```shell\ncurl --location 'http://localhost:8080/api/v1/conversion/to-word' \\\n--header 'Content-Type: application/json' \\\n--header 'Accept: application/json' \\\n--data '{\n  \"number\": \"123.45\"\n}'\n```\n\n_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._\n\n- - -\n\n## Test caseləri yoxlanması | Check test cases\n\n```shell\ngo test -coverprofile=coverage.out ./... ;    go tool cover -html=coverage.out\n```\n\n## Benchmark yoxlanılması\n\n```shell\ngo test -bench=. -run=^# -benchmem\n```\n\n\n- - -\n\n## Versiyalar | Releases\n\nKitabxananın versiyaları [Semver](http://semver.org/) yanaşması ilə tənzimlənir.\n\n- - -\n\n## Lisenziya | License\n\nKitabxana MIT Lisenziya altında lisenziyalaşdırılmışdır. Ətraflı məlumat üçün\n[LICENSE](./LICENSE) faylını nəzərdən keçirin.\n\n\n- - -\n\n## Proyektə necə dəstək olmaq olar | How to contribute to project ?\n\nProyektə contribute etmək üçün aşağıdakı təlimatları nəzərə ala bilərsiniz.\n\n*Testləri olmayan vəya nəzərə alınmayan PRlar qəbul edilməyəcək*\n\n1. Reponu fork et\n2. Yeni feature branch yarat (`git checkout -b my-new-feature`)\n3. Dəyişiklikləri commit et (`git commit -am 'Added some feature'`)\n4. Local branchı origin(remote repo) push et  (`git push origin my-new-feature`)\n5. Yeni Pull Request yarat\n\n- - - \n\n## Contributorlar\n\nBu layihəyə aşağıdakı şəxslər töhfə verib:\n\n\u003c!-- Contributors list --\u003e\n\u003ca href=\"https://github.com/egasimov/aznum2words/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=egasimov/aznum2words\" /\u003e\n\u003c/a\u003e\n\n\u003c!--Made with [contrib.rocks](https://contrib.rocks). --\u003e\n\u003c!-- Contributors list --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegasimov%2Faznum2words","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fegasimov%2Faznum2words","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fegasimov%2Faznum2words/lists"}