DT epoch

[NOTE: The original version was posted in 2007 on an O'Reilly blog, but the page has been erroring out for months now. I'm copying it here because archive.org, while useful, can be slow. chromatic is a lovely person who (he thinks) probably has copyright to this piece.]

The "Is It a DSL or an API?" Ten Question Checklist

Saturday May 19, 2007 6:00AM
by chromatic in Opinion

Chapter 1 - Object Oriented Design

The purpose of design is to allow you to do design later, and it's primary goal is to reduce the cost of change.

SOLID Design:

Single Responsibility Principle: a class should have only a single responsibility
Open-Closed Principle: Software entities should be open for extension, but closed for modification (inherit instead of modifying existing classes).
Liskov Substitution: Objects in a program should be replaceable with instances of their subtypes without altering the correctness of that program.
Interface Segregation: Many client-specific interfaces are better than one general-purpose interface.

Better local require() paths for Node.js

Problem

When the directory structure of your Node.js application (not library!) has some depth, you end up with a lot of annoying relative paths in your require calls like:

const Article = require('../../../../app/models/article');

Those suck for maintenance and they're ugly.

Possible solutions

Deploying a subfolder to GitHub Pages

Sometimes you want to have a subdirectory on the master branch be the root directory of a repository’s gh-pages branch. This is useful for things like sites developed with Yeoman, or if you have a Jekyll site contained in the master branch alongside the rest of your code.

For the sake of this example, let’s pretend the subfolder containing your site is named dist.

Step 1

Remove the dist directory from the project’s .gitignore file (it’s ignored by default by Yeoman).

OS X Screencast to animated GIF

This gist shows how to create a GIF screencast using only free OS X tools: QuickTime, ffmpeg, and gifsicle.

Instructions

To capture the video (filesize: 19MB), using the free "QuickTime Player" application:


	-- An alternative GildedRose using an immutable approach.
	-- Context on the GildedRose:
	-- * http://blog.lunarlogic.io/2015/what-ive-learned-by-doing-the-gilded-rose-kata-4-refactoring-tips/
	-- * my comment in the linked blog post
	-- One could take this GildedTulip approach and encapsulate a similar "immutable API"
	-- to re-create the "mutable API" of the GildedRose.
	--
	-- This example is written in Haskell. This example uses three notable features (available in other languages):
	-- - pattern matching: a way to hide a lot of "if"

	/*
	Assuming jQuery Ajax instead of vanilla XHR
	*/

	//Get Github Authorization Token with proper scope, print to console
	$.ajax({
	url: 'https://api.github.com/authorizations',
	type: 'POST',
	beforeSend: function(xhr) {
	xhr.setRequestHeader("Authorization", "Basic " + btoa("USERNAME:PASSWORD"));

	/** @jsx React.DOM */
	var MyRootComponent = React.createClass({
	getInitialState: function() {
	return {perMinute: '-', perDay: '-'};
	},
	componentDidMount: function() {
	var socket = io.connect(this.props.url);
	socket.on('business.clickout', this.setState.bind(this));
	},
	render: function() {

	/** @jsx React.DOM */
	var MyComponent = React.createClass({
	getInitialState: function() {
	// set up the initial state. used for "logical" initialization code
	return {perMinute: '-', perDay: '-'};
	},
	componentDidMount: function() {
	// fired only once, when the component is added to the DOM
	// used for initialization code that has "side effects" i.e. i/o, jquery plugins, etc
	var socket = io.connect(this.props.url);

	=Navigating=
	visit('/projects')
	visit(post_comments_path(post))

	=Clicking links and buttons=
	click_link('id-of-link')
	click_link('Link Text')
	click_button('Save')
	click('Link Text') # Click either a link or a button
	click('Button Value')