Cleanup

README.md

@@ -1,5 +1,7 @@
 # Shortcodes
 
+## What it is
+
 This is a parser for the shortcode spec as explained in the Hugo docs
 and used in Hugo and Nikola. Approximately.
 
@@ -9,14 +11,50 @@ It probably won't be 100% identical, but I'll try to make it
 as close as practical.
 
 * Implemented in Ragel + C for performance
-* Allocates no memory, because all strings are references to 
+* Allocates no memory, because all strings are references to
   pieces of input.
 
-What works:
+## What works
 
 * Detect shortcodes with names
 * Standalone and matched shortcodes
 * Capture data between tags in matched shortcodes
 * Capture arguments with and without names
-* Capture values with and without quotes (with details, see TODO above)
+* Capture values with and without quotes (with details, see [TODO](TODO.md))
 
+## Building
+
+You need [Ragel](http://www.colm.net/open-source/ragel/) and a C compiler.
+
+Ragel is used to generate `shortcodes.c` out of `shortcodes.rl`.
+As a convenience there is a generated `shortcodes.c` in the repo,
+
+Then:
+
+```shell
+  cd src && make
+```
+
+To run tests:
+
+```shell
+  crystal spec
+```
+
+## Installation
+
+1. Add the dependency to your `shard.yml`:
+
+   ```yaml
+   dependencies:
+     cr-discount:
+       github: ralsina/shortcodes
+   ```
+
+2. Run `shards install`
+
+## Usage
+
+```crystal
+require "shortcodes"
+```

spec/shortcodes_spec.cr

@@ -4,9 +4,9 @@ describe "Shortcodes" do
   # TODO: Write tests
 
   it "works" do
-    result = Shortcodes.parse("foo{{% bar %}}baz{{% /bar %}}qux");
-    p! result.sccount;
-    p! result.shortcodes[0].matching;
+    result = Shortcodes.parse("foo{{% bar %}}baz{{% /bar %}}qux")
+    result.sccount.should eq 1
+    result.shortcodes[0].matching.should eq 1
   end
 end
 
@@ -237,4 +237,4 @@ end
 # //     result = parse(input);
 # //     // No shortcodes
 # //     assert_that(result.sc[0].name.len, is_equal_to(0));
-# // }
+# // }

src/Makefile

@@ -1,4 +1,3 @@
-CC=gcc
 shortcodes.c: shortcodes.rl
 	ragel -G2 shortcodes.rl -o shortcodes.c
 clean:

src/shortcodes.cr

@@ -1,13 +1,12 @@
 @[Link(ldflags: "#{__DIR__}/shortcodes.o")]
 lib Shortcodes
-
   struct Chunk
     start : UInt32
     len : UInt32
   end
 
   struct ScError
-    position: UInt32
+    position : UInt32
     code : UInt32
   end
 
@@ -28,5 +27,5 @@ lib Shortcodes
     errcount : UInt32
   end
 
-  fun parse(input : Pointer(LibC::Char)) : ScResult;
-end
+  fun parse(input : Pointer(LibC::Char)) : ScResult
+end