rethoth 0.4.1

data/lib/thoth/model/post.rb

@@ -0,0 +1,262 @@
+#--
+# 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
+  class Post < Sequel::Model
+    include Thoth::Helper::Wiki
+
+    plugin :hook_class_methods
+    plugin :validation_helpers
+
+    one_to_many  :tags_posts_map, :class => 'Thoth::TagsPostsMap'
+    many_to_many :tags, :class => 'Thoth::Tag', :join_table => :tags_posts_map,
+        :order => :name
+
+    before_create do
+      self.created_at = Time.now
+    end
+
+    before_destroy do
+      TagsPostsMap.filter(:post_id => id).delete
+      Comment.filter(:post_id => id).delete
+    end
+
+    before_save do
+      self.updated_at = Time.now
+    end
+
+    #--
+    # Class Methods
+    #++
+
+    # Gets the published post with the specified name, where _name_ can be
+    # either a name or an id. Does not return drafts.
+    def self.get(name)
+      return Post[:id => name, :is_draft => false] if name.is_a?(Numeric)
+
+      name = name.to_s.downcase
+      name =~ /^\d+$/ ? Post[:id => name, :is_draft => false] :
+          Post[:name => name, :is_draft => false]
+    end
+
+    # Returns true if the specified post name is already taken or is a reserved
+    # name.
+    def self.name_unique?(name)
+      !PostController.methods.include?(name) &&
+          !PostController.instance_methods.include?(name) &&
+          !Post[:name => name.to_s.downcase]
+    end
+
+    # Returns true if the specified post name consists of valid characters and
+    # is not too long or too short.
+    def self.name_valid?(name)
+      !!(name =~ /^[0-9a-z_-]{1,64}$/i) && !(name =~ /^[0-9]+$/)
+    end
+
+    # Gets a paginated dataset of recent published posts sorted in reverse order
+    # by creation time. Does not return drafts.
+    def self.recent(page = 1, limit = 10)
+      filter(:is_draft => false).reverse_order(:created_at).paginate(page,
+          limit)
+    end
+
+    # Gets a paginated dataset of recent draft posts sorted in reverse order
+    # by creation time. Does not return published posts.
+    def self.recent_drafts(page = 1, limit = 10)
+      filter(:is_draft => true).reverse_order(:created_at).paginate(page,
+          limit)
+    end
+
+    # Returns a valid, unique post name based on the specified title. If the
+    # title is empty or cannot be converted into a valid name, an empty string
+    # will be returned.
+    def self.suggest_name(title)
+      index = 1
+
+      # Remove HTML entities and non-alphanumeric characters, replace spaces
+      # with hyphens, and truncate the name at 64 characters.
+      name = title.to_s.strip.downcase.gsub(/&[^\s;]+;/, '_').
+          gsub(/[^\s0-9a-z-]/, '').gsub(/\s+/, '-')[0..63]
+
+      # Strip off any trailing non-alphanumeric characters.
+      name.gsub!(/[_-]+$/, '')
+
+      return '' if name.empty?
+
+      # If the name consists solely of numeric characters, add an alpha
+      # character to prevent name/id ambiguity.
+      name += '_' unless name =~ /[a-z_-]/
+
+      # Ensure that the name doesn't conflict with any methods on the Post
+      # controller and that no two posts have the same name.
+      until self.name_unique?(name)
+        if name[-1] == index
+          name[-1] = (index += 1).to_s
+        else
+          name = name[0..62] if name.size >= 64
+          name += (index += 1).to_s
+        end
+      end
+
+      return name
+    end
+
+    #--
+    # Instance Methods
+    #++
+
+    # Gets the Atom feed URL for this post.
+    def atom_url
+      Config.site['url'].chomp('/') + PostController.r(:atom, name).to_s
+    end
+
+    def body=(body)
+      self[:body]          = body.strip
+      self[:body_rendered] = RedCloth.new(wiki_to_html(body.dup.strip)).to_html
+    end
+
+    # Gets a dataset of visible comments attached to this post, ordered by
+    # creation time.
+    def comments
+      @comments ||= Comment.filter(:post_id => id, :deleted => false).order(:created_at)
+    end
+
+    # Gets the creation time of this post. If _format_ is provided, the time
+    # will be returned as a formatted String. See Time.strftime for details.
+    def created_at(format = nil)
+      if new?
+        format ? Time.now.strftime(format) : Time.now
+      else
+        format ? self[:created_at].strftime(format) : self[:created_at]
+      end
+    end
+
+    def name=(name)
+      self[:name] = name.to_s.strip.downcase unless name.nil?
+    end
+
+    # Gets an Array of tags attached to this post, ordered by name.
+    def tags
+      if new?
+        @fake_tags || []
+      else
+        @tags ||= tags_dataset.all
+      end
+    end
+
+    def tags=(tag_names)
+      if tag_names.is_a?(String)
+        tag_names = tag_names.split(',', 64)
+      elsif !tag_names.is_a?(Array)
+        raise ArgumentError, "Expected String or Array, got #{tag_names.class}"
+      end
+
+      tag_names = tag_names.map{|n| n.strip.downcase}.uniq.delete_if{|n|
+          n.empty?}
+
+      if new?
+        # This Post hasn't been saved yet, so instead of attaching actual tags
+        # to it, we'll create a bunch of fake tags just for the preview. We
+        # won't create the real ones until the Post is saved.
+        @fake_tags = []
+
+        tag_names.each {|name| @fake_tags << Tag.new(:name => name)}
+        @fake_tags.sort! {|a, b| a.name <=> b.name }
+
+        return @fake_tags
+      else
+        real_tags = []
+
+        # First delete any existing tag mappings for this post.
+        TagsPostsMap.filter(:post_id => id).delete
+
+        # Create new tags and new mappings.
+        tag_names.each do |name|
+          tag = Tag.find_or_create(:name => name)
+          real_tags << tag
+          TagsPostsMap.create(:post_id => id, :tag_id => tag.id)
+        end
+
+        return real_tags
+      end
+    end
+
+    def title=(title)
+      title.strip!
+
+      # Set the post's name if it isn't already set.
+      if self[:name].nil? || self[:name].empty?
+        self[:name] = Post.suggest_name(title)
+      end
+
+      self[:title] = title
+    end
+
+    # Gets the time this post was last updated. If _format_ is provided, the
+    # time will be returned as a formatted String. See Time.strftime for
+    # details.
+    def updated_at(format = nil)
+      if new?
+        format ? Time.now.strftime(format) : Time.now
+      else
+        format ? self[:updated_at].strftime(format) : self[:updated_at]
+      end
+    end
+
+    # Gets the URL for this post.
+    def url
+      Config.site['url'].chomp('/') + PostController.r(:/, name).to_s
+    end
+
+    def validate
+      validates_presence(:name,  :message => 'Please enter a name for this post.')
+      validates_presence(:title, :message => 'Please enter a title for this post.')
+      validates_presence(:body,  :message => "What's the matter? Cat got your tongue?")
+
+      validates_max_length(255, :title, :message => 'Please enter a title under 255 characters.')
+      validates_max_length(64,  :name,  :message => 'Please enter a name under 64 characters.')
+
+      validates_format(/^[0-9a-z_-]+$/i, :name, :message => 'Post names may only contain letters, numbers, underscores, and dashes.')
+      validates_format(/[a-z_-]/i,       :name, :message => 'Post names must contain at least one non-numeric character.')
+    end
+
+  end
+
+  unless Post.count > 0
+    Post.create(
+      :title => 'Welcome to your new Thoth blog',
+      :body  => %[
+        If you're reading this, you've successfully installed Thoth. Congratulations!
+
+        Once you've <a href="txmt://open/?url=file://#{Thoth.trait[:config_file]}">edited the config file</a> to your liking, you can <a href="/admin">login</a> and begin creating blog posts and pages. You can also delete this post to make way for your own glorious words.
+
+        Enjoy!
+      ].unindent
+    )
+  end
+end

data/lib/thoth/model/tag.rb

@@ -0,0 +1,80 @@
+#--
+# 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
+  class Tag < Sequel::Model
+    plugin :validation_helpers
+
+    one_to_many  :tags_posts_map, :class => 'Thoth::TagsPostsMap'
+    many_to_many :posts, :class => 'Thoth::Post',
+        :join_table => :tags_posts_map, :read_only => true
+
+    #--
+    # Class Methods
+    #++
+
+    # Gets an array of tag names and post counts for tags with names that begin
+    # with the specified query string.
+    def self.suggest(query, limit = 1000)
+      tags = []
+
+      self.dataset.grep(:name, "#{query}%").all do |tag|
+        tags << [tag.name, tag.posts.count]
+      end
+
+      tags.sort!{|a, b| b[1] <=> a[1]}
+      tags[0, limit]
+    end
+
+    #--
+    # Instance Methods
+    #++
+
+    # Gets the Atom feed URL for this tag.
+    def atom_url
+      Config.site['url'].chomp('/') + TagController.r(:atom, name).to_s
+    end
+
+    # Gets published posts with this tag.
+    def posts
+      @posts ||= posts_dataset.filter(:is_draft => false).reverse_order(
+          :created_at)
+    end
+
+    # URL for this tag.
+    def url
+      Config.site['url'].chomp('/') + TagController.r(:/, name).to_s
+    end
+
+    def validate
+      validates_presence(:name)
+      validates_max_length(64, :name)
+    end
+
+  end
+end

data/lib/thoth/model/tags_posts_map.rb

@@ -0,0 +1,34 @@
+#--
+# 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
+  class TagsPostsMap < Sequel::Model(:tags_posts_map)
+    many_to_one :tag, :class => 'Thoth::Tag'
+    many_to_one :post, :class => 'Thoth::Post'
+  end
+end

data/lib/thoth/monkeypatch/sequel/model/errors.rb

@@ -0,0 +1,37 @@
+#--
+# 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 Sequel; class Model
+
+  class Errors
+    def on_field(att)
+      on(att) || []
+    end
+  end
+
+end; end

data/lib/thoth/plugin/thoth_delicious.rb

@@ -0,0 +1,105 @@
+#--
+# 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'
+require 'timeout'
+
+module Thoth; module Plugin
+
+  # Del.icio.us plugin for Thoth.
+  module Delicious
+    FEED_URL = 'http://feeds.delicious.com/feeds/json'
+
+    Config << {
+      'delicious' => {
+
+        # Time in seconds to cache results. It's a good idea to keep this nice
+        # and high both to improve the performance of your site and to avoid
+        # pounding on del.icio.us's servers. Default is 900 seconds (15
+        # minutes).
+        'cache_ttl' => 900,
+
+        # Request timeout in seconds.
+        'request_timeout' => 5
+
+      }
+    }
+
+    class << self
+
+      # Gets recent del.icio.us bookmarks for the specified _username_. The
+      # return value of this method is cached to improve performance and to
+      # avoid pounding del.icio.us with excess traffic.
+      #
+      # Available options:
+      # [<tt>:count</tt>] Number of bookmarks to return (default is 5)
+      # [<tt>:tags</tt>]  Array of tags to filter by. Only bookmarks with the
+      #                   specified tags will be returned.
+      #
+      def recent_bookmarks(username, options = {})
+        cache   = Ramaze::Cache.plugin
+        options = {:count => 5}.merge(options)
+        request = "#{FEED_URL}/#{::CGI.escape(username)}" <<
+            (options[:tags] ? '/' << ::CGI.escape(options[:tags].join(' ')) : '') <<
+            "?raw&count=#{options[:count]}"
+
+        if value = cache[request]
+          return value
+        end
+
+        response = []
+
+        Timeout.timeout(Config.delicious['request_timeout'], StandardError) do
+          response = JSON.parse(open(request).read)
+        end
+
+        # Parse the response into a more friendly format.
+        data = []
+
+        response.each do |item|
+          data << {
+            :url  => item['u'],
+            :desc => item['d'],
+            :note => item['n'] ? item['n'] : '',
+            :tags => item['t'] ? item['t'] : []
+          }
+        end
+
+        return cache.store(request, data, :ttl => Config.delicious['cache_ttl'])
+
+      rescue => e
+        Ramaze::Log.error "Thoth::Plugin::Delicious: #{e.message}"
+        return []
+      end
+
+    end
+  end
+
+end; end

data/lib/thoth/plugin/thoth_flickr.rb

@@ -0,0 +1,86 @@
+#--
+# 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 'timeout'
+require 'net/flickr'
+
+module Thoth; module Plugin
+
+  # Flickr plugin for Thoth.
+  module Flickr
+
+    Config << {
+      'flickr' => {
+
+        # Flickr API key. You can either use the default or replace this with
+        # your own key.
+        'api_key' => '5b1d9919cb2d97585bd3d83e05af80b8',
+
+        # Time in seconds to cache results. It's a good idea to keep this nice
+        # and high both to improve the performance of your site and to avoid
+        # pounding on Flickr's servers. Default is 900 seconds (15 minutes).
+        'cache_ttl' => 900,
+
+        # Request timeout in seconds.
+        'request_timeout' => 5
+
+      }
+    }
+
+    class << self
+
+      # Gets recent Flickr photos (up to _limit_) for the specified _username_.
+      # The return value of this method is cached to improve performance and to
+      # avoid abusing the Flickr API.
+      def recent_photos(username, limit = 4)
+        cache = Ramaze::Cache.plugin
+        key   = "recent_photos_#{username}_#{limit}"
+
+        if value = cache[key]
+          return value
+        end
+
+        @flickr ||= Net::Flickr.new(Config.flickr['api_key'])
+
+        begin
+          Timeout.timeout(Config.flickr['request_timeout'].to_i, StandardError) do
+            value = cache.store(key, @flickr.people.find_by_username(username).
+                photos(:per_page => limit), :ttl => Config.flickr['cache_ttl'])
+          end
+        rescue => e
+          Ramaze::Log.error "Thoth::Plugin::Flickr: #{e.message}"
+          return []
+        else
+          value
+        end
+      end
+
+    end
+  end
+
+end; end