{"id":18315179,"url":"https://github.com/kingakeem/easy-store","last_synced_at":"2026-04-13T17:03:43.362Z","repository":{"id":203554567,"uuid":"707449007","full_name":"KingAkeem/easy-store","owner":"KingAkeem","description":"A simple object storing service built with FastAPI, SQLAlchemy and SQLite","archived":false,"fork":false,"pushed_at":"2023-10-26T19:37:45.000Z","size":68,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-15T06:44:08.443Z","etag":null,"topics":["docker","fastapi","fastapi-sqlalchemy","files","json","orm","python","python3","rest","rest-api","sqlalchemy","sqlalchemy-orm","sqlite3","storage"],"latest_commit_sha":null,"homepage":"","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/KingAkeem.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}},"created_at":"2023-10-19T23:37:19.000Z","updated_at":"2023-10-25T21:58:02.000Z","dependencies_parsed_at":"2023-10-29T00:10:05.133Z","dependency_job_id":null,"html_url":"https://github.com/KingAkeem/easy-store","commit_stats":{"total_commits":27,"total_committers":2,"mean_commits":13.5,"dds":"0.11111111111111116","last_synced_commit":"71332c51ce34705522195d93c134d2cd5c161d33"},"previous_names":["kingakeem/easy-store"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KingAkeem%2Feasy-store","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KingAkeem%2Feasy-store/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KingAkeem%2Feasy-store/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KingAkeem%2Feasy-store/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KingAkeem","download_url":"https://codeload.github.com/KingAkeem/easy-store/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248045220,"owners_count":21038553,"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":["docker","fastapi","fastapi-sqlalchemy","files","json","orm","python","python3","rest","rest-api","sqlalchemy","sqlalchemy-orm","sqlite3","storage"],"created_at":"2024-11-05T16:37:43.363Z","updated_at":"2026-04-13T17:03:43.356Z","avatar_url":"https://github.com/KingAkeem.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# easy-store\n\nThis is a simple object storing service built with FastAPI and backed by an SQLite database. The API is designed to be a microservice that can be easily deployed and used in conjunction with a front-end application. This service enables you to store both JSON and file data, offering two distinct endpoints for each type of data.\n\n## Features\n- JSON Data Storage: The service can store JSON data within the SQLite database as a string.\n- File Data Storage: It also allows you to write file data to memory and store a reference to the file path along with other metadata.\n\n## Installation\nClone the repository:\n\n```bash\ngit clone https://github.com/KingAkeem/easy-store.git\ncd easy-store\n```\n\n### Using uvicorn \n```bash\npip install -r requirements.txt\n```\n\n```bash\nuvicorn main:app --host 0.0.0.0 --port 8000 --reload\n```\n\n### Using docker\n```bash\ndocker build -t easy-store .\ndocker run -p 8000:8080 easy-store\n```\n\nThe service will be available at http://localhost:8000.\n\n## API Endpoints\nCheck {{url}}/docs for swagger documentation on the endpoints.\n\n## Usage\nTo use this service, you can make API requests using tools like curl, or you can create a front-end application to interact with the service. Below are some examples of API requests:\n\n### Storing JSON Data\n```bash\n# POST JSON data\ncurl -X POST -H \"Content-Type: application/json\" -d '{\"key\": \"value\"}' http://localhost:8000/json\n\n# GET JSON data as string by ID\ncurl http://localhost:8000/json/{data_id}\n\n# GET JSON data by ID\ncurl http://localhost:8000/json/{data_id}?convert=True\n```\n\n### Storing File Data\n```bash\n# POST file data\ncurl -X POST -F \"file=@/path/to/your/file\" http://localhost:8000/file\n\n# GET file data by ID\ncurl http://localhost:8000/file/{file_id}\n\n# GET file binary data by ID\ncurl http://localhost:8000/file/{file_id}?convert=True\n```\n\n## Contributing\nWe welcome contributions! If you would like to contribute to this project, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature: git checkout -b feature-name\n3. Make your changes and commit them: git commit -m \"Add your feature\"\n4. Push to the branch: git push origin feature-name\n5. Submit a pull request.\n\n\n## License\nThis project is licensed under the GPL-3.0 License - see the [LICENSE](https://github.com/KingAkeem/easy-store/blob/main/LICENSE) file for details.\n\n## Contact\nIf you have any questions or need assistance, feel free to contact us at akeemtlking@gmail.com.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingakeem%2Feasy-store","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkingakeem%2Feasy-store","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingakeem%2Feasy-store/lists"}