{"id":13674785,"url":"https://github.com/LucasRGoes/ports-adapters-sample","last_synced_at":"2025-04-28T14:32:16.676Z","repository":{"id":45814869,"uuid":"197781408","full_name":"LucasRGoes/ports-adapters-sample","owner":"LucasRGoes","description":"A sample project that uses the ports and adapters architecture (or hexagonal architecture) for a micro service.","archived":false,"fork":false,"pushed_at":"2022-12-08T05:55:56.000Z","size":109,"stargazers_count":45,"open_issues_count":3,"forks_count":6,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-11-11T14:42:58.113Z","etag":null,"topics":["hexagonal-architecture","microservices","patterns","ports-and-adapters"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LucasRGoes.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":"2019-07-19T13:54:50.000Z","updated_at":"2024-11-09T22:29:00.000Z","dependencies_parsed_at":"2023-01-24T16:18:48.882Z","dependency_job_id":null,"html_url":"https://github.com/LucasRGoes/ports-adapters-sample","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucasRGoes%2Fports-adapters-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucasRGoes%2Fports-adapters-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucasRGoes%2Fports-adapters-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucasRGoes%2Fports-adapters-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LucasRGoes","download_url":"https://codeload.github.com/LucasRGoes/ports-adapters-sample/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251330416,"owners_count":21572283,"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":["hexagonal-architecture","microservices","patterns","ports-and-adapters"],"created_at":"2024-08-02T11:01:01.315Z","updated_at":"2025-04-28T14:32:16.347Z","avatar_url":"https://github.com/LucasRGoes.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"Micro Service with Ports and Adapters Architecture\n==================================================\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis project is a simple micro service of a REST API for library management in order to present an example of a software developed using the ports and adapters architecture (or hexagonal architecture).\n\nThe project was created in order to facilitate the study of the ports and adapters architecture and other software development patterns.\n\n## Architecture\n\n![](./resources/images/architecture.png?raw=true)\n\n## References\n* [Ports and Adapters Pattern](https://softwarecampament.wordpress.com/portsadapters/#tc2-1)\n* [Ports and Adapters with Command Handler pattern in Python](https://io.made.com/introducing-command-handler/)\n* [Hexagonal Architecture](https://fideloper.com/hexagonal-architecture)\n* [Ports \u0026 Adapters Architecture](https://herbertograca.com/2017/09/14/ports-adapters-architecture/)\n* [Build Maintainable Systems With Hexagonal Architecture](https://java-design-patterns.com/blog/build-maintainable-systems-with-hexagonal-architecture/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLucasRGoes%2Fports-adapters-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLucasRGoes%2Fports-adapters-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLucasRGoes%2Fports-adapters-sample/lists"}