devver-germinate 1.1.0 → 1.2.0

data/examples/basic.rb

@@ -1,3 +1,4 @@
+# :PUBLISHER: source, gist
 # A basic example of a Germinate article.
 #
 # This text is "front matter" and will not be included in the final article.
@@ -48,41 +49,41 @@ hello
 # If it doesn't find a %f, Germinate will pipe the source sample into the
 # command on its STDIN.
 #
-# Here's the result of \:INSERT: @hello|fred
+# Here's the result of :INSERT: @hello|fred
 # :INSERT: @hello|fred
 #
 # Here's the result of :INSERT: @hello|jane
 # :INSERT: @hello|jane
 #
 # We can even chain processes together. Here's the result of 
-# \:INSERT: @hello|jane|quote
+# :INSERT: @hello|jane|quote
 # :INSERT: @hello|jane|quote
 #
 # It's not necessary to quote whole code samples.  We can select specific lines
 # to excerpt using more advanced selectors.
 #
 # Select a single line
-# \:INSERT: @foo:2
+# :INSERT: @foo:2
 # :INSERT: @foo:2
 #
 # Select an inclusive range
-# \:INSERT: @foo:2..4
+# :INSERT: @foo:2..4
 # :INSERT: @foo:2..4
 #
 # Select an exclusive range
-# \:INSERT: @foo:1...3
+# :INSERT: @foo:1...3
 # :INSERT: @foo:1...3
 #
 # Select by starting line and length
-# \:INSERT: @foo:4,4
+# :INSERT: @foo:4,4
 # :INSERT: @foo:4,4
 #
 # Select by starting and ending regular expressions
-# \:INSERT: @foo:/do_stuff/../end/
+# :INSERT: @foo:/do_stuff/../end/
 # :INSERT: @foo:/do_stuff/../end/
 #
 # Select by regex and length
-# \:INSERT: @foo:/attr_reader/,3
+# :INSERT: @foo:/attr_reader/,3
 # :INSERT: @foo:/attr_reader/,3
 #
 # :SAMPLE: foo
@@ -99,7 +100,7 @@ end
 
 # :TEXT:
 # Finally, we can include all of the code samples in a single chunk with
-# \:INSERT: $CODE
+# :INSERT: $CODE
 # :INSERT: $CODE
 #
 # There are some other special section names, such as $SOURCE and $TEXT.  See
@@ -116,3 +117,7 @@ end
 #   germ select -s <selector>
 #
 # Enjoy!
+#
+# 1 2 3 5 6 7 8
+
+# :SET: 'GIST_ID', '150391'

data/examples/short.rb

@@ -1,4 +1,5 @@
 # #!/usr/bin/env ruby
+# :PUBLISHER: source, gist
 # :BRACKET_CODE: <pre>, </pre>
 # :PROCESS: ruby, "ruby %f"
 
@@ -15,3 +16,4 @@ hello("World")
 
 # And here's the output:
 # :INSERT: @hello|ruby
+# :SET: 'GIST_ID', '150868'

data/features/author-formats-article.feature

@@ -10,7 +10,7 @@ Feature: author formats article
       # :TEXT:
       # This is my article
     
-      this is my code 
+      this is my code
       """
     When I run the format command on the article
     Then the output should be as follows:
@@ -27,7 +27,7 @@ Feature: author formats article
       # :TEXT:
       # This is my article
     
-      this is my code 
+      this is my code
       """
     When I run the format command on the article
     Then the output should be as follows:
@@ -47,7 +47,7 @@ Feature: author formats article
       # This is my article
     
       # :SAMPLE: SECTION1, { brackets: [ '[code]', '[/code]' ] }
-      this is my code 
+      this is my code
       """
     When I run the format command on the article
     Then the output should be as follows:

data/features/{author-lists-info.feature → author-lists-info.pending_feature}

@@ -1,3 +1,5 @@
+Note: this is a debug feature and its not worth specifying until it gets a bit
+more stable.
 Feature: author lists information
 
   As an author
@@ -41,5 +43,6 @@ Feature: author lists information
     Then the output should be as follows:
       """
       frob
+      _transform
       munge
       """

data/features/author-publishes-article.feature

@@ -3,3 +3,55 @@ Feature: author publishes article
   As an author
   I want to publish my article as a blog post
   So that the world can see it
+
+  Scenario: using a shell publisher
+    Given an article with the contents:
+    """
+    # :PUBLISHER: source, shell, { command: "quoter %f", select: '$SOURCE' }
+    # :BRACKET_CODE: "<pre>", "</pre>"
+    # :TEXT:
+    # This is the text
+    # :SAMPLE:
+    def hello
+      # ...
+    end
+    """
+    When I run the command "germ publish source --debug " on the article
+    Then the output should be as follows:
+    """
+    > # :PUBLISHER: source, shell, { command: "quoter %f", select: '$SOURCE' }
+    > # :BRACKET_CODE: "<pre>", "</pre>"
+    > # :TEXT:
+    > # This is the text
+    > # :SAMPLE:
+    > def hello
+    >   # ...
+    > end
+    """
+
+  Scenario: using a shell publisher with a pipeline
+    Given an article with the contents:
+    """
+    # :PROCESS: quote, "quoter %f"
+    # :PUBLISHER: source, shell, { command: "quoter %f", pipeline: quote, select: '$SOURCE' }
+    # :BRACKET_CODE: "<pre>", "</pre>"
+    # :TEXT:
+    # This is the text
+    # :SAMPLE:
+    def hello
+      # ...
+    end
+    """
+    When I run the command "germ publish source --debug " on the article
+    Then the output should be as follows:
+    """
+    > > # :PROCESS: quote, "quoter %f"
+    > > # :PUBLISHER: source, shell, { command: "quoter %f", pipeline: quote, select: '$SOURCE' }
+    > > # :BRACKET_CODE: "<pre>", "</pre>"
+    > > # :TEXT:
+    > > # This is the text
+    > > # :SAMPLE:
+    > > def hello
+    > >   # ...
+    > > end
+    """

data/features/author-selects-hunks.feature

@@ -18,7 +18,7 @@ Feature: author experiments with selectors
 
       # :PROCESS: quote, "quoter %f"
       """
-    When I run the command "germ select --selector='@X:2..3|quote'" on the article
+    When I run the command "germ select '@X:2..3|quote'" on the article
     Then the output should be as follows:
       """
       > X 2

data/features/author-sets-variables.feature

@@ -0,0 +1,88 @@
+Feature: author sets variables
+
+  As an author
+  I want to set named values in my article
+  So that I can re-use them in processes, etc.
+
+  Scenario: setting a new variable
+    Given an article with the contents:
+    """
+    # :TEXT:
+    # This is some text
+    # :SET: FOO, 123
+    """
+    When I run the command "germ list variables --debug" on the article
+    Then the output should be as follows:
+    """
+    FOO                  123
+    """
+    When I run the command "germ set MAGIC_WORD xyzzy --debug" on the article
+    Then the article contents should be:
+    """
+    # :TEXT:
+    # This is some text
+    # :SET: FOO, 123
+    # :SET: 'MAGIC_WORD', 'xyzzy'
+
+    """
+    And the article backup contents should be:
+    """
+    # :TEXT:
+    # This is some text
+    # :SET: FOO, 123
+    """
+    When I run the command "germ list variables --debug" on the article
+    Then the output should be as follows:
+    """
+    FOO                  123
+    MAGIC_WORD           xyzzy
+    """
+
+  Scenario: changing an existing variable
+    Given an article with the contents:
+    """
+    # :PUBLISHER: env, shell, { command: 'echo %f > /dev/null; echo $FOO' }
+    # :TEXT:
+    # This is some text
+    # :SET: FOO, 123
+    # This is more text
+    """
+    When I run the command "germ list variables --debug" on the article
+    Then the output should be as follows:
+    """
+    FOO                  123
+    """
+    When I run the command "germ publish env --debug" on the article
+    Then the output should be as follows:
+    """
+    123
+    """
+    When I run the command "germ set FOO 456 --debug" on the article
+    Then the article contents should be:
+    """
+    # :PUBLISHER: env, shell, { command: 'echo %f > /dev/null; echo $FOO' }
+    # :TEXT:
+    # This is some text
+    # :SET: 'FOO', '456'
+    # This is more text
+
+    """
+    And the article backup contents should be:
+    """
+    # :PUBLISHER: env, shell, { command: 'echo %f > /dev/null; echo $FOO' }
+    # :TEXT:
+    # This is some text
+    # :SET: FOO, 123
+    # This is more text
+
+    """
+    When I run the command "germ list variables --debug" on the article
+    Then the output should be as follows:
+    """
+    FOO                  456
+    """
+    When I run the command "germ publish env --debug" on the article
+    Then the output should be as follows:
+    """
+    456
+    """

data/features/{author-views-stuff.feature → author-views-stuff.pending_feature}

@@ -1,3 +1,5 @@
+Note: this is a debug feature and its not worth specifying until it gets a bit
+more stable.
 Feature: author views information
 
   As an author
@@ -28,6 +30,8 @@ Feature: author views information
     Then the output should be as follows:
       """
       # Anonymous section 1
+      
+      Insertion[@SECTION1]
       """
     When I run the command "germ show --section=A" on the article
     Then the output should be as follows:

data/features/example_articles/escaping.txt

@@ -8,5 +8,6 @@
 # You get the idea.
 
 # It works in code too:
+
 # :SAMPLE:
 # \:PROCESS: foo, bar

data/features/example_articles/specials.rb

@@ -10,10 +10,10 @@ b_line_2 = 2
 
 # :TEXT:
 # We can paste in all the code:
-# :INSERT: $CODE
+# :INSERT: $CODE, { disable_transforms: true }
 # 
 # Or all the text:
-# :INSERT: $TEXT
+# :INSERT: $TEXT, { disable_transforms: true }
 #
 # Or the entire source file
-# :INSERT: $SOURCE
+# :INSERT: $SOURCE, { disable_transforms: true }

data/features/example_output/specials.txt

@@ -7,12 +7,16 @@ a_line_4 = 4
 b_line_1 = 1
 b_line_2 = 2
 
+
 Or all the text:
 # We can paste in all the code:
-#
+Insertion[$CODE(<Unknown>)]
+# 
 # Or all the text:
+Insertion[$TEXT(<Unknown>)]
 #
 # Or the entire source file
+Insertion[$SOURCE(<Unknown>)]
 
 Or the entire source file
 # :SAMPLE: A
@@ -27,10 +31,10 @@ b_line_2 = 2
 
 # :TEXT:
 # We can paste in all the code:
-# :INSERT: $CODE
-#
+# :INSERT: $CODE, { disable_transforms: true }
+# 
 # Or all the text:
-# :INSERT: $TEXT
+# :INSERT: $TEXT, { disable_transforms: true }
 #
 # Or the entire source file
-# :INSERT: $SOURCE
+# :INSERT: $SOURCE, { disable_transforms: true }

data/features/step_definitions/germinate.rb

@@ -31,3 +31,12 @@ end
 Then /^the output should be as follows:$/ do |example_output|
   @output.strip.should == example_output.strip
 end
+
+Then /^the article contents should be:$/ do |contents|
+  @filename.read.strip.should == contents.strip
+end
+
+Then /^the article backup contents should be:$/ do |contents|
+  Pathname(@filename.to_s + ".germ.bak").read.should == contents
+end
+

data/germinate.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |s|
   s.name = %q{germinate}
-  s.version = "1.1.0"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Avdi Grimm"]
-  s.date = %q{2009-07-13}
+  s.date = %q{2009-07-21}
   s.default_executable = %q{germ}
   s.description = %q{Germinate is a tool for writing about code.  With Germinate, the source code IS the article.  For example, given the following source code:  # #!/usr/bin/env ruby # :BRACKET_CODE: <pre>, </pre> # :PROCESS: ruby, "ruby %f"  # :SAMPLE: hello def hello(who) puts "Hello, #{who}" end  hello("World")  # :TEXT: # Check out my amazing program!  Here's the hello method: # :INSERT: @hello:/def/../end/  # And here's the output: # :INSERT: @hello|ruby  When we run the <tt>germ format</tt> command the following output is generated:  Check out my amazing program!  Here's the hello method: <pre> def hello(who) puts "Hello, #{who}" end </pre> And here's the output: <pre> Hello, World </pre>  To get a better idea of how this works, please take a look at link:examples/basic.rb, or run:  germ generate > basic.rb  To generate an example article to play with.  Germinate is particularly useful for writing articles, such as blog posts, which contain code excerpts.  Instead of forcing you to keep a source code file and an article document in sync throughout the editing process, the Germinate motto is "The source code IS the article".  Specially marked comment sections in your code file become the article text.  Wherever you need to reference the source code in the article, use insertion directives to tell Germinate what parts of the code to excerpt.  An advanced selector syntax enables you to be very specific about which lines of code you want to insert.  If you also want to show the output of your code, Germinate has you covered. Special "process" directives enable you to define arbitrary commands which can be run on your code.  The output of the command then becomes the excerpt text. You can define an arbitrary number of processes and have different excerpts showing the same code as processed by different commands.  You can even string processes together into pipelines.  Development of Germinate is graciously sponsored by Devver, purveyor of fine cloud-based services to busy Ruby developers.  If you like this tool please check them out at http://devver.net.}
   s.email = %q{avdi@avdi.org}
   s.executables = ["germ"]
   s.extra_rdoc_files = ["History.txt", "README.rdoc", "bin/germ"]
-  s.files = [".gitignore", "History.txt", "README.rdoc", "Rakefile", "TODO", "bin/germ", "cucumber.yml", "examples/basic.rb", "examples/short.rb", "features/author-formats-article.feature", "features/author-lists-info.feature", "features/author-publishes-article-source.feature", "features/author-publishes-article.feature", "features/author-republishes-article.feature", "features/author-selects-hunks.feature", "features/author-updates-article-source.feature", "features/author-views-stuff.feature", "features/bin/quoter", "features/bin/sorter", "features/example_articles/bracketing.rb", "features/example_articles/escaping.txt", "features/example_articles/excerpt_output.rb", "features/example_articles/hello.rb", "features/example_articles/pipelines.txt", "features/example_articles/regexen.rb", "features/example_articles/sample_offsets.rb", "features/example_articles/specials.rb", "features/example_articles/stderr.rb", "features/example_articles/wrapping.rb", "features/example_output/bracketing.out", "features/example_output/code_samples.txt", "features/example_output/escaping.out", "features/example_output/excerpt_output.out", "features/example_output/hello.txt", "features/example_output/pipelines.out", "features/example_output/regexen.txt", "features/example_output/sample_offsets.txt", "features/example_output/specials.txt", "features/example_output/stderr.out", "features/example_output/wrapping.txt", "features/step_definitions/germinate.rb", "features/support/env.rb", "germinate.gemspec", "lib/germinate.rb", "lib/germinate/application.rb", "lib/germinate/article_editor.rb", "lib/germinate/article_formatter.rb", "lib/germinate/formatter.rb", "lib/germinate/hunk.rb", "lib/germinate/implicit_insertion.rb", "lib/germinate/insertion.rb", "lib/germinate/librarian.rb", "lib/germinate/pipeline.rb", "lib/germinate/process.rb", "lib/germinate/reader.rb", "lib/germinate/selector.rb", "lib/germinate/shared_style_attributes.rb", "lib/germinate/text_transforms.rb", "spec/germinate/application_spec.rb", "spec/germinate/article_editor_spec.rb", "spec/germinate/article_formatter_spec.rb", "spec/germinate/code_hunk_spec.rb", "spec/germinate/file_hunk_spec.rb", "spec/germinate/formatter_spec.rb", "spec/germinate/hunk_spec.rb", "spec/germinate/implicit_insertion_spec.rb", "spec/germinate/insertion_spec.rb", "spec/germinate/librarian_spec.rb", "spec/germinate/pipeline_spec.rb", "spec/germinate/process_spec.rb", "spec/germinate/reader_spec.rb", "spec/germinate/selector_spec.rb", "spec/germinate/text_hunk_spec.rb", "spec/germinate/text_transforms_spec.rb", "spec/germinate_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/ann.rake", "tasks/bones.rake", "tasks/cucumber.rake", "tasks/gem.rake", "tasks/git.rake", "tasks/notes.rake", "tasks/post_load.rake", "tasks/rdoc.rake", "tasks/rubyforge.rake", "tasks/setup.rb", "tasks/spec.rake", "tasks/svn.rake", "tasks/test.rake", "tasks/zentest.rake", "test/test_germinate.rb"]
+  s.files = [".gitignore", "History.txt", "README.rdoc", "Rakefile", "TODO", "bin/germ", "cucumber.yml", "examples/basic.rb", "examples/short.rb", "features/author-formats-article.feature", "features/author-lists-info.pending_feature", "features/author-publishes-article-source.feature", "features/author-publishes-article.feature", "features/author-republishes-article.feature", "features/author-selects-hunks.feature", "features/author-sets-variables.feature", "features/author-updates-article-source.feature", "features/author-views-stuff.pending_feature", "features/bin/quoter", "features/bin/sorter", "features/example_articles/bracketing.rb", "features/example_articles/escaping.txt", "features/example_articles/excerpt_output.rb", "features/example_articles/hello.rb", "features/example_articles/pipelines.txt", "features/example_articles/regexen.rb", "features/example_articles/sample_offsets.rb", "features/example_articles/specials.rb", "features/example_articles/stderr.rb", "features/example_articles/wrapping.rb", "features/example_output/bracketing.out", "features/example_output/code_samples.txt", "features/example_output/escaping.out", "features/example_output/excerpt_output.out", "features/example_output/hello.txt", "features/example_output/pipelines.out", "features/example_output/regexen.txt", "features/example_output/sample_offsets.txt", "features/example_output/specials.txt", "features/example_output/stderr.out", "features/example_output/wrapping.txt", "features/step_definitions/germinate.rb", "features/support/env.rb", "germinate.gemspec", "lib/germinate.rb", "lib/germinate/application.rb", "lib/germinate/article_editor.rb", "lib/germinate/formatter.rb", "lib/germinate/hunk.rb", "lib/germinate/implicit_insertion.rb", "lib/germinate/insertion.rb", "lib/germinate/librarian.rb", "lib/germinate/origin.rb", "lib/germinate/pipeline.rb", "lib/germinate/publisher.rb", "lib/germinate/reader.rb", "lib/germinate/selector.rb", "lib/germinate/shared_style_attributes.rb", "lib/germinate/shell_process.rb", "lib/germinate/shell_publisher.rb", "lib/germinate/simple_publisher.rb", "lib/germinate/source_file.rb", "lib/germinate/text_transforms.rb", "lib/germinate/transform_process.rb", "lib/germinate/variable.rb", "sample.rb", "spec/germinate/application_spec.rb", "spec/germinate/article_editor_spec.rb", "spec/germinate/code_hunk_spec.rb", "spec/germinate/file_hunk_spec.rb", "spec/germinate/formatter_spec.rb", "spec/germinate/hunk_spec.rb", "spec/germinate/implicit_insertion_spec.rb", "spec/germinate/insertion_spec.rb", "spec/germinate/librarian_spec.rb", "spec/germinate/pipeline_spec.rb", "spec/germinate/process_spec.rb", "spec/germinate/publisher_spec.rb", "spec/germinate/reader_spec.rb", "spec/germinate/selector_spec.rb", "spec/germinate/shell_publisher_spec.rb", "spec/germinate/source_file_spec.rb", "spec/germinate/text_hunk_spec.rb", "spec/germinate/text_transforms_spec.rb", "spec/germinate/transform_process_spec.rb", "spec/germinate/variable_spec.rb", "spec/germinate_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/ann.rake", "tasks/bones.rake", "tasks/cucumber.rake", "tasks/gem.rake", "tasks/git.rake", "tasks/notes.rake", "tasks/post_load.rake", "tasks/rdoc.rake", "tasks/rubyforge.rake", "tasks/setup.rb", "tasks/spec.rake", "tasks/svn.rake", "tasks/test.rake", "tasks/zentest.rake", "test/test_germinate.rb"]
   s.has_rdoc = true
   s.homepage = %q{http://github.com/devver/germinate/}
   s.rdoc_options = ["--main", "README.rdoc"]

data/lib/germinate.rb

@@ -5,7 +5,7 @@ require 'logger'
 module Germinate
 
   # :stopdoc:
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
   LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
   PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
   # :startdoc:

data/lib/germinate/application.rb

@@ -1,54 +1,97 @@
+require 'English'
+
 # The Application ties all the other componts together.  It has public methods
 # roughly corresponding commands that the 'germ' command-line tool supports.
 class Germinate::Application
   attr_writer :formatter
 
-  def format(source, path, output=$stdout, errors=$stderr)
-    librarian = load_librarian(source, path)
-    editor    = Germinate::ArticleEditor.new(librarian)
-    formatter = Germinate::ArticleFormatter.new(output)
+  def initialize(output, errors)
+    @output       = output
+    @error_output = errors
+    @log          = Germinate.logger
+    @plugins      = []
+  end
 
-    Germinate::SharedStyleAttributes.fattrs.each do 
-      |style_attribute|
-      formatter.send(style_attribute, librarian.send(style_attribute))
+  # Search Rubygems for Germinate plugins and load them
+  def load_plugins!
+    $LOAD_PATH.each do |dir|
+      plugin_init = Pathname(dir) + 'germinate_plugin_v0_init.rb'
+      if plugin_init.readable?
+        load_plugin!(plugin_init.to_s)
+      end
     end
-    formatter.start!
-    editor.each_hunk do |hunk|
-      formatter.format!(hunk)
+    Gem.find_files('germinate_plugin_v0_init').each do |file|
+      load_plugin!(file)
     end
-    formatter.finish!
   end
 
-  def list(source, path, things_to_list, output=$stdout)
+  def format(source, path)
     librarian = load_librarian(source, path)
-    if things_to_list.include?(:sections)
-      output.puts(librarian.section_names.join("\n"))
-    end
-    if things_to_list.include?(:samples)
-      output.puts(librarian.sample_names.join("\n"))
-    end
-    if things_to_list.include?(:processes)
-      output.puts(librarian.process_names.join("\n"))
-    end
+    publisher = Germinate::SimplePublisher.new("simple", librarian)
+    publisher.publish!(@output)
   end
 
-  def show(source, path, selection, output=$stdout)
+  def list(source, path, collection)
     librarian = load_librarian(source, path)
-    selection.fetch(:section, []).each do |section|
-      output.puts(*librarian.section(section))
-    end
-    selection.fetch(:sample, []).each do |sample|
-      output.puts(*librarian.sample(sample))
+    case collection
+    when "sections"
+      @output.puts(librarian.section_names.join("\n"))
+    when "samples"
+      @output.puts(librarian.sample_names.join("\n"))
+    when "processes"
+      @output.puts(librarian.process_names.join("\n"))
+    when "publishers"
+      @output.puts(*librarian.publisher_names)
+    when "all_publishers"
+      Germinate::Publisher.registered_publishers.keys do |p|
+        @output.puts(p)
+      end
+    when "variables"
+      librarian.variables.each_pair do |name, value|
+        @output.puts("%-20s %s" % [name, value.to_s])
+      end
+    when "plugins"
+      @plugins.each do |plugin|
+        puts(plugin)
+      end
+    else
+      raise "I don't know how to list '#{collection}'"
     end
-    selection.fetch(:process, []).each do |process|
-      output.puts(*librarian.process(process).command)
+  end
+
+  def show(source, path, item_type, item)
+    librarian = load_librarian(source, path)
+    case item_type
+    when "section"
+      @output.puts(librarian.section(item))
+    when "sample"
+      @output.puts(librarian.sample(item))
+    when "process"
+      @output.puts(librarian.process(item).command)
+    when "publisher"
+      @output.puts(librarian.publisher(item))
+    else
+      raise "I don't know how to show '#{item_type}'"
     end
   end
 
-  def select(source, path, selector, output=$stdout)
+  def select(source, path, selector, options, origin="command line")
     librarian = load_librarian(source, path)
-    output.puts(*librarian[selector])
+    @output.puts(*librarian[selector, origin, options])
   end
+
+  def publish(source, path, publisher, options={})
+    librarian = load_librarian(source, path)
+    librarian.publisher(publisher).publish!(@output, options)
+    librarian.store_changes!
+  end
+
+  def set(source, path, name, value)
+    librarian = load_librarian(source, path)
+    librarian.variables[name] = value
+    librarian.store_changes!
+  end
+
   private
 
   def load_librarian(source, path)
@@ -59,4 +102,12 @@ class Germinate::Application
     end
     librarian
   end
+
+  def load_plugin!(file)
+    unless @plugins.include?(file)
+      @log.debug "Loading plugin: #{file}"
+      Kernel.load(file)
+      @plugins << File.dirname(file)
+    end
+  end
 end