chopper 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+.rvmrc
+*.gem
+*.sw?

data/README.markdown

@@ -0,0 +1,60 @@
+# Chopper
+
+Chop your strings into pieces like a pro! Chopper will satisfy all of your string cleaving needs!
+
+## Install
+
+    $ gem install chopper
+
+## Chop Suey
+
+Chopper helps you chop your strings into smaller pieces. You can:
+
+* Chop a book into paragraphs
+* Chop a 312 page manifesto on how the government secretely puts computer chips in your brain into tweets
+
+The full list of methods added to string (see http://rubydoc.info/gems/chopper for all of the detailed documentation):
+
+* String#paragraphs
+* String#tweets
+
+## Tweets
+
+You can break up a string into 140 character chunks using the `#tweets` method on `String` instances. It will break on the nearest word boundary
+(instead of chopping the tweet in the middle of a word). It also allows you to choose the delimeter - it defaults to `...` 
+
+    my_tweet = 
+      "This tweet is over the 140 character limit, unfortunately. " +
+      "Now I'll have to break the tweet up into smaller tweets. " + 
+      "Well, that's just great. Gosh Darnit! Arrrghhhhh!"
+    
+    my_tweet.tweets 
+      #==> [
+        "This tweet is over the 140 character limit, unfortunately. Now I'll have to break the tweet up into smaller tweets. Well, that's just ...", 
+        "great. Gosh Darnit! Arrrghhhhh!"
+      ]
+    
+    my_tweet.tweets :delimeter => "... (more)"
+      #==> [
+        "This tweet is over the 140 character limit, unfortunately. Now I'll have to break the tweet up into smaller tweets. Well, that's ... (more)", 
+        "just great. Gosh Darnit! Arrrghhhhh!"
+      ]
+
+    my_tweet.each_tweet do |tweet|
+      p tweet
+    end
+
+### @reply tweets
+
+Chopper will detect @reply tweets (tweets that start with a twitter handle), and will prepend the handle to all tweets:
+
+  string = "@moonmaster9000 this is a really long tweet. can you believe how long it is? i hope it's not too long, because if it goes over 140 characters, then I can't tweet it. Or can I?"
+  string.tweets
+    #==> [
+      "@moonmaster9000 this is a really long tweet. can you believe how long it is? i hope it's not too long, because if it goes over 140 ...", 
+      "@moonmaster9000 characters, then I can't tweet it. Or can I?"
+    ]
+
+## Public Domain
+
+This software is committed to the public domain. No license. No copyright. DO ANYTHING!

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/chopper.gemspec

@@ -0,0 +1,24 @@
+Gem::Specification.new do |s|
+  s.name = "chopper"
+  s.version = File.read "VERSION"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matt Parker"]
+  s.date = %q{2011-02-23}
+  s.description = %q{Chop up a string into paragraphs or tweets}
+  s.email = %q{moonmaster9000@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+ 
+  s.homepage = %q{http://github.com/moonmaster9000/chopper}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.0}
+  s.summary = %q{Turn a single string into an array of strings. Supports paragraphs and tweets.}
+  
+  s.add_development_dependency(%q<cucumber>, ["~> 0.10.0"])
+  s.add_development_dependency("rspec", ["~> 2.4.0"])
+end

data/features/paragraphs.feature

@@ -0,0 +1,12 @@
+Feature: Breaking up a string into paragraphs
+  As a programmer
+  I want to be able to break a string into an array of paragraphs
+  So that I can do something with those paragraphs
+
+  Scenario: Breaking up a string into an array of paragraphs with #paragraphs
+    Given a string containing a single paragraph
+    When I call the #paragraphs method
+    Then I should get an array containing the string itself
+    Given a string containing multiple paragraphs
+    When I call the #paragraphs method
+    Then I should get an array containing all the paragraphs in the string

data/features/setup/env.rb

@@ -0,0 +1,3 @@
+$LOAD_PATH.unshift './lib'
+require 'rspec'
+require 'chopper'

data/features/step_definitions/paragraph_steps.rb

@@ -0,0 +1,21 @@
+Given /^a string containing a single paragraph$/ do
+  @string = "blah"
+end
+
+When /^I call the \#paragraphs method$/ do
+  @paragraphs = @string.paragraphs
+end
+
+Then /^I should get an array containing the string itself$/ do
+  @paragraphs.length.should == 1
+  @paragraphs.first.should == @string
+end
+
+Given /^a string containing multiple paragraphs$/ do
+  @string = "blah 1\nblah 2\n\nblah 3\n"
+end
+
+Then /^I should get an array containing all the paragraphs in the string$/ do
+  @paragraphs.length.should == 3
+  @paragraphs.should == ["blah 1", "blah 2", "blah 3"]
+end

data/features/step_definitions/tweet_steps.rb

@@ -0,0 +1,44 @@
+Given /^a string representing a tweet longer than 140 words$/ do
+  @tweet_string = "this is a really long tweet. can you believe how long it is? i hope it's not too long, because if it goes over 140 characters, then I can't tweet it. Or can I?"
+end
+
+When /^I call the \#tweets method on it$/ do
+  @tweets = @tweet_string.tweets
+  puts @tweets.inspect
+end
+
+Then /^I should get an array of strings breaking up the original string into 140 character chunks$/ do
+  @tweets.all? {|t| t.length <= 140}.should be_true
+end
+
+When /^I call the \#tweets method on it with a custom delimeter$/ do
+  @delimiter = "... cont'd"
+  @tweets = @tweet_string.tweets :delimiter => @delimiter
+  puts "@tweets with custom delimiter = #{@tweets.inspect}"
+end
+
+Then /^I should get an array of string breakinup up the original string into 140 character chunks using my custom delimeter$/ do
+  Then "I should get an array of strings breaking up the original string into 140 character chunks"
+  @tweets[0..-2].all? {|t| t.match @delimiter}.should be_true
+  @tweets[-1].match(@delimiter).should_not be_true
+end
+
+Given /^an @reply tweet string that's longer than 140 character$/ do
+  @tweet_string = "@moonmaster9000 this is a really long tweet. can you believe how long it is? i hope it's not too long, because if it goes over 140 characters, then I can't tweet it. Or can I?"
+end
+
+Then /^each of those chunks should begin with the @reply$/ do
+  @tweets.all? {|t| t.match /^@moonmaster9000\ .+$/}.should be_true
+end
+
+Given /^a string representing a tweet less than 140 characters$/ do
+  @tweet_string = "short tweet!"
+end
+
+Then /^I should get back the tweet encapsulated in an array$/ do
+  @tweets.should == [@tweet_string]
+end
+
+Given /^a string representing an @reply tweet less than 140 characters$/ do
+  @tweet_string = "@moonmaster9000 short reply!"
+end

data/features/tweets.feature

@@ -0,0 +1,30 @@
+Feature: Breaking up a string into tweets
+  As a programmer
+  I want to break up a string into tweets
+  So that I can tweet the string to twitter
+
+  Scenario: Breaking up a string into tweets when that string is already less than 140 character
+    Given a string representing a tweet less than 140 characters
+    When I call the #tweets method on it
+    Then I should get back the tweet encapsulated in an array
+
+  Scenario: Breaking up a string into tweets
+    Given a string representing a tweet longer than 140 words
+    When I call the #tweets method on it
+    Then I should get an array of strings breaking up the original string into 140 character chunks
+  
+  Scenario: Specifying the delimiter to use when a string is broken up into tweet chunks
+    Given a string representing a tweet longer than 140 words
+    When I call the #tweets method on it with a custom delimeter
+    Then I should get an array of string breakinup up the original string into 140 character chunks using my custom delimeter
+
+  Scenario: Breaking up an @reply into tweets when that @reply is already less than 140 character
+    Given a string representing an @reply tweet less than 140 characters
+    When I call the #tweets method on it
+    Then I should get back the tweet encapsulated in an array
+
+  Scenario: Recognizing an @reply tweet, and putting the @reply on all chunks
+    Given an @reply tweet string that's longer than 140 character
+    When I call the #tweets method on it
+    Then I should get an array of strings breaking up the original string into 140 character chunks
+    And each of those chunks should begin with the @reply 

data/lib/chopper.rb

@@ -0,0 +1,2 @@
+require 'chopper/paragraphs'
+require 'chopper/tweets'

data/lib/chopper/paragraphs.rb

@@ -0,0 +1,5 @@
+class String
+  def paragraphs
+    split /\n+/
+  end
+end

data/lib/chopper/tweets.rb

@@ -0,0 +1,35 @@
+class String
+  def tweets options={}
+    return [self] if self.length <= (options[:max_length] || 140)
+    delimiter = options[:delimiter] || "..."
+    prepend = self.match(/^(@[^\s]+\ ).+$/)
+    prepend = prepend[1] if prepend
+    max_length = (options[:max_length] || 140) - delimiter.length
+    max_length -= prepend.length if prepend
+    string = self.dup
+    string = string[prepend.length..-1] if prepend
+    ts = []
+
+    until string.length <= max_length
+      i = max_length - 1
+      character = string[i..i]
+      while !character.match(/^\s$/) and i > 0
+        i -= 1
+        character = string[i..i]
+      end
+
+      i = i == 0 ? (max_length - 1) : i
+      t = string[0..i] + delimiter
+      t = prepend + t if prepend
+      ts << t
+      string = string[(i+1)..-1]
+    end
+
+    unless string.empty?
+      string = prepend + string if prepend
+      ts << string
+    end
+    
+    ts
+  end
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification 
+name: chopper
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Parker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-23 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 55
+        segments: 
+        - 0
+        - 10
+        - 0
+        version: 0.10.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 2
+        - 4
+        - 0
+        version: 2.4.0
+  type: :development
+  version_requirements: *id002
+description: Chop up a string into paragraphs or tweets
+email: moonmaster9000@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- README.markdown
+- VERSION
+- chopper.gemspec
+- features/paragraphs.feature
+- features/setup/env.rb
+- features/step_definitions/paragraph_steps.rb
+- features/step_definitions/tweet_steps.rb
+- features/tweets.feature
+- lib/chopper.rb
+- lib/chopper/paragraphs.rb
+- lib/chopper/tweets.rb
+has_rdoc: true
+homepage: http://github.com/moonmaster9000/chopper
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Turn a single string into an array of strings. Supports paragraphs and tweets.
+test_files: 
+- features/paragraphs.feature
+- features/setup/env.rb
+- features/step_definitions/paragraph_steps.rb
+- features/step_definitions/tweet_steps.rb
+- features/tweets.feature