From f77737bb908217de917bd5f720609d285062f290 Mon Sep 17 00:00:00 2001
From: Ben Harris <ben@tilde.team>
Date: Wed, 22 Apr 2020 11:48:54 -0400
Subject: [PATCH] add example to README.md

---
 README.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/README.md b/README.md
index 59c8c51..c5fc943 100644
--- a/README.md
+++ b/README.md
@@ -3,3 +3,89 @@
 this is a c\# port of jesopo's [irctokens](
 https://github.com/jesopo/irctokens)
 
+## usage
+
+### tokenization
+
+    using IrcTokens;
+    
+    ...
+
+    var line = new Line("@id=123 :ben!~ben@host.tld PRIVMSG #channel :hello there!");
+    Console.WriteLine(line);
+    Console.WriteLine(line.Format());
+
+### formatting
+
+    var line = new Line {Command = "USER", Params = new List<string> {"user", "0", "*", "real name"}};
+    Console.WriteLine(line);
+    Console.WriteLine(line.Format());
+
+### stateful
+
+see the full example in [Sample/Client.cs](Sample/Client.cs)
+
+    public class Client
+    {
+        private readonly Socket _socket;
+        private readonly StatefulDecoder _decoder;
+        private readonly StatefulEncoder _encoder;
+        private readonly byte[] _bytes;
+
+        public Client()
+        {
+            _decoder = new StatefulDecoder();
+            _encoder = new StatefulEncoder();
+            _socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.IP);
+            _bytes = new byte[1024];
+        }
+
+        public void Start()
+        {
+            _socket.Connect("127.0.0.1", 6667);
+
+            Send(new Line {Command = "USER", Params = new List<string> {"username", "0", "*", "real name"}});
+            Send(new Line {Command = "NICK", Params = new List<string> {"statefulbot"}});
+
+            while (true)
+            {
+                var bytesReceived = _socket.Receive(_bytes);
+                var lines = _decoder.Push(_bytes);
+
+                if (lines.Count == 0)
+                {
+                    Console.WriteLine("! disconnected");
+                    _socket.Shutdown(SocketShutdown.Both);
+                    break;
+                }
+
+                foreach (var line in lines)
+                {
+                    Console.WriteLine($"< {line.Format()}");
+
+                    switch (line.Command)
+                    {
+                        case "PING":
+                            Send(new Line {Command = "PONG", Params = line.Params});
+                            break;
+                        case "001":
+                            Send(new Line {Command = "JOIN", Params = new List<string> {"#channel"}});
+                            break;
+                    }
+                }
+            }
+        }
+
+        private void Send(Line line)
+        {
+            Console.WriteLine($"> {line.Format()}");
+            _encoder.Push(line);
+            while (_encoder.PendingBytes.Length > 0)
+                _encoder.Pop(_socket.Send(_encoder.PendingBytes));
+        }
+    }
+
+## contact
+
+come say hi on [\#irctokens on irc.tilde.chat](https://web.tilde.chat/?join=irctokens)
+