{"id":14987668,"url":"https://github.com/unusualcodeorg/goservegen","last_synced_at":"2025-04-12T00:16:54.806Z","repository":{"id":246256125,"uuid":"820494685","full_name":"unusualcodeorg/goservegen","owner":"unusualcodeorg","description":"goservegen - Go Backend Architecture Generator using goserve framework","archived":false,"fork":false,"pushed_at":"2024-07-03T08:36:30.000Z","size":98,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T00:16:47.401Z","etag":null,"topics":["api","backend","cli","gin-gonic","go","golang","rest","rest-api","service","starter-project","starter-template"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unusualcodeorg.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":"2024-06-26T15:21:57.000Z","updated_at":"2025-02-17T10:18:28.000Z","dependencies_parsed_at":"2024-06-26T22:31:46.865Z","dependency_job_id":"5af0cbeb-0da0-4dab-8cd0-6be0ddbccf3c","html_url":"https://github.com/unusualcodeorg/goservegen","commit_stats":{"total_commits":18,"total_committers":1,"mean_commits":18.0,"dds":0.0,"last_synced_commit":"5081221eab3ddce7f8ed62a1352876bda6258374"},"previous_names":["unusualcodeorg/goserve-template"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unusualcodeorg%2Fgoservegen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unusualcodeorg%2Fgoservegen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unusualcodeorg%2Fgoservegen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unusualcodeorg%2Fgoservegen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unusualcodeorg","download_url":"https://codeload.github.com/unusualcodeorg/goservegen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248497817,"owners_count":21113984,"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","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":["api","backend","cli","gin-gonic","go","golang","rest","rest-api","service","starter-project","starter-template"],"created_at":"2024-09-24T14:15:08.481Z","updated_at":"2025-04-12T00:16:54.776Z","avatar_url":"https://github.com/unusualcodeorg.png","language":"Go","readme":"# goservegen - Go Backend Architecture Generator using goserve framework\n[![Download](https://img.shields.io/badge/Download-Starter%20Project%20Zip-green.svg)](https://github.com/unusualcodeorg/goservegen/raw/main/project.zip)\n\nProject generator for go backend architecture using goserve framework\n\nCheck out goserve framework [github.com/unusualcodeorg/goserve](https://github.com/unusualcodeorg/goserve)\n\n## How To Use goservegen\n1. Download the goservegen binary for your operating system from the goservegen latest release: [github.com/unusualcodeorg/goservegen/releases](https://github.com/unusualcodeorg/goservegen/releases)\n\n2. Expand the compressed file (Example: Apple Mac M2: goservegen_Darwin_arm64.tar.gz)\n\n3. Run the binary \n```bash\ncd ~/Downloads/goservegen_Darwin_arm64\n\n# ./goservegen [project directory path] [project module]\n./goservegen ~/Downloads/example github.com/yourusername/example\n```\n\u003e Note: `./goservegen ~/Downloads/example github.com/yourusername/example` will generate project named `example` located at `~/Downloads` and module `github.com/yourusername/example`\n\n4. Open the generated project in your IDE/editor of choice\n\n5. Have fun developing your REST API server!\n\n## Generated Project\n```\n.\n├── .extra\n│   └── setup\n│       └── init-mongo.js\n├── api\n│   └── sample\n│       ├── dto\n│       │   └── create_sample.go\n│       ├── model\n│       │   └── sample.go\n│       ├── controller.go\n│       └── service.go\n├── cmd\n│   └── main.go\n├── config\n│   └── env.go\n├── keys\n│   ├── private.pem\n│   └── public.pem\n├── startup\n│   ├── indexes.go\n│   ├── module.go\n│   ├── server.go\n│   └── testserver.go\n├── utils\n│   └── convertor.go\n├── .env\n├── .test.env\n├── .gitignore\n├── .dockerignore\n├── Dockerfile\n├── docker-compose.yml\n├── go.mod\n└── go.sum\n```\n\n## Run the project using Docker\n```bash\ndocker-compose up --build\n```\n#### Check the API\n```cURL\ncurl --location 'http://localhost:8080/sample/ping'\n```\nResponse\n```\n{\n    \"code\": \"10000\",\n    \"status\": 200,\n    \"message\": \"pong!\"\n}\n```\n\n## Working on the project\nYou can read about using this framework here [github.com/unusualcodeorg/goserve](https://github.com/unusualcodeorg/goserve)\n\n## Read the Article to understand this project\n[How to Architect Good Go Backend REST API Services](https://medium.com/@janishar.ali/how-to-architecture-good-go-backend-rest-api-services-14cc4730c05b)\n\n## Troubleshoot\nSometimes your operating system will block the binary from execution, you will have to provide permission to run it. \n\n\u003e In Mac you have to go System Settings \u003e Privacy \u0026 Security \u003e Allow goservegen","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funusualcodeorg%2Fgoservegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funusualcodeorg%2Fgoservegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funusualcodeorg%2Fgoservegen/lists"}