Felipe Custódio felipecustodio

The Best of the Best Practices (BOBP) Guide for Python

A "Best of the Best Practices" (BOBP) guide to developing in Python.

In General

Values

"Build tools for others that you want to be built for you." - Kenneth Reitz
"Simplicity is alway better than functionality." - Pieter Hintjens

Latency numbers every programmer should know

L1 cache reference ......................... 0.5 ns
Branch mispredict ............................ 5 ns
L2 cache reference ........................... 7 ns
Mutex lock/unlock ........................... 25 ns
Main memory reference ...................... 100 ns             
Compress 1K bytes with Zippy ............. 3,000 ns  =   3 µs
Send 2K bytes over 1 Gbps network ....... 20,000 ns  =  20 µs
SSD random read ........................ 150,000 ns  = 150 µs

Read 1 MB sequentially from memory ..... 250,000 ns = 250 µs

	# Install ARCH Linux with encrypted file-system and UEFI
	# The official installation guide (https://wiki.archlinux.org/index.php/Installation_Guide) contains a more verbose description.

	# Download the archiso image from https://www.archlinux.org/
	# Copy to a usb-drive
	dd if=archlinux.img of=/dev/sdX bs=16M && sync # on linux

	# Boot from the usb. If the usb fails to boot, make sure that secure boot is disabled in the BIOS configuration.

	# Set swedish keymap

	#include <SDL2/SDL.h>
	#include <SDL2/SDL_mixer.h>

	#define WAV_PATH "Roland-GR-1-Trumpet-C5.wav"
	#define MUS_PATH "HR2_Friska.ogg"

	// Our wave file
	Mix_Chunk *wave = NULL;
	// Our music file
	Mix_Music *music = NULL;

	#include <SDL2/SDL.h>

	#define MUS_PATH "Roland-GR-1-Trumpet-C5.wav"

	// prototype for our audio callback
	// see the implementation for more information
	void my_audio_callback(void userdata, Uint8 stream, int len);

	// variable declarations
	static Uint8 *audio_pos; // global pointer to the audio buffer to be played