rethoth 0.4.1

data/lib/thoth/helper/cookie.rb

@@ -0,0 +1,45 @@
+#--
+# Copyright (c) 2009 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+module Thoth; module Helper
+
+  # The Cookie helper wraps access to Ramaze's request.cookies hash and returns
+  # only the first cookie matching a specified name (rather than an array).
+  module Cookie
+    private
+
+    # Gets the first cookie matching the specified _name_. If not found, the
+    # provided _default_ value will be returned.
+    def cookie(name, default = nil)
+      return default unless cookie = request.cookies[name.to_s]
+      return cookie.first if cookie.is_a?(Array)
+      cookie
+    end
+  end
+
+end; end

data/lib/thoth/helper/error.rb

@@ -0,0 +1,122 @@
+#--
+# Copyright (c) 2009 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+module Thoth; module Helper
+
+  # The Error helper module provides methods for interrupting the current
+  # request and responding with an error message and corresponding HTTP error
+  # code.
+  module Error
+    Ramaze::Helper::LOOKUP << self
+
+    # Displays a "400 Bad Request" error message and returns a 400 response
+    # code.
+    def error_400(message = nil)
+      if message
+        error_layout 400, '400 Bad Request', %[
+          <p>
+            Your browser sent a request that this server could not understand.
+          </p>
+
+          <p>
+            #{message}
+          </p>
+        ]
+      else
+        error_layout 400, '400 Bad Request', %[
+          <p>
+            Your browser sent a request that this server could not understand.
+          </p>
+        ]
+      end
+    end
+
+    # Displays a "403 Forbidden" error message and returns a 403 response code.
+    def error_403
+      error_layout 403, '403 Forbidden', %[
+        <p>
+          You don't have permission to access
+          <code>#{h(request.REQUEST_URI)}</code> on this server.
+        </p>
+      ]
+    end
+
+    # Displays a "404 Not Found" error message and returns a 404 response code.
+    def error_404
+      error_layout 404, '404 Not Found', %[
+        <p>
+          The requested URL <code>#{h(request.REQUEST_URI)}</code> was not
+          found on this server.
+        </p>
+      ]
+    end
+
+    # Displays a "405 Method Not Allowed" error message and returns a 405
+    # response code.
+    def error_405
+      error_layout 405, '405 Method Not Allowed', %[
+        <p>
+          The #{request.env['REQUEST_METHOD']} method is not allowed for the
+          requested URL.
+        </p>
+      ]
+    end
+
+    # Displays a "500 Internal Server Error" error message and returns a 500
+    # response code.
+    def error_500
+      if e = request.env[Rack::RouteExceptions::EXCEPTION]
+        Ramaze::Log.error e
+      end
+
+      error_layout 500, '500 Internal Server Error', %[
+        <p>
+          The server encountered an internal error and was unable to complete
+          your request.
+        </p>
+      ]
+    end
+
+    private
+
+    def error_layout(status, title, content = '')
+      respond! %[
+        <html>
+          <head>
+            <title>#{h(title)}</title>
+          </head>
+          <body>
+            <h1>#{h(title)}</h1>
+            #{content}
+          </body>
+        </html>
+      ].unindent, status
+    end
+  end
+
+end; end

data/lib/thoth/helper/pagination.rb

@@ -0,0 +1,131 @@
+#--
+# Copyright (c) 2009 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+module Thoth
+
+  # The Pager class provides a simple wrapper around a paginated Sequel dataset.
+  class Pager
+
+    # Initializes a new Pager instance wrapping the given Sequel _dataset_ and
+    # using _url_ as the template for all generated URLs. _url_ should be a
+    # string containing an sprintf flag (such as <tt>%s</tt>) in place of the
+    # page number.
+    def initialize(dataset, url)
+      @dataset = dataset
+      @url     = url
+    end
+
+    # Returns the number of the current page.
+    def current_page
+      @dataset.current_page
+    end
+
+    # Returns the number of records in the current page.
+    def current_page_record_count
+      @dataset.current_page_record_count
+    end
+
+    # Returns the record range for the current page.
+    def current_page_record_range
+      @dataset.current_page_record_range
+    end
+
+    # Iterates over all pages within 5 steps from the current page, yielding the
+    # page number and URL for each.
+    def navigate # :yields: page, url
+      nav_start = [current_page - 5, 1].max
+      nav_end   = [nav_start + 9, page_count].min
+      (nav_start..nav_end).each {|page| yield page, url(page) }
+    end
+
+    # Returns +true+ if the total number of pages is greater than 1.
+    def navigation?
+      page_count > 1
+    end
+
+    # Returns the number of the next page or +nil+ if the current page is the
+    # last.
+    def next_page
+      @dataset.next_page
+    end
+
+    # Returns the URL for the next page or +nil+ if the current page is the
+    # last.
+    def next_url
+      next_page ? url(next_page) : nil
+    end
+
+    # Returns the total number of pages.
+    def page_count
+      @dataset.page_count
+    end
+
+    # Returns the page range.
+    def page_range
+      @dataset.page_range
+    end
+
+    # Returns the number of records per page.
+    def page_size
+      @dataset.page_size
+    end
+
+    # Returns the number of the previous page or +nil+ if the current page is
+    # the first.
+    def prev_page
+      @dataset.prev_page
+    end
+
+    # Returns the URL for the previous page or +nil+ if the current page is the
+    # first.
+    def prev_url
+      prev_page ? url(prev_page) : nil
+    end
+
+    # Returns the total number of records in the dataset.
+    def record_count
+      @dataset.pagination_record_count
+    end
+
+    # Returns the URL for the specified page number.
+    def url(page)
+      @url.to_s.gsub('__page__', page.to_i.to_s)
+    end
+
+  end
+end
+
+module Thoth; module Helper
+  module Pagination
+
+    def pager(dataset, url = rs(:/, '__page__'))
+      Pager.new(dataset, url)
+    end
+
+  end
+end; end

data/lib/thoth/helper/wiki.rb

@@ -0,0 +1,77 @@
+#--
+# Copyright (c) 2009 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+module Thoth; module Helper
+
+  module Wiki
+    private
+
+    # Parse wiki-style markup into HTML markup.
+    def wiki_to_html(string)
+      # [[page_name|link text]]
+      string.gsub!(/\[\[([0-9a-z_-]+)\|(.+?)\]\]/i) do
+        PageController.a($2, :/, $1.downcase)
+      end
+
+      # [[page_name]]
+      string.gsub!(/\[\[([0-9a-z_-]+)\]\]/i) do
+        PageController.a($1, :/, $1.downcase)
+      end
+
+      # [[@post_name|link text]]
+      # [[@123|link text]]
+      string.gsub!(/\[\[@(\d+|[0-9a-z_-]+)\|(.+?)\]\]/i) do
+        PostController.a($2, :/, $1.downcase)
+      end
+
+      # [[@post_name]]
+      # [[@123]]
+      string.gsub!(/\[\[@(\d+|[0-9a-z_-]+)\]\]/i) do
+        PostController.a($1, :/, $1.downcase)
+      end
+
+      # [[media:filename|link text]]
+      string.gsub!(/\[\[media:([^\]]+)\|(.+?)\]\]/i) do
+        MediaController.a($2, :/, $1)
+      end
+
+      # [[media:filename]]
+      string.gsub!(/\[\[media:([^\]]+)\]\]/i) do
+        MediaController.a($1, :/, $1)
+      end
+
+      # [[media_url:filename]]
+      string.gsub!(/\[\[media_url:([^\]]+)\]\]/i) do
+        MediaController.r(:/, $1).to_s
+      end
+
+      string
+    end
+  end
+
+end; end

data/lib/thoth/helper/ysearch.rb

@@ -0,0 +1,89 @@
+#--
+# Copyright (c) 2009 Ryan Grove <ryan@wonko.com>
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither the name of this project nor the names of its contributors may be
+#     used to endorse or promote products derived from this software without
+#     specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+# CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#++
+
+require 'cgi'
+require 'json'
+require 'open-uri'
+
+module Thoth; module Helper
+
+  # The YSearch helper provides search results using the Yahoo! Search API.
+  # Requires the json or json_pure gem.
+  module Ysearch
+    class SearchError < Thoth::Error; end
+
+    # Yahoo! Developer API key. Feel free to replace this with your own key.
+    API_ID = 'pNi6xQDV34FbvnO3QRfWKSByhmPFG.3fVS_R2KzOhMek3szHWKNBrTsdi1mob2vZgKjLoLuZ4A--'
+
+    # Yahoo! Search API URL.
+    API_URL = 'http://search.yahooapis.com/WebSearchService/V1/webSearch'
+
+    private
+
+    # Performs a web search using the Yahoo! Search API and returns the results
+    # as a Hash. For details on the available options, see
+    # http://developer.yahoo.com/search/web/V1/webSearch.html
+    def yahoo_search(query, options = {})
+      options = {:format => 'html'}.merge(options).collect{|key, val|
+          "#{key.to_s}=#{::CGI.escape(val.to_s)}"}.join('&')
+
+      request = "#{API_URL}?appid=#{API_ID}&query=#{::CGI.escape(query)}&" +
+          options + '&output=json'
+
+      r = JSON.parse(open(request).read)['ResultSet']
+
+      # Parse the response into a more Rubyish format.
+      data = {
+        :available => r['totalResultsAvailable'],
+        :end       => r['totalResultsReturned'] + r['firstResultPosition'] - 1,
+        :results   => [],
+        :start     => r['firstResultPosition'],
+        :returned  => r['totalResultsReturned']
+      }
+
+      r['Result'].each do |result|
+        data[:results] << {
+          :cache_size => result['Cache'] ? result['Cache']['Size'].to_i : 0,
+          :cache_url  => result['Cache'] ? result['Cache']['Url'] : '',
+          :click_url  => result['ClickUrl'],
+          :mime       => result['MimeType'],
+          :modified   => Time.at(result['ModificationDate']),
+          :summary    => result['Summary'],
+          :title      => result['Title'],
+          :url        => result['Url']
+        }
+      end
+
+      return data
+
+    rescue => e
+      raise SearchError, "Unable to retrieve search results: #{e}"
+    end
+  end
+
+end; end

data/lib/thoth/importer/pants.rb

@@ -0,0 +1,81 @@
+#
+# Pants -> Thoth importer.
+#
+
+class PantsImporter < Thoth::Importer
+
+  before_import do
+    unless uri = ARGV.shift
+      puts "Please enter a connection string for the Pants database you want to import."
+      puts "Example: mysql://user:pass@localhost/dbname"
+      print "> "
+
+      uri = STDIN.gets.strip
+      puts
+    end
+
+    begin
+      @pants = Sequel.connect(uri)
+    rescue => e
+      abort("Error: unable to connect to database: #{e}")
+    end
+  end
+
+  import_comments do
+    @pants[:comments].each do |row|
+      Thoth::Comment.create do |comment|
+        comment.id         = row[:id]
+        comment.author     = row[:author]
+        comment.author_url = row[:url]
+        comment.title      = row[:title]
+        comment.body       = row[:content]
+        comment.created_at = row[:posted]
+        comment.updated_at = row[:posted]
+        comment.post_id    = row[:article_id]
+      end
+    end
+  end
+
+  import_pages do
+    @pants[:pages].each do |row|
+      Thoth::Page.create do |page|
+        page.id         = row[:id]
+        page.title      = row[:title]
+        page.name       = row[:name]
+        page.body       = row[:content]
+        page.created_at = row[:posted]
+        page.updated_at = row[:modified]
+      end
+    end
+  end
+
+  import_posts do
+    @pants[:articles].each do |row|
+      Thoth::Post.create do |post|
+        post.id         = row[:id]
+        post.title      = row[:title]
+        post.body       = row[:content]
+        post.created_at = row[:posted]
+        post.updated_at = row[:modified]
+      end
+    end
+  end
+
+  import_tags do
+    @pants[:tags].each do |tag|
+      Thoth.db[:tags] << {
+        :id   => tag[:id],
+        :name => tag[:name].downcase
+      }
+    end
+
+    @pants[:tags_articles_map].each do |tagmap|
+      Thoth.db[:tags_posts_map] << {
+        :id      => tagmap[:id],
+        :tag_id  => tagmap[:tag_id],
+        :post_id => tagmap[:article_id]
+      }
+    end
+  end
+
+end

data/lib/thoth/importer/poseidon.rb

@@ -0,0 +1,54 @@
+#
+# Poseidon 0.3 -> Thoth importer.
+#
+
+class PoseidonImporter < Thoth::Importer
+
+  before_import do
+    unless uri = ARGV.shift
+      puts "Please enter a connection string for the Poseidon database you want to import."
+      puts "Example: mysql://user:pass@localhost/dbname"
+      print "> "
+
+      uri = STDIN.gets.strip
+      puts
+    end
+
+    begin
+      @poseidon = Sequel.connect(uri)
+    rescue => e
+      abort("Error: unable to connect to database: #{e}")
+    end
+  end
+
+  import_comments do
+    @poseidon[:comments].all do |row|
+      user = @poseidon[:users].filter(:id => row[:userid]).first
+
+      Thoth::Comment.create do |comment|
+        comment.id         = row[:id]
+        comment.author     = user[:username]
+        comment.author_url = ''
+        comment.title      = row[:title]
+        comment.body       = row[:content]
+        comment.created_at = Time.at(row[:posted])
+        comment.updated_at = Time.at(row[:posted])
+        comment.ip         = row[:ip]
+        comment.post_id    = row[:contentid]
+      end
+    end
+  end
+
+  import_posts do
+    @poseidon[:content].each do |row|
+      Thoth::Post.create do |post|
+        post.id         = row[:id]
+        post.title      = row[:title]
+        post.body       = row[:content]
+        post.created_at = Time.at(row[:posted])
+        post.updated_at = Time.at(row[:posted])
+      end
+    end
+  end
+
+end