Douglas F Shearer - Coding posts

Easy_Install Leopard bug: No Eggs Found

Douglas F Shearer noreply@douglasfshearer.com — Fri, 03 Jul 2009 22:57:05 +0000

Today I came across Zed Shaw latest awesome project, Lamson, an Python mail server that isn’t stuck in the past. The Register has a pretty good rundown on it if you want to know more.

So anyway, on installing it, one of it’s dependences, the jinja2 templating engine, exposed a bug in easy_install that seems to be quite prevelant on OS X 10.5 Leopard. The error message will be something like No eggs found in /foo/bar/etc (setup script problem?).

The solution is to upgrade to the latest version of easy_install as so:

sudo easy_install http://pypi.python.org/packages/2.5/s/setuptools/setuptools-0.6c9-py2.5.egg

Best to check the project page to see if a newer version has be released.

Credits: A similar older fix by Sean Lynch with a non-working patched upgrade.

Flic.kr - Flickr Short URLs Explained

Douglas F Shearer noreply@douglasfshearer.com — Sat, 25 Apr 2009 21:39:54 +0000

Flic.kr links recently began appearing on Twitter and around the web, so I did a little bit of digging. Twitter has brought about a wild storm of URl shortening services, and some issues surrounding them. James Duncan Davidson has a good summing up of these, and some of the solutions.

One of these solutions is to use a link tag on a page to give an alternative short URL. Flickr has started to support this, as so…

On a photo page, say http://www.flickr.com/photos/douglasfshearer/3447346323/, we find in the source:


&lt;link rev="canonical" type="text/html" href="http://flic.kr/p/6fCxXz" &gt;

Twitter clients can now take a pasted Flickr link, and go look up this short url on the Flickr page, without making use of a third party service such as tr.im. Good stuff.

This also works for user accounts, as an example, mine would be http://flic.kr/douglasfshearer.

Tools

The short photo URL is the photo ID converted to Base58, so you need to turn one into the other.

The item that really brought this to my attention was Fraser Speirs Base58Encode Objective-C class, ideal for those of you making Twitter clients.

I’ve released a RubyGem for this, Base58, and a CLI script that takes a flickr URL and gives you the short version.

Acts_As_indexed v0.5.0 Released

Douglas F Shearer noreply@douglasfshearer.com — Fri, 24 Apr 2009 20:08:54 +0000

My Acts_as_indexed plugin has been updated to version 0.5.0.

New in this version is:

Ruby 1.9 and Rails 2.3 compatibility.
Index location can now be set. Provides Heroku compatibility.
Better errors on bad options.
ActiveRecord order argument overrides ranking returned by find_by_index.
Various test environment improvements
Various Bugfixes

Get it on Github or view the RDoc.

Testing Custom Rails Validations with Shoulda

Douglas F Shearer noreply@douglasfshearer.com — Wed, 28 Jan 2009 20:26:42 +0000

In this post, I’ll show how to write custom validations for Rails’ models, and how to test them with Shoulda, the ‘Makes tests easy on the fingers and the eyes’ testing plugin.

Rails’ ActiveRecord validations are great when you want to make sure attributes are the way you want them. But what about the use-cases where you need to write a custom one?

Creating the Validation

The validation we’ll write is called validates_positive_or_zero, which will return an error if a relevant integer attribute is negative.

Create the file RAILS_ROOT/lib/validations.rb with the following contents:


def validates_positive_or_zero(*attr_names)
  # Set the default error message.
  configuration = { :message =&gt; "Cannot be negative" }
  
  # Set a custom error message if there is one.
  configuration.update(attr_names.pop) if attr_names.last.is_a?(Hash)
  
  # Check none of the object's attributes are negative.
  validates_each attr_names do |obj, atr, val| obj.errors.add(atr, configuration[:message]) if val &lt; 0 end
end

Note: This particular validation is complementary to validates_numericality_of, you’ll get some odd failures if you don’t use it.

We need to require this file before we can use the new validation in our model:


class Badger &lt; ActiveRecord::Base
  require 'validations'
  
  validates_numericality_of :age, :height, :weight
  validates_positive_or_zero :age, :height
  validates_positive_or_zero :weight, :message =&gt; 'no-one is that light'
end

The first validates_positive_or_zero validates two attributes at once, whereas the second validates only one attribute with a custom error message.

Testing the Validation

I feel I should give a little introduction to Shoulda, it’s one of those tools that leaves me wondering how I ever managed before. Despite the popularity of RSpec within the Ruby community, I’m not a fan, it’s just too verbose, which I find gets in the way (it doesn’t render views though, which makes functional testing a lot easier, this feature for standard Rails tests please!). Shoulda is the answer for those of us who want standard Rails tests, but with them being neater and tidier. I encourage you to check it out more fully, but for this example, I’ll stay on-subject.

For our custom validation we could test it in the regular fashion with a test_foo method, or we could write a custom method that we could use again and again without re-writing the same code. The latter is the approach we are going to take here, with the method being in the style of the other shoulda validation tests.

First up, install the Shoulda plugin:

./script/plugin install git://github.com/thoughtbot/shoulda.git

Next, create the file RAILS_ROOT/test/shoulda_macros/validations.rb with the following contents:


class Test::Unit::TestCase
  
  def self.should_only_allow_positive_or_zero_values_for(*attributes)
    configuration = { :message =&gt; "Cannot be negative" }
    configuration.update(attributes.pop) if attributes.last.is_a?(Hash)
    klass = model_class
    attributes.each do |attribute|
      attribute = attribute.to_sym
      should "only allow positive or zero values for #{attribute}" do
        assert_bad_value(klass, attribute, -1, configuration[:message])
      end
    end
  end
  
  private
  
  # Taken from the shoulda private methods
  def model_class
    self.name.gsub(/Test$/, '').constantize
  end
  
end

Now we set up our tests in RAILS_ROOT/test/units/badger_test.rb:


require 'test_helper'

class BadgerTest &lt; Test::Unit::TestCase
  
  # This method is provided by Shoulda.
  should_only_allow_numeric_values_for :age, :height, :weight
  
  should_only_allow_positive_or_zero_values_for :age, :height 
  should_only_allow_positive_or_zero_values_for :weight, :message =&gt; 'no-one is that light'
  
end

And we’re done! I hope this was useful for you.

GitHub Bookmarklet Updated

Douglas F Shearer noreply@douglasfshearer.com — Thu, 22 Jan 2009 23:35:36 +0000

I’ve added support for Github’s repository search and making use of their new search to Github Bookmarklet.

Get it

Drag this to your bookmarks bar: Github Search.

Repository Search

As for user and code-search, but use the r: prefix. You can also use any of the GitHub macros as defined in the blog post linked from above.

r: will_paginate

Docs etc

Original post

Github project page

Rails Plugin: Acts As Follower

Douglas F Shearer noreply@douglasfshearer.com — Fri, 21 Nov 2008 19:33:39 +0000

Followers are the new friends. Apps such as Twitter and Github have effectively enabled virtual stalking within their apps. So how can you do this easily without wasting time with your own join tables? Acts_As_Follower to the rescue!

Install

<code>./script/plugin install git://github.com/tcocca/acts_as_follower.git

Usage

A service like Twitter would have a user model, which would be both a follower and followable…


  class User &lt; ActiveRecord::Base
    acts_as_follower
    acts_as_followable
  end

  # In the console...
  user1.follow(user2)

  # Get the users following user2
  user2.followers # =&gt; # Array containing user1

  # Get the users user1 is following
  user1.following # =&gt; Array containing user2

  # Check following
  user1.following?(user2) # =&gt; true
  user2.following?(user1) # =&gt; false

  # Stop following
  user1.stop_following(user2)

Acts_As_Follower allows heterogeneous follow relationships too, so a user could follow repositories and users, say, in an application like Github.

This plugin saved me a lot of time during the start-up of a recent project, and it hopefully should do the same for you. For more usage examples, see the README.

GitHub Bookmarklet Now Supports Code Search

Douglas F Shearer noreply@douglasfshearer.com — Mon, 03 Nov 2008 20:36:19 +0000

I’ve added support for Github’s new code-search feature to Github Bookmarklet.

Get it

Drag this to your bookmarks bar: Github Search.

Code Search

As for user-search, but use the c: prefix. You can also use any of the GitHub macros as defined on the code-search page

c: badger language:ruby

Docs etc

Original post

Github project page

Announcing GitHub Bookmarklet

Douglas F Shearer noreply@douglasfshearer.com — Tue, 28 Oct 2008 20:04:33 +0000

You have to love GitHub! Just last week I was saying to Kamal on the phone that I now instinctively search for a project on GitHub before Google, because it’s likely to be there, and grabbing a copy or just browsing the source is made so easy for me.

What a shame it’s an extra few clicks to search it. Until now! Enter the GitHub Bookmarlet!

Install

Save the following link as a bookmark, or drag it to the links/bookmarks bar in your browser:

Over here → Github Search.

If you get stuck, Delicous have a lovely guide to bookmarklet installation.

Usage

When you click on the bookmarklet, it’ll give you a text prompt. Type in the name of the project you want to search for, and hit return. You’ll be taken to the GitHub search page for your query.

Hitting ESC or Cancel leaves your browser in it’s previous state.

User Macro

Want to search for a user? Type in ‘u:’ followed by your query. So for instance to look at Kamal’s github account, I would type in: u:kamal.

Hitting Return or OK now takes you straight to the user’s Github profile, or shows you a 404 if there is no such user.

h4. Code Search

As for user-search, but use the c: prefix. You can also use any of the GitHub macros as defined on the code-search page: http://github.com/codesearch. c: badger language:ruby.

Acknowledgements

John Gruber for his bookmarklet formatting script.
The GitHub team for, well, Github.

Future

If you have any suggestions, send me a message on GitHub, or fork the project and throw me a pull-request once you’ve made your changes.

Acts_As_Indexed now on GitHub

Douglas F Shearer noreply@douglasfshearer.com — Sun, 10 Aug 2008 15:37:48 +0000

A few people had been requesting that I moved my Acts_as_indexed plugin to GitHub.

See the original post for the new install details.

Pagination

The pagination for this plugin has now been rolled into the release version, no more separate plugin.

JQuery on Rails

Douglas F Shearer noreply@douglasfshearer.com — Fri, 23 May 2008 20:39:17 +0000

Now, I know I am totally late to the party on this one, but how much does JQuery rock??

For several years now I have done all of my JS(JavaScript) stuff using the Prototype and Scriptaculous libraries. I think they’re pretty awesome tools, and certainly being part of the standard Ruby on Rails package has helped them gain a lot of respect and usage.

Today I had to do a fairly complex piece of UI prototyping that involved a lot of complex JS. It took me about an hour to do it with Prototype, but I wasn’t completely satisfied with the results. Some of m fellow ZoeCity devs had been talking about JQuery for a new project we’ve just started, so I thought I’d give it a bash. 20 minutes later I had a functional better implementation, with less, neater looking code.

What About Rails?

As I’ve already mentioned, Rails ships with Prototype, so how do you go about using JQuery in these places? Enter JRails by aaronchi. This is a Rails plugin which replaces all the regular Prototype utilizing helpers with JQuery. Sorted!

JQuery is stupidly easy to learn, especially for anyone from an OOP background, so you should definitely give it a try on your next project.