Add code examples, and documentation

patterns/state/CarState/Car.cs

@@ -0,0 +1,44 @@
+#region
+
+using CarState.States;
+
+#endregion
+
+namespace CarState;
+
+public class Car
+{
+   private State _state;
+
+   public Car()
+   {
+      ChangeState(new Off(this));
+   }
+
+   public bool HandleInput(string input)
+   {
+      switch (input)
+      {
+         case "turn-clockwise":
+            _state.TurnKeyClockwise();
+            break;
+         case "turn-counter":
+            _state.TurnKeyCounterClockwise();
+            break;
+         case "gas":
+            _state.PressGas();
+            break;
+         case "brake":
+            _state.PressBrake();
+            break;
+         case "exit":
+            return false;
+      }
+      return true;
+   }
+
+   public void ChangeState(State state)
+   {
+      _state = state;
+   }
+}

patterns/state/CarState/CarState.csproj

@@ -0,0 +1,6 @@
+<Project Sdk="Microsoft.NET.Sdk">
+   <PropertyGroup>
+      <OutputType>Exe</OutputType>
+      <TargetFramework>net10.0</TargetFramework>
+   </PropertyGroup>
+</Project>

patterns/state/CarState/Program.cs

@@ -0,0 +1,41 @@
+#region
+
+using System;
+
+#endregion
+
+namespace CarState;
+
+internal class Program
+{
+   private static void Main(string[] args)
+   {
+      var car = new Car();
+
+      string input;
+      bool keepRunning = true;
+
+      Console.WriteLine("Welcome to the Driving Simulater");
+      Console.WriteLine();
+      Console.WriteLine("Usage:");
+      Console.WriteLine("    turn-clockwise  -Turns the car's key clockwise");
+      Console.WriteLine(
+         "    turn-counter    -Turns the car's key counter clockwise"
+      );
+      Console.WriteLine("    gas             -Presses the gas pedal");
+      Console.WriteLine("    brake           -Presses the brake pedal");
+      Console.WriteLine("    exit            -Exits the simulator");
+      Console.WriteLine();
+
+      do
+      {
+         Console.Write("> ");
+         input = Console.ReadLine();
+         Console.WriteLine();
+         keepRunning = car.HandleInput(input);
+      } while (keepRunning);
+      Console.WriteLine();
+      Console.WriteLine("goodbye");
+      Console.WriteLine();
+   }
+}

patterns/state/CarState/States/Driving.cs

@@ -0,0 +1,33 @@
+#region
+
+using System;
+
+#endregion
+
+namespace CarState.States;
+
+public class Driving : State
+{
+   public Driving(Car car)
+      : base(car) { }
+
+   public override void TurnKeyClockwise()
+   {
+      Console.WriteLine("You hear a grinding noise...");
+      Console.WriteLine();
+   }
+
+   public override void TurnKeyCounterClockwise()
+   {
+      Console.WriteLine("The engine turns off, and the car stops suddenly");
+      Console.WriteLine();
+      _car.ChangeState(new Off(_car));
+   }
+
+   public override void PressBrake()
+   {
+      Console.WriteLine("The car slows to a stop");
+      Console.WriteLine();
+      _car.ChangeState(new Stopped(_car));
+   }
+}

patterns/state/CarState/States/Off.cs

@@ -0,0 +1,20 @@
+#region
+
+using System;
+
+#endregion
+
+namespace CarState.States;
+
+public class Off : State
+{
+   public Off(Car car)
+      : base(car) { }
+
+   public override void TurnKeyClockwise()
+   {
+      Console.WriteLine("The engine has started");
+      Console.WriteLine();
+      _car.ChangeState(new Stopped(_car));
+   }
+}

patterns/state/CarState/States/State.cs

@@ -0,0 +1,19 @@
+namespace CarState.States;
+
+public class State
+{
+   protected Car _car;
+
+   public State(Car car)
+   {
+      _car = car;
+   }
+
+   public virtual void TurnKeyClockwise() { }
+
+   public virtual void TurnKeyCounterClockwise() { }
+
+   public virtual void PressGas() { }
+
+   public virtual void PressBrake() { }
+}

patterns/state/CarState/States/Stopped.cs

@@ -0,0 +1,33 @@
+#region
+
+using System;
+
+#endregion
+
+namespace CarState.States;
+
+public class Stopped : State
+{
+   public Stopped(Car car)
+      : base(car) { }
+
+   public override void PressGas()
+   {
+      Console.WriteLine("The car begins to drive");
+      Console.WriteLine();
+      _car.ChangeState(new Driving(_car));
+   }
+
+   public override void TurnKeyClockwise()
+   {
+      Console.WriteLine("You hear a grinding noise...");
+      Console.WriteLine();
+   }
+
+   public override void TurnKeyCounterClockwise()
+   {
+      Console.WriteLine("The engine has stopped");
+      Console.WriteLine();
+      _car.ChangeState(new Off(_car));
+   }
+}