Hacker News new | ask | show | jobs
by dreamdu5t 5366 days ago
What's with the "for human beings" phrase? Is that a way of saying the software is easy?
4 comments

Some APIs are appropriate for programmers to target. Others are more appropriate for compilers or higher-abstraction libraries to target.
"Requests is an ISC Licensed HTTP library, written in Python, for human beings.

Most existing Python modules for sending HTTP requests are extremely verbose and cumbersome. Python’s builtin urllib2 module provides most of the HTTP capabilities you should need, but the api is thoroughly broken. It requires an enormous amount of work (even method overrides) to perform the simplest of tasks."

It would appear so. Based off of testimonials and briefly looking at the API I'd say this is primarily aimed at a simple API + fewer "gotchas"

E.g., urllib/urllib2 both support urlopen(url, [data]) if `data` is supplied the request is executed as a POST, if not it is executed as a GET.

Issuing a GET w/ a querystring requires mutating the `url` and omitting `data`. This surprised me at first, and probably a number of others

It generally means it has an API which lends itself to writing readable, intuitive code.