Create fully typed declarative API clients quickly and easily. - martinn/quickapiclient
A library for creating fully typed and declarative API clients, quickly and easily.
What would an API client with this library look like?
For a single API endpoint over HTTP GET, it could look something like this:
``` from dataclasses import dataclass import quickapi
An example type that will be part of the API response
@dataclass class Fact: fact: str length: int
What the API response should look like
@dataclass class ResponseBody: current_page: int data: list[Fact]
Now we can define our API
class MyApi(quickapi.BaseApi[ResponseBody]): url = "https://catfact.ninja/facts" response_body = ResponseBody ```
And you would use it like this:
``` response = MyApi().execute()
That's it! Now response
is fully typed (including IDE support) and conforms to our ResponseBody
definition
assert isinstance(response.body, ResponseBody) assert isinstance(response.body.data[0], Fact) ```
It also supports attrs
or pydantic
(or dataclasses
as above) for your model/type definitions, including validation and types/data conversion.
I have a lot more examples (e.g. POST requests, query string params, authentication, error handling, model validation and conversion, multiple API endpoints) on the repo's README.
I've shared this one here before but it's been a while and I've added a lot of features since.
Github repo: https://github.com/martinn/quickapiclient
Aggregate git blame stats across any git repository. Find out top contributors by Lines of Code. - martinn/repoblame
I've always been curious about this. If I were to take a snapshot of a git repo at a particular point in time, who would be the top contributors by active lines of code? And then, what type of files have they contributed the most? So I built this little tool.
I've been wanting to learn rust for quite some time now and this was one of my first projects in it. It was a lot of fun!
It uses git
under the hood to obtain the information and it's nothing fancy, but keen to hear what you think.
I built a little tool that allows you to see top contributors to any git repo by lines of code (and also top file types).
Create fully typed declarative API clients quickly and easily. - martinn/quickapiclient
cross-posted from: https://programming.dev/post/13395352
> Would love to hear any suggestions, feedback or comments.
A library for creating fully typed declarative API clients quickly and easily. - martinn/quickapiclient
cross-posted from: https://programming.dev/post/13395352
> Would love to hear any suggestions, feedback or comments.
Glad to hear that! Let me know how it goes.
Nice! Keen to hear how you go. Any issues at all just let me know.
Thanks! There's a few "similar" projects that I've seen but IMHO not as clean or easy to use.
A library for creating fully typed declarative API clients quickly and easily. - martinn/quickapiclient
Would love to hear any suggestions, feedback or comments.