i.an randomradio

Rusty's API Design Manifesto

The idea

Application Programming Interface (API) design is hard. But it's even harder to change once you get it wrong. So what you should do is to spend the effort to get it right the first time around.

In the Linux Kernel community Rusty Russell came up with a API rating scheme to help us determine if our API is sensible, or not. It's a rating from -10 to 10, where 10 is perfect is -10 is hell. Unfortunately there are too many examples at the wrong end of the scale.

Rusty's original descriptions

Descriptions of the positive API levels

Rusty's API Design Manifesto

The idea

Application Programming Interface (API) design is hard. But it's even harder to change once you get it wrong. So what you should do is to spend the effort to get it right the first time around.

In the Linux Kernel community Rusty Russell came up with a API rating scheme to help us determine if our API is sensible, or not. It's a rating from -10 to 10, where 10 is perfect is -10 is hell. Unfortunately there are too many examples at the wrong end of the scale.

Rusty's original descriptions

Descriptions of the positive API levels

Bulk delete repositories, keep your github sane and remind you how many undone project you hoarded.

Delete all repos

repos.txt contains a list of repository names in {UserName}/{RepoName} format, e.g. IanZhao/to-be-deleted. use this file to track all repositories you want to delete.
Open fetchSaveRepo.js and update url with your github username.
you need node-fetch to fetch contents, just do a npm init with default settings and run npm install node-fetch.
run node fetchSaveRepo.js
Generate a Authorization Token for repo delete access token
Copy the token and put in in place TOKEN_HERE in deleteRepos.sh

Django documentation says to use:

WSGIScriptAlias / /path/to/mysite.com/mysite/wsgi.py
WSGIPythonPath /path/to/mysite.com

<Directory /path/to/mysite.com/mysite>
<Files wsgi.py>
Require all granted

Difference between Debounce and Throttle

Debounce

Debounce a function when you want it to execute only once after a defined interval of time. If the event occurs multiple times within the interval, the interval is reset each time.
Example A user is typing into an input field and you want to execute a function, such as a call to the server, only when the user stops typing for a certain interval, such as 500ms.

Throttle

Difference between Debounce and Throttle

Debounce

Debounce a function when you want it to execute only once after a defined interval of time. If the event occurs multiple times within the interval, the interval is reset each time.
Example A user is typing into an input field and you want to execute a function, such as a call to the server, only when the user stops typing for a certain interval, such as 500ms.

	# UPDATED 17 February 2019
	# Redirect all HTTP traffic to HTTPS
	server {
	listen 80;
	listen [::]:80;
	server_name www.domain.com domain.com;
	return 301 https://$host$request_uri;
	}

	# SSL configuration

	# UPDATED 17 February 2019
	# Redirect all HTTP traffic to HTTPS
	server {
	listen 80;
	listen [::]:80;
	server_name www.domain.com domain.com;
	return 301 https://$host$request_uri;
	}

	# SSL configuration

	# 0 is too far from ` ;)
	set -g base-index 1
	# reset keys
	unbind-key -n S-Left
	unbind-key -n S-Right

	# custom binding
	set -g prefix C-s
	bind C-s send-prefix

	import bs4
	import cssutils
	import logging
	import urlparse


	class HTML_cleaner(object):

	soup = None;
	highlighting_selectors = {}