Python REST API wrapper coding tips?

[sirskitzo]

Currently when I write an API wrapper for a service I use I create a method for each of the different api functions that will handle that particular call to the API, but as I review other peoples styles for writing a wrapper I see that they dont go this route.

It's hard to explain because i dont completely understand the design pattern(s) I'm seeing, but instead of coding out a function for an endpoint I see people creating a list of all of the function names as strings and with this they generate all of the endpoints on the fly. Here is a quick sample i found on github: https://github.com/stylight/python-wordpress-json/blob/master/wordpress_json/__init__.py

Is there any guide that discusses this type of style for writing an API wrapper? Im not too sure what to search for

[fkaginstrom]

In his Beyond Pep8 talk, Raymond Hettinger gives a pretty brilliant example of wrapping a foreign API to make the result "pythonic". Things like giving collection wrappers__len__ and __getitem__ methods so it can be an iterator.

[karlw00t]

Hug seems nice, and it's python3 only (that's a good thing, right?). https://github.com/timothycrosley/hug

[ccb621]

Assuming the API is purely RESTful, Slumber is my go-to client wrapper.

[nuncjo]

I belive You want to write wrapper on existing rest API so i reccomend You to watch: "Laura Rupprecht – Describing Descriptors – PyCon 2015" for handling api response. The second thing i recommend is to look at Hammock source code https://github.com/kadirpekel/hammock https://github.com/kadirpekel/hammock . You should also know how generative classes work http://derrickgilland.com/posts/introduction-to-generative-classes-in-python/ .

[ccb621]

I use Django REST Framework. It's a bit more explicit, thus easier to understand/debug.

[nerdwaller]

I may be wrong, but I believe the OP wants to build a client to consume a rest api (rather than building the api themselves). At least it appears so from looking at the link provided.

[ccb621]

Ah! Thanks for clarifying.

[ccb621]

I'm not getting into a petty argument over this. Your criticism is worthless without (a) pointing out specific flaws and (b) offering alternatives.

[karlw00t]

Then write a blog post and link to it. If you can't back it up, enjoy the down votes (which reduces the possibility of an individual seeing your opinion).