{"id":25127880,"url":"https://github.com/remora/remora.rest","last_synced_at":"2025-07-17T19:37:47.848Z","repository":{"id":37012070,"uuid":"408560867","full_name":"Remora/Remora.Rest","owner":"Remora","description":"Reusable tooling for interacting with JSON-driven REST APIs","archived":false,"fork":false,"pushed_at":"2025-02-13T13:08:38.000Z","size":673,"stargazers_count":7,"open_issues_count":3,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T16:09:39.810Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Remora.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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}},"created_at":"2021-09-20T18:40:27.000Z","updated_at":"2025-02-13T13:08:42.000Z","dependencies_parsed_at":"2024-02-13T07:46:41.062Z","dependency_job_id":null,"html_url":"https://github.com/Remora/Remora.Rest","commit_stats":{"total_commits":186,"total_committers":11,"mean_commits":16.90909090909091,"dds":0.3763440860215054,"last_synced_commit":"eaa8770bbc014852d40f5b341c07113750b4e665"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remora%2FRemora.Rest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remora%2FRemora.Rest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remora%2FRemora.Rest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Remora%2FRemora.Rest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Remora","download_url":"https://codeload.github.com/Remora/Remora.Rest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248065283,"owners_count":21041871,"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":[],"created_at":"2025-02-08T11:19:41.564Z","updated_at":"2025-04-09T16:09:47.926Z","avatar_url":"https://github.com/Remora.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"Remora.Rest\n===========\nRemora.Rest is a compact helper library for building REST API wrappers, giving\nyou the tools you need to rapidly create robust, highly configurable wrappers of\nyour own.\n\nThe library is somewhat opinionated, and it does target a single subset of REST\nAPI types - those whose payloads (error or otherwise) are JSON-serialized. For \nthese use cases, however, the library is quite adept at what it does.\n\n## Quickstart\nAt its core, the library expects you to do two things - one, to access the REST\nendpoints through a configured `RestHttpClient\u003cTError\u003e`, and two, to define the\nentities in the API model through an interface/implementation combination.\n\n```c#\nvar services = new ServiceCollection();\n\nvar clientBuilder = services\n    .AddRestHttpClient\u003cRestHttpClient\u003cErrorPayloadType\u003e\u003e();\n\n// Perform HttpClient configuration (adding Polly policies, setting default\n// request headers, etc)\nclientBuilder...\n\n// Configure API model types\nservices.Configure\u003cJsonSerializerOptions\u003e(clientBuilder.Name, options =\u003e \n{\n    options.AddDataObjectConverter\u003cIModelType, ModelType\u003e();\n});\n```\n\nAfter you've set up your client and your types, you can then inject an instance\nof `RestHttpClient\u003cTError\u003e` into your actual API wrapper type (the instance is\ntransient, so you can treat it the same as any HttpClient you'd normally \ninject).\n\n```c#\npublic class MyWrapper\n{\n    private readonly RestHttpClient\u003cErrorPayloadType\u003e _restClient;\n    \n    public MyWrapper(RestHttpClient\u003cErrorPayloadType\u003e restClient)\n    {\n        _restClient = restClient;\n    }\n}\n```\n\nMore detailed documentation will hopefully be available in the future; in the \nmeantime, check out [Remora.Discord][1], for which this project was originally\ndeveloped - it pushes all available functionality to its limits, and serves as a\nrelatively comprehensive demonstration of what you can do with the library.\n\n\n[1]: https://github.com/Remora/Remora.Discord\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremora%2Fremora.rest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremora%2Fremora.rest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremora%2Fremora.rest/lists"}