{"id":26585132,"url":"https://github.com/thiagohrcosta/calculator-app","last_synced_at":"2026-05-08T14:10:44.009Z","repository":{"id":277075618,"uuid":"819535442","full_name":"thiagohrcosta/Calculator-App","owner":"thiagohrcosta","description":"Calculator APP is a Python-based API developed as part of the Rockeseat specialization in Python. The project simulates a real-world application while applying best practices in software design, architecture, and scalability. The main focus is on:","archived":false,"fork":false,"pushed_at":"2025-02-12T01:05:37.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-12T02:23:53.983Z","etag":null,"topics":["api","design-patterns","flask","numpy","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/thiagohrcosta.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":"2024-06-24T17:46:53.000Z","updated_at":"2025-02-12T01:05:40.000Z","dependencies_parsed_at":"2025-02-12T02:23:55.297Z","dependency_job_id":"c70d9913-d54f-4a77-88ba-2b0cf53d4d3d","html_url":"https://github.com/thiagohrcosta/Calculator-App","commit_stats":null,"previous_names":["thiagohrcosta/calculator-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiagohrcosta%2FCalculator-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiagohrcosta%2FCalculator-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiagohrcosta%2FCalculator-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiagohrcosta%2FCalculator-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thiagohrcosta","download_url":"https://codeload.github.com/thiagohrcosta/Calculator-App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245090400,"owners_count":20559290,"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","design-patterns","flask","numpy","python"],"created_at":"2025-03-23T10:30:46.828Z","updated_at":"2026-05-08T14:10:38.982Z","avatar_url":"https://github.com/thiagohrcosta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# 📟 Calculator APP\n\n## 🚀 About the Project\n\nCalculator APP is a Python-based API developed as part of the Rockeseat specialization in Python. The project simulates a real-world application while applying best practices in software design, architecture, and scalability. The main focus is on:\n\n-   🏗 **Clean and scalable code structure**\n    \n-   🧪 **Unit testing for reliability**\n    \n-   🔄 **Separation of concerns** for maintainability\n    \n-   🚨 **Request error handling** for robustness\n    \n\nThis project is designed to strengthen coding skills while following industry best practices in Python development.\n\n## Technologies\n![enter image description here](https://camo.githubusercontent.com/caeca246a36e19149fde4f4bea527bd4b13ef7ed3ed059549d1cde0a5ff4abd8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c61736b2d2532333030302e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d666c61736b266c6f676f436f6c6f723d7768697465) ![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge\u0026logo=python\u0026logoColor=ffdd54) ![NumPy](https://img.shields.io/badge/numpy-%23013243.svg?style=for-the-badge\u0026logo=numpy\u0026logoColor=white)\n----------\n\n## 🏗 Project Architecture\n\nThe application follows a structured folder organization:\n\n```\n📦 calculator-app\n ┣ 📂 src\n ┃ ┣ 📂 calculators ➝ Contains different calculator implementations \u0026 tests\n ┃ ┣ 📂 errors ➝ Handles API errors and exceptions\n ┃ ┣ 📂 main ➝ Application entry point, factories, and routes\n ┃ ┃ ┣ 📂 factories ➝ Factory pattern for modular calculator instances\n ┃ ┃ ┣ 📂 routes ➝ API endpoints and request handling\n ┃ ┃ ┗ 📂 server ➝ Server initialization\n ┗ 📂 .vscode ➝ Development environment settings\n```\n\n## ⚙️ Installation \u0026 Setup\n\n1️⃣ **Clone the Repository:**\n\n```\ngit clone https://github.com/your-username/calculator-app.git\ncd calculator-app\n```\n\n2️⃣ **Create a Virtual Environment (Recommended):**\n\n```\npython -m venv venv\nsource venv/bin/activate  # For macOS/Linux\nvenv\\Scripts\\activate    # For Windows\n```\n\n3️⃣ **Install Dependencies:**\n\n```\npip install -r requirements.txt\n```\n\n4️⃣ **Run the Application:**\n\n```\npython src/main/server/__init__.py  or\npython3 run.py\n```\n\n----------\n\n## 🧪 Running Tests\n\nTo ensure code reliability, run the unit tests with:\n\n```\npytest\n```\n\n\n## 📌 Features\n\n✅ Modular calculator implementations \u003cbr/\u003e\n✅ Factory pattern for scalability \u003cbr/\u003e\n✅ Structured error handling \u003cbr/\u003e\n✅ Unit-tested components \u003cbr/\u003e\n✅ API-ready architecture \u003cbr/\u003e\n✅ NumPy-powered calculations for high-performance processing \u003cbr/\u003e\n\n\n## 🎯 Why This Project?\n\nThis project is an excellent demonstration of Python best practices, test-driven development, and scalable software architecture. If you're looking for a well-structured API project, this is it!\n\n🔹 **Built for scalability** ➝ Designed with clean architecture principles \u003cbr/\u003e\n🔹 **Focused on maintainability** ➝ Code is structured for easy modifications \u003cbr/\u003e\n🔹 **Industry-standard patterns** ➝ Factory design, error handling, and unit testing \u003cbr/\u003e\n🔹 **NumPy integration** ➝ Optimized mathematical computations for performance \u003cbr/\u003e\n\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n\n----------\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiagohrcosta%2Fcalculator-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthiagohrcosta%2Fcalculator-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiagohrcosta%2Fcalculator-app/lists"}