{"id":26178449,"url":"https://github.com/borischen0203/litclock-service","last_synced_at":"2026-04-13T05:43:02.814Z","repository":{"id":134743060,"uuid":"420271737","full_name":"borischen0203/litclock-service","owner":"borischen0203","description":"This is a litclock-service. You can convert numeric time to human friendly text.","archived":false,"fork":false,"pushed_at":"2022-02-25T01:45:27.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-26T17:38:30.869Z","etag":null,"topics":["docker","gin","github-actions","golang","heroku","rest-api","swagger"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/borischen0203.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2021-10-22T23:55:53.000Z","updated_at":"2022-02-24T13:37:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"cdba6cf5-bafa-4237-b9af-9f1ecfdecee8","html_url":"https://github.com/borischen0203/litclock-service","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/borischen0203/litclock-service","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borischen0203%2Flitclock-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borischen0203%2Flitclock-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borischen0203%2Flitclock-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borischen0203%2Flitclock-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/borischen0203","download_url":"https://codeload.github.com/borischen0203/litclock-service/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/borischen0203%2Flitclock-service/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31741541,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T05:13:27.074Z","status":"ssl_error","status_checked_at":"2026-04-13T05:13:25.150Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["docker","gin","github-actions","golang","heroku","rest-api","swagger"],"created_at":"2025-03-11T21:28:37.904Z","updated_at":"2026-04-13T05:43:02.764Z","avatar_url":"https://github.com/borischen0203.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/scraly/gophers/main/yoda-gopher.png\" alt=\"yoda-gopher\" width=350\u003e\r\n\r\n[![CICD](https://github.com/borischen0203/litclock-service/actions/workflows/CICD.yml/badge.svg)](https://github.com/borischen0203/litclock-service/actions/workflows/CICD.yml)\r\n\r\n\r\n# litclock-service\r\nThis is a litclock-service. You can convert numeric time to human friendly text.\r\n\r\nNumeric Time -\u003e Human Friendly Text:\r\n- 1:00 -\u003e One o'clock\r\n- 13:05 -\u003e Five past one\r\n\r\nCommand-line tool link:\r\nhttps://github.com/borischen0203/litclock\r\n\r\n## Features\r\n- Convert numeric time to human text.\r\n\r\n# How to use\r\n\r\n## Run directly:\r\n- The service already deployed on Heroku.\r\n- No need to run main.go file, you can type the below command in the terminal directly.\r\n- `The app may sleep without using. Just wait for a few seconds to wake it up.`\r\n\r\nRequired\r\n- Install `curl` cli(https://formulae.brew.sh/formula/curl)\r\n```bash\r\nbrew install curl\r\n```\r\n\r\nUse below curl command to call API and input any time in numericTime value\r\n```bash\r\ncurl -X POST -H \"Content-Type: application/json\" -d '{\"numericTime\" : \"13:08\"}' \"https://litclock-service.herokuapp.com/api/litclock-service/v1/numeric-time\"\r\n```\r\n\r\nDemo\r\n```bash\r\n$ curl -X POST -H \"Content-Type: application/json\" -d '{\"numericTime\" : \"13:08\"}' \"https://litclock-service.herokuapp.com/api/litclock-service/v1/numeric-time\"\r\n$ {\"textTime\":\"Eight past one\"}\r\n```\r\n\r\n## Run in Postman:\r\nUse below API path and body in Postman\r\n```bash\r\n[POST] https://litclock-service.herokuapp.com/api/litclock-service/v1/numeric-time\r\n```\r\nBody\r\n```bash\r\n{\r\n    \"numericTime\" : \"13:08\"\r\n}\r\n```\r\n\r\n## Run in Docker:\r\nRequired\r\n- Install docker\r\n\r\n### Run process\r\nStep1: Pull docker image (borischen0203/litclock-service)\r\n```bash\r\ndocker pull borischen0203/litclock-service\r\n```\r\nStep2: Run docker image as below command\r\n```bash\r\ndocker run -it --rm -p 8080:8080 borischen0203/litclock-service\r\n```\r\nStep3: Create a new terminal window and execute curl\r\n```bash\r\ncurl -X POST -H \"Content-Type: application/json\" -d '{\"numericTime\" : \"13:08\"}' \"http://localhost:8080/api/litclock-service/v1/numeric-time\"\r\n```\r\n\r\n## Run in Local:\r\n\r\nRequired\r\n- Install go(version \u003e= 1.6)\r\n- Install `make` cli(https://formulae.brew.sh/formula/make)\r\n- Install `curl` cli(https://formulae.brew.sh/formula/curl)\r\n```bash\r\nbrew install make\r\n```\r\n```bash\r\nbrew install curl\r\n```\r\n\r\n### Run steps\r\nStep1: Clone the repo\r\n```bash\r\ngit clone https://github.com/borischen0203/litclock-service.git\r\n```\r\nStep2: Use `make` to execute makefile run test and build\r\n```bash\r\nmake all\r\n```\r\nStep3: Use `make` to execute makefile run local server\r\n```bash\r\nmake run\r\n```\r\nStep4: # Use `curl` to call API\r\n```bash\r\ncurl -X POST -H \"Content-Type: application/json\" -d '{\"numericTime\" : \"13:08\"}' \"http://localhost:8080/api/litclock-service/v1/numeric-time\"\r\n```\r\n\r\n### Local run demo:\r\n```bash\r\n$ curl -X POST -H \"Content-Type: application/json\" -d '{\"numericTime\" : \"13:08\"}' \"http://localhost:8080/api/litclock-service/v1/numeric-time\"\r\n$ {\"textTime\":\"Eight past one\"}\r\n```\r\n\r\n## Tech Stack\r\n- Golang\r\n- Gin framework\r\n- RESTful API\r\n- Swagger\r\n- Docker\r\n- Github action(CI)\r\n- Heroku (CD)\r\n\r\n## Todo:\r\n- [ ]\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fborischen0203%2Flitclock-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fborischen0203%2Flitclock-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fborischen0203%2Flitclock-service/lists"}