devver-germinate 1.0.0

data/features/author-formats-article.feature

@@ -0,0 +1,108 @@
+Feature: author formats article
+
+  As an author
+  I want to format my articles
+  So that they can be published
+
+  Scenario: format text followed by code
+    Given an article with the contents:
+      """
+      # :TEXT:
+      # This is my article
+    
+      this is my code 
+      """
+    When I run the format command on the article
+    Then the output should be as follows:
+      """
+      This is my article
+  
+      this is my code
+      """
+
+  Scenario: format code with bracketing
+    Given an article with the contents:
+      """
+      # :BRACKET_CODE: "<pre>", "</pre>"
+      # :TEXT:
+      # This is my article
+    
+      this is my code 
+      """
+    When I run the format command on the article
+    Then the output should be as follows:
+      """
+      This is my article
+  
+      <pre>
+      this is my code
+      </pre>
+      """
+
+  Scenario: override default bracketing
+    Given an article with the contents:
+      """
+      # :BRACKET_CODE: "<pre>", "</pre>"
+      # :TEXT: SECTION1
+      # This is my article
+    
+      # :SAMPLE: SECTION1, { brackets: [ '[code]', '[/code]' ] }
+      this is my code 
+      """
+    When I run the format command on the article
+    Then the output should be as follows:
+      """
+      This is my article
+  
+      [code]
+      this is my code
+      [/code]
+      """
+
+  Scenario: insert a named section
+    Given an article with the contents:
+      """
+      # :BRACKET_CODE: "<pre>", "</pre>"
+    
+      # :SAMPLE: sample1
+      code sample 1
+
+      # :SAMPLE: sample2
+      code sample 2
+
+      # :TEXT:
+      # Here is example 2:
+      # :INSERT: @sample2
+      #
+      # And here is example 1:
+      # :INSERT: @sample1
+      """
+    When I run the format command on the article
+    Then the output should be as follows:
+      """
+      Here is example 2:
+      <pre>
+      code sample 2
+      </pre>
+
+      And here is example 1:
+      <pre>
+      code sample 1
+      </pre>
+      """
+
+  Scenario Outline: more formatting examples
+    Given the article "<input_file>"
+    When I run the format command on the article
+    Then the output should look like "<output_file>"
+
+  Scenarios:
+    | input_file        | output_file        |
+    | hello.rb          | hello.txt          |
+    | wrapping.rb       | wrapping.txt       |
+    | sample_offsets.rb | sample_offsets.txt |
+    | specials.rb       | specials.txt       |
+    | regexen.rb        | regexen.txt        |
+    | pipelines.txt     | pipelines.out      |
+    | escaping.txt      | escaping.out       |
+

data/features/author-lists-info.feature

@@ -0,0 +1,45 @@
+Feature: author lists information
+
+  As an author
+  I want to list the various components of my article
+  So that I can diagnose errors in output
+
+  Scenario: list stuff
+    Given an article with the contents:
+      """
+      # :TEXT:
+      # Anonymous section 1
+    
+      anonymous code 1
+      # :END:
+
+      anonymous code 2
+
+      # :TEXT: A
+      # Section A
+
+      # :SAMPLE: X
+      code sample X
+
+      # :PROCESS: frob, "aaa"
+      # :PROCESS: munge, "bbb"
+      """
+    When I run the command "germ list --sections" on the article
+    Then the output should be as follows:
+      """
+      SECTION1
+      A
+      """
+    When I run the command "germ list --samples" on the article
+    Then the output should be as follows:
+      """
+      SECTION1
+      SECTION2
+      X
+      """
+    When I run the command "germ list --processes" on the article
+    Then the output should be as follows:
+      """
+      frob
+      munge
+      """

data/features/author-publishes-article-source.feature

@@ -0,0 +1,5 @@
+Feature: author publishes article source
+
+  As an author
+  I want to publish my article source code to Gist
+  So that I can share it with other programmers

data/features/author-publishes-article.feature

@@ -0,0 +1,5 @@
+Feature: author publishes article
+
+  As an author
+  I want to publish my article as a blog post
+  So that the world can see it

data/features/author-republishes-article.feature

@@ -0,0 +1,5 @@
+Feature: author re-publishes article
+
+  As an author
+  I want to re-publish my article after updating it
+  So that the world can see the latest version

data/features/author-selects-hunks.feature

@@ -0,0 +1,26 @@
+Feature: author experiments with selectors
+
+  As an author
+  I want to test the behavior of various selectors
+  So that I know what to use in my article
+
+  Scenario: list stuff
+    Given an article with the contents:
+      """
+      # :TEXT: A
+      # Section A
+
+      # :SAMPLE: X
+      X 1
+      X 2
+      X 3
+      X 4
+
+      # :PROCESS: quote, "quoter %f"
+      """
+    When I run the command "germ select --selector='@X:2..3|quote'" on the article
+    Then the output should be as follows:
+      """
+      > X 2
+      > X 3
+      """

data/features/author-updates-article-source.feature

@@ -0,0 +1,5 @@
+Feature: author updates article source
+
+  As an author
+  I want to push changes to article source code
+  So that other programmers will see the latest version

data/features/author-views-stuff.feature

@@ -0,0 +1,48 @@
+Feature: author views information
+
+  As an author
+  I want to view the components of my article
+  So that I can diagnose errors in output
+
+  Scenario: list stuff
+    Given an article with the contents:
+      """
+      # :TEXT:
+      # Anonymous section 1
+    
+      anonymous code 1
+      # :END:
+
+      anonymous code 2
+
+      # :TEXT: A
+      # Section A
+
+      # :SAMPLE: X
+      code sample X
+
+      # :PROCESS: frob, "aaa"
+      # :PROCESS: munge, "bbb"
+      """
+    When I run the command "germ show --section=SECTION1" on the article
+    Then the output should be as follows:
+      """
+      # Anonymous section 1
+      """
+    When I run the command "germ show --section=A" on the article
+    Then the output should be as follows:
+      """
+      # Section A
+
+      """
+    When I run the command "germ show --sample=X" on the article
+    Then the output should be as follows:
+      """
+      code sample X
+
+      """
+    When I run the command "germ show --process=munge" on the article
+    Then the output should be as follows:
+      """
+      bbb
+      """

data/features/bin/quoter

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+File.open(ARGV[0]) do |file|
+  file.each_line do |line|
+    puts "> #{line.chomp}"
+  end
+end

data/features/bin/sorter

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+$stdin.readlines.sort.each do |line|
+  puts line
+end

data/features/example_articles/code_samples.rb

@@ -0,0 +1,89 @@
+# This example demonstrates the use of code samples.
+
+# :TEXT:
+# Hi there!  Here's a Hello, World method:
+
+def hello
+  puts "Hello, World!"
+end
+
+# :CUT:
+# Here's some boring support code we don't want to show the world.
+
+def boring
+  1 + 1
+end
+
+# Here are two a named samples:
+# :SAMPLE: fred
+
+def fred
+  # This comment is part of the sample
+  puts "Hello, my name is Fred"
+  puts "la la la"
+end
+
+# :SAMPLE: sally
+
+def sally
+  puts "Hello, my name is Sally"
+end
+
+# :END:
+# Sample "sally" ends above, and does not include the following.
+
+def wizard
+  puts "Pay no attention to the man behind the curtain!"
+end
+
+# Samples can be inside comment blocks
+# :SAMPLE: george
+#    (defun george () (format "Hello from George"))
+# :CUT:
+
+# Samples can have comment markers stripped
+# :SAMPLE: mary, { uncomment: true }
+#    (defun mary () (format "Hello from Mary"))
+# :CUT:
+
+# :TEXT:
+# The immediately following code sample can be implicitly referenced:
+# :INSERT:
+# :CUT:
+def nameless
+  puts "I have no name"
+end
+
+# :TEXT:
+# Or explicitly referenced
+# :INSERT: FOLLOWING
+# :CUT:
+def foo
+  puts "foo"
+end
+
+# :TEXT:
+# Samples can be referenced by name
+# :INSERT: fred
+# 
+# Or by index:
+# :INSERT: #2
+#
+# SOURCE is a special sample which contains the entire source file.
+# :INSERT: SOURCE, { indent: 4 }
+#
+# CODE is a special sample which contains all the non-text portions of this
+# file.
+# :INSERT: CODE, { indent: " > " }
+#
+# We can select specific lines:
+# :INSERT: sally:2
+#
+# Or ranges of lines:
+# :INSERT: sally:2..3
+# 
+# Or lines matching a regex:
+# :INSERT: sally:/def/
+#
+# Or ranges of regexen:
+# :INSERT: fred:/puts/.../end/

data/features/example_articles/escaping.txt

@@ -0,0 +1,12 @@
+# What if you want to write about Germinate in Germinate?  Escaping is the key.
+
+# :TEXT:
+# Here are some Germinate directives
+# \:TEXT:
+# \:SAMPLE:
+# \:INSERT:
+# You get the idea.
+
+# It works in code too:
+# :SAMPLE:
+# \:PROCESS: foo, bar

data/features/example_articles/hello.rb

@@ -0,0 +1,9 @@
+# A hello, world demo for Germinate
+# This section should not appear in the output
+
+# :TEXT:
+# Hello, world!
+# :CUT:
+
+def ignore_me
+end

data/features/example_articles/pipelines.txt

@@ -0,0 +1,25 @@
+# A %f will be replaced with a path to a temporary file
+# :PROCESS: quote, "quoter %f"
+#
+# If there is no %f the content will be piped into the command on STDIN
+# :PROCESS: sort,  "sorter"
+
+# :SAMPLE: names
+joe
+sally
+aaron
+george
+zack
+susan
+# :TEXT:
+# Sorting the sample:
+# :INSERT: @names|sort
+#
+# Quoting the sample:
+# :INSERT: @names|quote
+#
+# We can combine pipelines with excerpting:
+# :INSERT: @names:2..4|quote
+#
+# And we can chain processes to form a true pipeline:
+# :INSERT: @names|sort|quote

data/features/example_articles/regexen.rb

@@ -0,0 +1,24 @@
+# :SAMPLE: A
+
+def foo
+  # ...
+end
+
+def bar
+  # ...
+end
+
+class Frob
+  # ...
+end
+
+# :TEXT:
+# We can select code by regexp
+# :INSERT: @A:/foo/../end/
+#
+# Or with a regex and a length
+# :INSERT: @A:/bar/,7
+#
+# Ending offset can be exclusive
+# :INSERT: @A:/foo/.../Frob/
+

data/features/example_articles/sample_offsets.rb

@@ -0,0 +1,18 @@
+# :SAMPLE: A
+a_line_1 = 1
+a_line_2 = 2
+a_line_3 = 3
+a_line_4 = 4
+
+# :TEXT:
+# We can specify a starting offset:
+# :INSERT: @A:2
+# 
+# And an ending offset
+# :INSERT: @A:2..3
+#
+# Ending offset can be exclusive
+# :INSERT: @A:1...3
+#
+# We can specify offset and count instead
+# :INSERT: @A:2,3