Discover gists

Code is clean if it can be understood easily – by everyone on the team. Clean code can be read and enhanced by a developer other than its original author. With understandability comes readability, changeability, extensibility and maintainability.

General rules

Follow standard conventions.
Keep it simple stupid. Simpler is always better. Reduce complexity as much as possible.
Boy scout rule. Leave the campground cleaner than you found it.
Always find root cause. Always look for the root cause of a problem.

Design rules

Goal

Postman is a usefull app to build and test APIs, most commonly installed on ubuntu-like systems via snap. On recent distributions of Linux Mint (20 and above), snap installs are no longer possible. The instructions below show how to install Postman via the terminal.

Download Postman

$ wget https://dl.pstmn.io/download/latest/linux64 -O postman.tar.gz

Extract archive

$ sudo tar -xzf postman.tar.gz -C /opt

Make symlink

UPDATE: I have baked the ideas in this file inside a Python CLI tool called pyds-cli. Please find it here: https://github.com/ericmjl/pyds-cli

How to organize your Python data science project

Having done a number of data projects over the years, and having seen a number of them up on GitHub, I've come to see that there's a wide range in terms of how "readable" a project is. I'd like to share some practices that I have come to adopt in my projects, which I hope will bring some organization to your projects.

Disclaimer: I'm hoping nobody takes this to be "the definitive guide" to organizing a data project; rather, I hope you, the reader, find useful tips that you can adapt to your own projects.

Disclaimer 2: What I’m writing below is primarily geared towards Python language users. Some ideas may be transferable to other languages; others may not be so. Please feel free to remix whatever you see here!

	//
	// Runtime.swift
	// Swift Runtime [Swift 4]
	//
	// The MIT License (MIT)
	//
	// Copyright (c) 2016 Electricwoods LLC, Kaz Yoshikawa.
	//
	// Permission is hereby granted, free of charge, to any person obtaining a copy
	// of this software and associated documentation files (the "Software"), to deal

	import javax.net.ssl.HttpsURLConnection;
	import java.awt.Color;
	import java.io.IOException;
	import java.io.OutputStream;
	import java.lang.reflect.Array;
	import java.net.URL;
	import java.util.ArrayList;
	import java.util.HashMap;
	import java.util.List;
	import java.util.Map;

	[Unit]
	Wants=network-pre.target
	Before=network-pre.target shutdown.target

	[Service]
	User=root
	ExecStart=/bin/sh -ec '\
	[ -x /usr/bin/wslinfo ] && [ "$(/usr/bin/wslinfo --networking-mode)" = "mirrored" ] \|\| exit 0;\
	echo "\
	add chain ip nat WSLPREROUTING { type nat hook prerouting priority dstnat - 1; policy accept; };\

	#!/bin/bash

	# Required parameters:
	# @raycast.schemaVersion 1
	# @raycast.title V2G
	# @raycast.mode compact

	# Optional parameters:
	# @raycast.icon 📸

	#!/bin/bash

	# Update and upgrade Homebrew
	echo "Updating Homebrew..."
	brew update
	brew upgrade


	# Install nvm (Node Version Manager)
	echo "Installing nvm..."

	# Create a resource group
	az group create --name rg-cloudshell-westus-dev-001 --location westus