General perspective

Library design

Great libraries often follow Unix philosophy: do one thing and do it well

Libraries provide a layer of reusable software which we compose into our programs.

API design

what is an API?

In a nutshell, an API (or Application Programming Interface) is the code that allows applications to talk to each other. But why would you need an API?

Let's say you want to build an app that will list all the off-leash dog parks within a 20-mile radius and give you directions on how to get there from your location.

Instead of collecting all that data and building all those features yourself from scratch, you can take a shortcut and utilize APIs.

How exactly would you do that, in this example?

Many cities provide APIs that list the locations and other information for their dog parks. Google Maps provides an API that will tell you how to get from where you are to any given location.

You can utilize those two existing APIs to build a new app that will do the following: Call the city’s API to retrieve the nearest off-leash dog parks, and Call Google’s API to retrieve the directions from your location.

Bada-bing, bada-boom. Your dog is chasing frisbees in no time.

Authentication and authorization

Intro to Authentication

So, what’s the difference between authentication and authorization?
And what's OAuth?
Getting started with authentication
Best practices

Already know what authentication is? Skip to Getting Started with Authentication.

Because the Eventbrite API provides entry points into the secure parts of the Eventbrite platform, the protection of the data is an integral part of the API and the system as a whole. Authentication and authorization work as a team to secure the Eventbrite API. So, what’s the difference between authentication and authorization?

Imagine you’re in line to see your favorite band in concert.

Authentication verifies your identity, just like the security guard checking your ID at the door to make sure it matches the name on your ticket.

OAuth does this by providing you with a public or private token. Every request to the Eventbrite platform must be authenticated; no unauthorized access is allowed. For more on OAuth, see the And what's OAuth? section.

Authorization verifies your privileges, just like the usher who scans your ticket and walks you to the section that you’re allowed to access, whether it's general admission, the front row, or a backstage to meet the band.

OAuth does this by generating a private token that's tied to an account or user. Each time you request something, you'll send this token to the server so that it knows whom the request came from and what that request is allowed to do.

Authorization privileges might include the data, files, and pages you can view, edit, download, or delete.

Once you have your token, you’ll use the same one every time you access the API. And what's OAuth?

OAuth 2 (Open Authorization) is a security technology used for token-based authorization on the Internet. An OAuth token can also be called a private token.

OAuth 2 replaced OAuth1 and is currently the most recent version of OAuth and the leading authorization solution on the Internet.

Python's perspective

Ruby's perspective

Perl's perspective

PHP's perspective

Everyone needs a framework. What everyone does not need a general purpose framework. Nobody has a general problem. Everyone has a very specific problem to solve. And a general purpose framework while it can solve it, it usually solves in a way that you get so many things that you don't need that ends up being done on every request. Usually what happens, when a company grows and starts with a general purpose framework, they start optimizing things by ripping stuff out and tear the framework apart to the point they could never upgrade. If there is a newer version of the framework, they modified the damned framework so much they are stuck on the version they are on and I think this is a huge problem.

I admire PHP and its ability of solving problems. It grows because, some times, some poor soul wants to create an online encyclopaedia, or some teacher needs an online teaching platform, or someone wants to write a blog. Those people do not want to learn to program, they want to solve problems.

LibreOffice's perspective

Misc

Index