Upgrade to Pro — share decks privately, control downloads, hide ads and more …

API Driven Development (Data Science Edition)

API Driven Development (Data Science Edition)

Kenneth Reitz

June 15, 2015
Tweet

More Decks by Kenneth Reitz

Other Decks in Programming

Transcript

  1. Hi.

  2. Httpbin.org $ curl http://httpbin.org/get?test=1 { "url": "http://httpbin.org/get", "headers": { "Content-Length":

    "", "Connection": "keep-alive", "Accept": "*/*", "User-Agent": "curl/7.21.4 ...", "Host": "httpbin.org", "Content-Type": "" }, "args": { “test”: “1” }, "origin": "67.163.102.42" }
  3. Et Cetera • Legit: Git Workflow for Humans • Envoy:

    Subprocess for Humans • Tablib: Tabular Data for Humans • Clint: CLI App Toolkit • Autoenv: Magic Shell Environments • OSX-GCC-Installer: Provokes Lawyers 275+ More
  4. — Steve Jobs, 1983 People are going to be spending

    two or three hours a day with these machines — more than they spend with a car.
  5. — Steve Jobs, 1983 Software design must be given at

    least as much consideration as we give automobiles today — if not a lot more.
  6. Beautiful Interfaces. • Industrial Design • Web Interfaces • iOS,

    Android, Mobile Apps • Desktop Clients & Applications Today, beautiful applications abound.
  7. Web Application Management Tools Supporting Services Tools & Utilities Web

    Process Worker Process Scheduled Tasks Deferred Tasks API Service CRUD Admin Data Persistence User Interface Authentication
  8. API Service End Users API Service Internal API Service Developers

    ( ) Data Persistence Message Queue Workers
  9. A Real, Tangible Problem. You can't solve a problem properly

    if you don't experience it firsthand.
  10. Example: GitHub • GitHub wasn't built for the developer community

    at large. • Resonated with millions of developers. • They themselves happen to be developers. Over two million people collaborating.
  11. Other’s Success • Gumroad, built for the founder. • 37

    Signals product, build for the team. • Ruby on Rails, by Rubyists for Rubyists.
  12. Optimization • Feature driven development? • Profit driven development? •

    Growth driven development? • Problem driven development. What drives your decisions?
  13. pra•gmat•ic |pragˈmatik|, adj: Dealing with things sensibly and realistically in

    a way that is based on practical rather than theoretical considerations
  14. We know Ruby... require 'net/http' require 'uri' uri = URI.parse('https://api.github.com/user')

    http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true req = Net::HTTP::Get.new(uri.request_uri) req.basic_auth('username', 'password') r = http.request(req) puts r
  15. import urllib2 gh_url = 'https://api.github.com/user' req = urllib2.Request(gh_url) password_manager =

    urllib2.HTTPPasswordMgrWithDefaultRealm() password_manager.add_password(None, gh_url, 'user', 'pass') auth_manager = urllib2.HTTPBasicAuthHandler(password_manager) opener = urllib2.build_opener(auth_manager) urllib2.install_opener(opener) handler = urllib2.urlopen(req) print handler.read()
  16. import re class HTTPForcedBasicAuthHandler(HTTPBasicAuthHandler): auth_header = 'Authorization' rx = re.compile('(?:.*,)*[

    \t]*([^ \t]+)[ \t]+' 'realm=(["\'])(.*?)\\2', re.I) def __init__(self, *args, **kwargs): HTTPBasicAuthHandler.__init__(self, *args, **kwargs) def http_error_401(self, req, fp, code, msg, headers): url = req.get_full_url() response = self._http_error_auth_reqed( 'www-authenticate', url, req, headers) self.reset_retry_count() return response http_error_404 = http_error_401
  17. Let’s Break it Down. • A small set of methods

    with consistent parameters. • HEAD, GET, POST, PUSH, PUT, PATCH, DELETE, &c. • They all accept Headers, URL Parameters, Body/Form Data. What is HTTP at its core?
  18. Achievement Unlocked! • A small set of methods with consistent

    parameters. • HEAD, GET, POST, PUSH, PUT, PATCH, DELETE, &c. • They all accept Headers, URL Parameters, Body/Form Data.
  19. Requests Success • Python is a language built for Humans.

    • Why should HTTP be non-trivial? • I explored and discovered what I really needed, and built it. • I had a real problem that I solved for myself.
  20. Requests Success • At first, Requests was far from powerful.

    • But, it deeply resonated with people. • Features grew over time, but the API was never compromised. • Quite popular (48,000,000 downloads).
  21. • Before any code is written, write the README —

    show some examples. • Write some code with the theoretical code that you’ve documented.
  22. Achievement Unlocked! • Instead of engineering something to get the

    job done, you interact with the problem itself and build an interface that reacts to it. • You discover it. You respond to it.
  23. • Great sculptures aren’t engineered or manufactured—they’re discovered. • The

    sculptor studies and listens to the marble. He identifies with it. • Then, he responds. • Setting free something hidden that inside all along. Sculptures, Etc.
  24. • It’s not about a design that will “work” on

    a phone, tablet, and desktop. • It’s about making something that identifies itself enough to respond to the environment it’s placed in. • Free of arbitrary constraints. Responsive Design
  25. • Once you discover the API: build it. • Write

    all the code necessary to make exactly what you documented happen. • Complex code? Layer your API. • “Porcelain” layer is documented. Responsive Design
  26. Do unto others as you would have them do to

    you? Build tools for others that you want to be built for you.
  27. Build for Open Source • Components become concise & decoupled.

    • Concerns separate themselves. • Best practices emerge (e.g. no creds in code). • Documentation and tests become crucial. • Code can be released at any time.
  28. • Anaconda: Python distribution for humans and scientists (“it just

    works”) • Heroku: turnkey machine resources. • Conda Buildpack for Heroku. Recommended Tools