vikramcse / ultimate-go

Ultimate Go learning notes, commented directly on source code

Ultimate Go

This repo contains my notes on learning Go and computer systems. Different people have different learning style. For me, I learn best by doing and walking through examples. Hence, I am trying to take notes carefully and comment directly on the source code, rather than writing up Markdown files. That way, I can understand every single line of code as I am reading and also be mindful of the theories behind the scene.

In the mix, I also include links to other articles that I find helpful.

References:

• Ultimate Go Programming
• ardanlabs/gotraining/topics/courses/go
• Computer Systems: A Programmer's Perspective

Project Status

It is an on-going project.

Below are the outline of the all topics. Normally, a topic is covered when there is a link, or several links next to it.

Tasks

• Phase 1: Finish Ultimate Go Programming's video lectures
• Phase 2: Fill in all the missing details using Ardan Labs's links and examples
• Phase 3: Study Computer Systems book to reinforce the theory. Build more programs if needed.

Table of Contents

• Design Philosophy: Guideline
• Language Mechanics
  • Syntax
    • Variable: Built-in types | Zero value concept | Initialization | Conversion vs Casting
    • Struct: Initialization | Name type vs Anonymous type
    • Pointer:
      • Passing by value | Escape analysis | Stack space | Garbage Collection
      • Golang's Code Review Receiver Type
    • Constant: Initialization | iota
    • Function: Initialization
  • Data Structures
    • Array: CPU Cache | TLB | Initialization | Iteration | Type array | Contiguous memory allocation
    • Slice: Initialization | Length vs Capacity | Reference Type | Appending | Slice of Slice | Copy of Sice | UTF-8
    • Map: Initialization | Iteration | Deleting | Finding | Restriction
  • Decoupling
    • Method:
      • Value and Pointer Receiver Call
      • Value and Pointer Semantics
      • Methods are just functions | Function variable
    • Interface:
      • Valueless type | Concrete type vs Interface type | Relationship | Polymorphic function
      • Interface via Pointer Receiver | Method set | Slice of Interface
    • Embedding:
      • Declaring fields, NOT Embedding
      • Embedding type | Inner type promotion
      • Embedded type and Interface
      • Outer and inner type implementing the same Interface
    • Exporting:
      • Guideline
      • Exported identifier
      • Accessing a value of an unexported identifier
      • Unexported fields from an exported struct
      • Exported types with embedded unexported types
• Software Design
  • Composition: Guideline
    • Grouping types:
      • Grouping By State
      • Grouping By Behavior
    • Decoupling:
      • Struct Composition
      • Decoupling With Interface
      • Interface Composition
      • Decoupling With Interface Composition
    • Conversion:
      • Interface Conversions | Type Assertion
      • Runtime Type Assertion
    • Interface Pollution:
      • Interface Pollution
      • Remove Interface Pollution
    • Mocking:
      • Package To Mock
      • Sample Client
  • Error Handling:
    • Default error values
    • Error variables
    • Type as context
    • Behavior as context
    • Finding the bug
    • Wrapping Errors
  • Packaging: Guideline
• Concurrency
  • Mechanics
    • Goroutine:
      • Go Scheduler Internals
      • Language Mechanics
      • Goroutine time slicing
      • Goroutines and parallelism
    • Data race:
      • Race Detection
      • Atomic Functions
      • Mutexes
      • Read/Write Mutex
    • Channel:
      • Guideline
      • Language Mechanics | Unbuffered channel: Signaling with(out) data
      • Unbuffered channel: Double signal | Buffered channel: Close and range | Unbuffered channel: select and receive | Unbuffered channel: select and send | Buffered channel: Select and drop
      • Unbuffered channel (Tennis match)
      • Unbuffered channel (Replay race)
      • Buffered channel: Fan Out
      • Select
  • Patterns
    • Context:
      • Store and retrieve values from a context
      • WithCancel
      • WithDeadline
      • WithTimeout
      • Request/Response
    • Pattern
      • Task
      • Logger
• Testing and Profiling
  • Testing:
    • Basic Unit Test
    • Table Test
    • Sub Test
    • Web Server
    • Mock Server
    • Test Coverage
  • Benchmarking
    • Basic Benchmark
    • Sub Benchmark
  • Fuzzing
    • Guideline
  • Profiling
    • Stack Trace: Review | Packing
    • GODEBUG: Memory Tracing
• Packages
  • Context
  • Encoding
  • IO
  • Logging
  • Reflection