soshial

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.

	#!/bin/bash
	# merge2ass.sh - script for merging two text-subtitles into an ass subtitle file
	# version 0.9b, 02-feb-2013
	# comments/criticism/praise to jose1711-gmail-com

	# dependencies: mplayer (if your subtitle files need to be converted to srt), gnu utils

	# thanks to:
	# - d.watzke for comments
	# - belisarivs for testing

	# Thanks to commenters for providing the base of this much nicer implementation!
	# Save and run with $ python 0dedict.py
	# You may need to hunt down the dictionary files yourself and change the awful path string below.
	# This works for me on MacOS 10.14 Mohave

	from struct import unpack
	from zlib import decompress
	import re
	filename = '/System/Library/Assets/com_apple_MobileAsset_DictionaryServices_dictionaryOSX/9f5862030e8f00af171924ebbc23ebfd6e91af78.asset/AssetData/Oxford Dictionary of English.dictionary/Contents/Resources/Body.data'
	f = open(filename, 'rb')

soshial

General rules

Design rules