{"id":17789235,"url":"https://github.com/solbero/ti4-mapmaker-api","last_synced_at":"2026-04-30T00:02:31.607Z","repository":{"id":52183671,"uuid":"520824690","full_name":"solbero/ti4-mapmaker-api","owner":"solbero","description":null,"archived":false,"fork":false,"pushed_at":"2022-12-20T20:13:44.000Z","size":142,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-07T16:23:02.764Z","etag":null,"topics":["deta","fastapi","twilight-imperium"],"latest_commit_sha":null,"homepage":"https://ti4-mapmaker-api.deta.dev/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solbero.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-08-03T09:53:50.000Z","updated_at":"2022-12-15T18:30:11.000Z","dependencies_parsed_at":"2023-01-30T01:45:41.176Z","dependency_job_id":null,"html_url":"https://github.com/solbero/ti4-mapmaker-api","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solbero%2Fti4-mapmaker-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solbero%2Fti4-mapmaker-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solbero%2Fti4-mapmaker-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solbero%2Fti4-mapmaker-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solbero","download_url":"https://codeload.github.com/solbero/ti4-mapmaker-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246735363,"owners_count":20825224,"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":["deta","fastapi","twilight-imperium"],"created_at":"2024-10-27T10:29:05.397Z","updated_at":"2026-04-30T00:02:26.548Z","avatar_url":"https://github.com/solbero.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- PROJECT TITLE --\u003e\n\u003ch1 align=\"center\"\u003eTI4 Mapmaker API\u003c/h1\u003e\n\n\u003c!-- PROJECT BLURB --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eAPI for the Twilight Imperium 4 Mapmaker map generator website\u003c/em\u003e\n\u003c/p\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/solbero/ti4-mapmaker-api/actions/workflows/build.yaml/\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/solbero/ti4-mapmaker-api/build.yaml?branch=main\u0026label=build\" alt=\"Build action\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/solbero/ti4-mapmaker-api/actions/workflows/publish.yaml/\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/solbero/ti4-mapmaker-api/publish.yaml?branch=main\u0026label=publish\" alt=\"Publish action\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://app.codecov.io/gh/solbero/ti4-mapmaker-api\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/codecov/c/github/solbero/ti4-mapmaker-api\" alt=\"Code coverage\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/solbero/ti4-mapmaker-api/releases\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/solbero/ti4-mapmaker-api\" alt=\"Release version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/solbero/ti4-mapmaker-api/blob/master/LICENSE.txt\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/solbero/ti4-mapmaker-api\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About the Project\n\nThis is the API for the TI4 Mapmaker map generator website. The API can be queried for information about maps, factions and tiles in the board game Twilight Imperium 4.\n\nThe project is a [FastAPI](https://fastapi.tiangolo.com/) application which is deployed at [Deta](https://www.deta.sh/) using their Micro and Base services.\n\n\u003c!-- PREREQUISITES --\u003e\n## Prerequisites\n\nYou must have the following programs installed:\n  * Python 3.9\n  * [Poetry](https://python-poetry.org/docs/#installation)\n  * [Deta CLI](https://docs.deta.sh/docs/cli/install)\n\n\u003c!-- INSTALLATION --\u003e\n## Installation\n\nClone the repository,\n  ```sh\n  git clone https://github.com/solbero/ti4-mapmaker-api.git\n  ```\n\nmove into the project directory,\n  ```sh\n  cd ti4-mapmaker-api\n  ```\n\nand install the project.\n  ```sh\n  poetry install\n  ```\n\nThen, create a Deta Micro for the project\n  ```sh\n  deta new --python\n```\n\nand a `.env` file in the project's root directory. Paste in\n  ```\n  DETA_PROJECT_KEY=\u003cdeta-project-key\u003e\n  ```\nand replace `\u003cdeta-project-key\u003e` with your Deta project credentials.\n\n\n\u003c!-- RUNNING --\u003e\n## Running\n\nTo run the project locally\n  ```sh\n  poetry run python main.py\n  ```\n\n\u003c!-- TESTING --\u003e\n## Testing\n\nTo run the project's testing suite\n  ```sh\n  poetry run pytest\n  ```\n\n\u003c!-- DEPLOYMENT --\u003e\n## Deployment\n\nTo deploy the project to Deta Micro\n```sh\ndeta deploy\n```\n\n\u003c!-- CONTRIBUTIONS --\u003e\n## Contributions\n\n  * Gamedata from [TI4 Generator](https://github.com/KeeganW/ti4) by [KeeganW](https://github.com/KeeganW)\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\n* Email: [njord.solberg@gmail.com](mailto:njord.solberg@gmail.com)\n\n\u003c!-- PROJECT LINKS --\u003e\n## Project Links\n\n* Github: [https://github.com/solbero/ti4-mapmaker-api](https://github.com/solbero/ti4-mapmaker-api)\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the GPLv3 License.\nSee [`LICENSE.txt`](https://github.com/solbero/hexpex/blob/master/LICENSE.txt) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolbero%2Fti4-mapmaker-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolbero%2Fti4-mapmaker-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolbero%2Fti4-mapmaker-api/lists"}