add: new tictactoe game

add: testing to tictactoe

rename: tictactoe

add: tictactoe steps

refactor: tictactoe const names

refactor: tictactoe loop

add: tictactoe bad switch example (fallthrough)

refactor: tictactoe loop skin

remove: tictactoe changable skin

refactor: tictactoe all

remove: tictactoe unnecessary base dir

add: tictactoe slices

add: tictactoe slices

remove: tictactoe fallthrough

rename: tictactoe slices 10 -> 09

update: loops skin tictactoe

add: tictactoe randomization

add: tictactoe infinite loop and labeled break

refactor: tictactoe rand and infinite loop

add: tictactoe buggy winning algo

add: tictactoe more tests

rename: tictactoe wrongPlay to wrongMove

add: tictactoe even more tests

fix: tictactoe

rename: tictactoe waitForInput to wait

add: tictactoe os.args gameSpeed

remove: tictactoe unnecessary files

rename: tictactoe game messages

refactor: tictactoe main loop

add: types and arrays

x-tba/tictactoe/11-randomization/board.go

@@ -0,0 +1,26 @@
+package main
+
+import "fmt"
+
+// printBoard prints the board
+func printBoard() {
+	fmt.Printf("%s\n\n", banner)
+	fmt.Printf("%s\n", sepHeader)
+
+	for i, step := 0, 3; i < len(cells); i += step {
+		fmt.Print(sepCell)
+
+		for j := 0; j < step; j++ {
+			move := cells[i+j]
+			fmt.Printf(" %s %s", move, sepCell)
+		}
+
+		fmt.Println()
+
+		if lastLine := (i + step); lastLine != len(cells) {
+			fmt.Println(sepLine)
+		}
+	}
+
+	fmt.Printf("%s\n", sepFooter)
+}

x-tba/tictactoe/11-randomization/board_test.go

@@ -0,0 +1,41 @@
+package main
+
+// Examples are normally used for showing how to use your package.
+// But you can also use them as output testing.
+
+func ExamplePrintBoard() {
+	printBoard()
+
+	// Output:
+	// ~~~~~~~~~~~~~~~
+	//   TIC~TAC~TOE
+	// ~~~~~~~~~~~~~~~
+	//
+	// /---+---+---\
+	// |   |   |   |
+	// +---+---+---+
+	// |   |   |   |
+	// +---+---+---+
+	// |   |   |   |
+	// \---+---+---/
+}
+
+func ExamplePrintBoardCells() {
+	cells[0] = player1
+	cells[4] = player2
+	cells[8] = player1
+	printBoard()
+
+	// Output:
+	// ~~~~~~~~~~~~~~~
+	//   TIC~TAC~TOE
+	// ~~~~~~~~~~~~~~~
+	//
+	// /---+---+---\
+	// | X |   |   |
+	// +---+---+---+
+	// |   | O |   |
+	// +---+---+---+
+	// |   |   | X |
+	// \---+---+---/
+}

x-tba/tictactoe/11-randomization/init.go

@@ -0,0 +1,20 @@
+package main
+
+import (
+	"math/rand"
+	"time"
+)
+
+// init is another special function
+// Go calls it before the main function
+func init() {
+	rand.Seed(time.Now().UnixNano())
+	initCells()
+}
+
+// initCells initialize the played cells to empty
+func initCells() {
+	for i := range cells {
+		cells[i] = emptyCell
+	}
+}

x-tba/tictactoe/11-randomization/main.go

@@ -0,0 +1,69 @@
+package main
+
+import "fmt"
+
+/*
+~ TICTACTOE GAME IN GO ~
++ This example uses the very basics of the Go language.
++ The goal is learning all the basics.
+*/
+
+const maxTurns = 9
+
+var (
+	won    bool   // is there any winner?
+	turn   int    // total valid turns played
+	player string // current player
+
+	cells     [maxTurns]string // used to draw the board: contains the players' moves
+	lastPos   int              // last played position
+	wrongMove bool             // was the last move wrong?
+)
+
+func main() {
+	player = player1
+	printBoard()
+
+	for i := 0; i < 4; i++ {
+		wait()
+		play()
+		printBoard()
+
+		fmt.Printf("\n>>> PLAYER %q PLAYS to %d\n", player, lastPos+1)
+		printEnding()
+	}
+}
+
+func wait() {
+	fmt.Println()
+	fmt.Scanln()
+}
+
+// printStatus prints the current status of the game
+// it cannot access to the names (vars, consts, etc) inside any other func
+func printStatus() {
+	fmt.Println()
+
+	progress := (1 - (float64(turn) / maxTurns)) * 100
+	fmt.Printf("Current Turn           : %d\n", turn)
+	fmt.Printf("Is there a winner      : %t\n", won)
+	fmt.Printf("Turns left             : %.1f%%\n", progress)
+}
+
+func printEnding() {
+	switch {
+	default:
+		switchPlayer()
+		printStatus()
+
+	case wrongMove:
+		fmt.Printf(">>> CELL IS OCCUPIED: PLAY AGAIN!\n")
+		wrongMove = false // reset for the next turn
+
+	case won:
+		fmt.Printf(">>> WINNER: %s\n", player)
+
+	case turn == maxTurns:
+		fmt.Println(">>> TIE!")
+	}
+}

x-tba/tictactoe/11-randomization/play.go

@@ -0,0 +1,48 @@
+package main
+
+import "math/rand"
+
+// play plays the game for the current player.
+// + registers the player's move in the board.
+// if the move is valid:
+// + increases the turn.
+func play() {
+	// [" ", " ", " ", " ", " ", " ", " ", " ", " " ] -> cells slice
+	//   0    1    2    3    4    5    6    7    8    -> indexes
+
+	// /---+---+---\
+	// | 0 | 1 | 2 |
+	// +---+---+---+
+	// | 3 | 4 | 5 |
+	// +---+---+---+
+	// | 6 | 7 | 8 |
+	// \---+---+---/
+
+	// pick a random move (very intelligent AI!)
+	// it can play to the same position!
+	lastPos = rand.Intn(maxTurns)
+
+	// is it a valid move?
+	if cells[lastPos] != emptyCell {
+		wrongMove = true
+
+		// skip the rest of the function from running
+		return
+	}
+
+	// register the move: put the player's sign on the board
+	cells[lastPos] = player
+
+	// increment the current turns
+	turn++
+}
+
+// switchPlayer switches to the next player
+func switchPlayer() {
+	// switch the player
+	if player == player1 {
+		player = player2
+	} else {
+		player = player1
+	}
+}

x-tba/tictactoe/11-randomization/skin.go

@@ -0,0 +1,17 @@
+package main
+
+const (
+	banner = `
+~~~~~~~~~~~~~~~
+  TIC~TAC~TOE
+~~~~~~~~~~~~~~~`
+
+	// skin options :-)
+	player1, player2 = "X", "O"
+	emptyCell        = " "
+
+	sepHeader = `/---+---+---\`
+	sepLine   = `+---+---+---+`
+	sepFooter = `\---+---+---/`
+	sepCell   = "|"
+)