lorem_tolkien 0.1.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a8c18fb46f1717dc06deb8b634eaddbaf5b8d3c87eec03d711d81a0be1f4ccc
-  data.tar.gz: 2a4db1d1c5d2955a981f78015db7e0dce8cfea9134bfd759a880c1e7cbf59bb0
+  metadata.gz: 2407e343b781eb586d13a3e38dd09f407fdf0445a13f53b382ffd5480ca223e3
+  data.tar.gz: 2d78984e55d65a2217f29c86d0307430dcf973c779da4b6753d99f6b066a3f88
 SHA512:
-  metadata.gz: 564a2edbf5556ec2f69628dd303b2a155f7c5f4e48ec5bed03538ca82fa84ec6b8686fe341f4a8d64160c3fe09ae0671a50f4cf78fce95c28cc433833d123c53
-  data.tar.gz: 3462388baad766037dc526a39d2e55b3ca98413b41ec776784e40c8fe264d3b9202d633bde41ebb027b141e9aff46dbd800a059a59a1565c408730bee1f243eb
+  metadata.gz: 38d42f534342cf74845a96051a7992b6d9b11139d05b0a709c9df6e55dcb671fa30cadc9f0545d1f965860fc0192156be7348c492f8b0f4878d4d41197c9e38c
+  data.tar.gz: f150f7ebe6b6edaffa895a585a25a84d0d4f3e441721f78050cb7be521d06c47927e3aa35821bc466be59f29aae3843f92fdc57c8ca1c4dd8b6153344bef9e77

data/README.md

@@ -4,6 +4,8 @@
 
 [![Test Coverage](https://codeclimate.com/github/jemaddux/lorem_tolkien/badges/coverage.svg)](https://codeclimate.com/github/jemaddux/lorem_tolkien)
 
+[On RubyGems.org](https://rubygems.org/gems/lorem_tolkien)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -18,14 +20,38 @@ Or install it yourself as:
 
     $ gem install lorem_tolkien
 
+## Building
+
+    $ gem build lorem_tolkien.gemspec 
+
+    $ gem push lorem_tolkien-0.1.2.gem
+
 ## Usage
 
+### Single Sentence
 LoremTolkien.sentence
   => "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?"
 
+### Multiple Sentences
 LoremTolkien.sentences(5)
   => "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on? In a hole in the ground there lived a hobbit. There is nothing like looking, if you want to find something. You certainly usually find something, if you look, but it is not always quite the something you were after. It does not do to leave a live dragon out of your calculations, if you live near him."
 
+### Specific Word Count
+LoremTolkien.words(10)
+  => "arranging, do Where yore as morning; the fire want shining"
+
+### Single Paragraph
+LoremTolkien.paragraph
+  => "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on? In a hole in the ground there lived a hobbit. There is nothing like looking, if you want to find something."
+
+### Multiple Paragraphs
+LoremTolkien.paragraphs(3)
+  => "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on? In a hole in the ground there lived a hobbit. There is nothing like looking, if you want to find something.
+
+Far over the misty mountains cold To dungeons deep and caverns old We must away ere break of day To seek the pale enchanted gold. The dwarves of yore made mighty spells.
+
+You certainly usually find something, if you look, but it is not always quite the something you were after. It does not do to leave a live dragon out of your calculations, if you live near him."
+
 ## Contributing
 
 1. Fork it
@@ -33,3 +59,7 @@ LoremTolkien.sentences(5)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+## Author
+
+Authored by John Maddux. [jemaddux.com](https://jemaddux.com/)

data/TODO.md

@@ -0,0 +1,107 @@
+# LoremTolkien Improvement Ideas
+
+## 1. Enhanced API & Functionality
+- [x] Add `LoremTolkien.paragraph` and `LoremTolkien.paragraphs(n)` methods
+- [x] Add `LoremTolkien.words(n)` for specific word counts
+- [x] Add `LoremTolkien.characters(n)` for character limits
+- [ ] Add methods that generate random-length content within ranges
+- [ ] Add `LoremTolkien.paragraphs_with_word_count(min, max)` for flexible paragraph generation
+
+## 2. Content Expansion
+- [ ] Add quotes from The Silmarillion, Unfinished Tales, and other Tolkien works
+- [x] Organize quotes by character (Gandalf, Bilbo, Aragorn, etc.)
+- [ ] Categorize quotes by themes (adventure, wisdom, friendship, etc.)
+- [ ] Include quotes in Elvish languages (with translations)
+- [ ] Add quotes from The Children of Húrin and other posthumous works
+- [ ] Include famous poems and songs from Middle-earth
+
+## 3. Better Code Structure
+- [x] Move quotes to separate YAML/JSON files for easier maintenance
+- [ ] Implement weighted random selection for more variety
+- [ ] Add caching for better performance with large quote sets
+- [ ] Create separate modules for different quote categories
+- [ ] Add configuration options for quote selection strategies
+
+## 4. Advanced Features
+- [ ] Generate markdown-formatted text
+- [ ] Create HTML paragraphs with proper tags
+- [ ] Respect character limits while maintaining sentence integrity
+- [ ] Allow reproducible random generation with seeds
+- [ ] Support for generating large amounts of text efficiently
+- [ ] Add `LoremTolkien.html_paragraphs(n)` method
+- [ ] Add `LoremTolkien.markdown_paragraphs(n)` method
+
+## 5. Testing & Quality
+- [ ] Add comprehensive tests for all methods and edge cases
+- [ ] Add performance tests and benchmarks
+- [ ] Ensure all quotes are properly attributed and formatted
+- [ ] Add integration tests for real-world usage scenarios
+- [ ] Add test coverage reporting
+- [ ] Add property-based testing for random generation
+
+## 6. Documentation & Examples
+- [ ] Improve README with more usage examples and API documentation
+- [ ] Create a command-line interface for quick text generation
+- [ ] Add Rails helpers for view testing
+- [ ] Create examples directory with real-world usage patterns
+- [ ] Add API documentation with YARD
+- [ ] Create a quick start guide
+
+## 7. Modern Ruby Features
+- [ ] Use keyword arguments for better API design
+- [ ] Add frozen string literals for performance and safety
+- [ ] Ensure RuboCop compliance for code style consistency
+- [ ] Update to current Ruby gem standards
+- [ ] Use modern Ruby syntax throughout
+- [ ] Add type checking with RBS or Sorbet
+
+## 8. User Experience
+- [ ] Improve error messages for invalid inputs
+- [ ] Add input validation with helpful feedback
+- [ ] Support different output formats (plain text, HTML, markdown)
+- [ ] Add internationalization support for different languages
+- [ ] Add configuration options for default behavior
+- [ ] Create a configuration class for user preferences
+
+## 9. Performance & Scalability
+- [ ] Implement lazy loading for memory efficiency
+- [ ] Ensure thread-safe operation
+- [ ] Optimize memory usage for large quote collections
+- [ ] Implement smart caching for repeated requests
+- [ ] Add performance benchmarks
+- [ ] Consider using a more efficient data structure for quotes
+
+## 10. Community & Ecosystem
+- [ ] Create clear contributing guidelines
+- [ ] Add structured templates for bug reports and feature requests
+- [ ] Maintain a proper changelog
+- [ ] Set up automated testing and deployment with CI/CD
+- [ ] Add a code of conduct
+- [ ] Create issue templates for GitHub
+
+## 11. CLI Tool
+- [ ] Create a command-line interface
+- [ ] Add options for different output formats
+- [ ] Support for generating files with LoremTolkien content
+- [ ] Add interactive mode for real-time generation
+- [ ] Include help and usage information
+
+## 12. Rails Integration
+- [ ] Create Rails helpers for view testing
+- [ ] Add generators for creating test data
+- [ ] Integrate with Rails console for easy testing
+- [ ] Add view helpers for generating sample content
+
+## 13. Data Management
+- [ ] Create a data validation system for quotes
+- [ ] Add tools for importing new quotes
+- [ ] Create a quote management system
+- [ ] Add metadata for each quote (source, character, theme)
+- [ ] Implement quote versioning
+
+## 14. Advanced Generation Features
+- [ ] Add support for generating dialogue between characters
+- [ ] Create methods for generating story-like content
+- [ ] Add support for generating poetry and songs
+- [ ] Implement context-aware quote selection
+- [ ] Add methods for generating themed content sets

data/lib/lorem_tolkien/quotes.yml

@@ -0,0 +1,159 @@
+quotes:
+  Gandalf:
+    - "It does not do to leave a live dragon out of your calculations, if you live near him."
+    - "Where there's life there's hope."
+    - "What a lot of things you do use Good morning for!"
+    - "Now you mean that you want to get rid of me, and that it won't be good till I move off."
+    - "Looking behind."
+    - "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?"
+    - "To look ahead."
+    - "All we have to decide is what to do with the time that is given us."
+    - "A wizard is never late, nor is he early, he arrives precisely when he means to."
+    - "Fly, you fools!"
+    - "You shall not pass!"
+    - "I will not say: do not weep; for not all tears are an evil."
+    - "Even the very wise cannot see all ends."
+    - "The world is not in your books and maps. It's out there."
+  Bilbo:
+    - "Good Morning!' said Bilbo, and he meant it."
+    - "All of them at once."
+    - "And a very fine morning for a pipe of tobacco out of doors, into the bargain."
+    - "Good morning!' he said at last."
+    - "We don't want any adventures here, thank you!"
+    - "I think I'm quite ready for another adventure."
+    - "It's a dangerous business, Frodo, going out your door."
+    - "I don't know half of you half as well as I should like; and I like less than half of you half as well as you deserve."
+    - "There and back again."
+    - "I am looking for someone to share in an adventure that I am arranging, and it's very difficult to find anyone."
+    - "So comes snow after fire, and even dragons have their endings."
+  Thorin:
+    - "Where did you go to, if I may ask?' said Thorin to Gandalf as they rode along."
+  Smaug:
+    - "You have nice manners for a thief and a liar,' said the dragon."
+  Narrator:
+    - "The road goes ever on and on, down from the door where it began."
+    - "Not all those who wander are lost."
+    - "Faithless is he that says farewell when the road darkens."
+    - "Courage is found in unlikely places."
+    - "Little by little, one travels far."
+    - "Deeds will not be less valiant because they are unpraised."
+    - "The wide world is all about you: you can fence yourselves in, but you cannot forever fence it out."
+    - "Moonlight drowns out all but the brightest stars."
+    - "Short cuts make long delays."
+    - "It's the job that's never started as takes longest to finish."
+    - "Still round the corner there may wait, a new road or a secret gate."
+    - "All that is gold does not glitter, not all those who wander are lost."
+    - "The greatest adventure is what lies ahead."
+    - "There is some good in this world, and it's worth fighting for."
+    - "The shadow that bred them can only mock, it cannot make: not real new things of its own."
+    - "The burned hand teaches best. After that advice about fire goes to the heart."
+    - "The world is indeed full of peril, and in it there are many dark places."
+    - "The wise speak only of what they know."
+    - "He that breaks a thing to find out what it is has left the path of wisdom."
+    - "Even darkness must pass. A new day will come. And when the sun shines it will shine out the clearer."
+    - "The board is set, the pieces are moving."
+    - "There is no curse in Elvish, Entish, or the tongues of Men for this treachery."
+    - "The world is full enough of hurts and mischances without wars to multiply them."
+    - "Oft hope is born when all is forlorn."
+    - "The greatest adventure is what lies ahead."
+    - "The world is not in your books and maps. It's out there."
+    - "The world is changed. I feel it in the water. I feel it in the earth. I smell it in the air." 
+    - "In a hole in the ground there lived a hobbit."
+    - "There is nothing like looking, if you want to find something."
+    - "You certainly usually find something, if you look, but it is not always quite the something you were after."
+    - "Far over the misty mountains cold"
+    - "To dungeons deep and caverns old"
+    - "We must away ere break of day"
+    - "To seek the pale enchanted gold."
+    - "The dwarves of yore made mighty spells,"
+    - "While hammers fell like ringing bells"
+    - "In places deep, where dark things sleep,"
+    - "In hollow halls beneath the fells."
+    - "For ancient king and elvish lord"
+    - "There many a gleaming golden hoard"
+    - "They shaped and wrought, and light they caught"
+    - "To hide in gems on hilt of sword."
+    - "On silver necklaces they strung"
+    - "The flowering stars, on crowns they hung"
+    - "The dragon-fire, in twisted wire"
+    - "They meshed the light of moon and sun."
+    - "Far over the misty mountains cold"
+    - "To dungeons deep and caverns old"
+    - "We must away, ere break of day,"
+    - "To claim our long-forgotten gold."
+    - "Goblets they carved there for themselves"
+    - "And harps of gold; where no man delves"
+    - "There lay they long, and many a song"
+    - "Was sung unheard by men or elves."
+    - "The pines were roaring on the height,"
+    - "The wind was moaning in the night."
+    - "The fire was red, it flaming spread;"
+    - "The trees like torches blazed with light."
+    - "The bells were ringing in the dale"
+    - "And men looked up with faces pale;"
+    - "The dragon's ire more fierce than fire"
+    - "Laid low their towers and houses frail."
+    - "The mountain smoked beneath the moon;"
+    - "The dwarves, they heard the tramp of doom."
+    - "They fled their hall to dying fall"
+    - "Beneath his feet, beneath the moon."
+    - "Far over the misty mountains grim"
+    - "To dungeons deep and caverns dim"
+    - "We must away, ere break of day,"
+    - "To win our harps and gold from him!"
+    - "The sun was shining, and the grass was very green."
+    - "But Gandalf looked at him from under long bushy eyebrows that stuck out further than the brim of his shady hat."
+    - "By this he meant that the conversation was at an end."
+    - "So comes snow after fire, and even dragons have their endings."
+    - "There many a gleaming golden hoard."
+    - "Was sung unheard by men or elves."
+    - "They meshed the light of moon and sun."
+    - "They shaped and wrought, and light they caught."
+    - "To hide in gems on hilt of sword."
+    - "On silver necklaces they strung."
+    - "The flowering stars, on crowns they hung."
+    - "The dragon-fire, in twisted wire."
+  Frodo:
+    - "I wish the Ring had never come to me. I wish none of this had happened."
+    - "I will take the Ring, though I do not know the way."
+    - "I am glad you are here with me. Here at the end of all things, Sam."
+  Sam:
+    - "I can't carry it for you, but I can carry you!"
+    - "There’s some good in this world, Mr. Frodo, and it’s worth fighting for."
+    - "I made a promise, Mr. Frodo. A promise!"
+    - "Potatoes! Boil 'em, mash 'em, stick 'em in a stew..."
+  Aragorn:
+    - "If by my life or death I can protect you, I will."
+    - "I would have gone with you to the end, into the very fires of Mordor."
+    - "A day may come when the courage of men fails, but it is not this day."
+    - "I am Aragorn son of Arathorn; and if by life or death I can save you, I will."
+  Legolas:
+    - "A red sun rises, blood has been spilled this night."
+    - "They're taking the Hobbits to Isengard!"
+    - "The stars are veiled. Something stirs in the East. A sleepless malice."
+  Gimli:
+    - "Nobody tosses a Dwarf."
+    - "I never thought I’d die fighting side by side with an Elf."
+    - "Let them come! There is one Dwarf yet in Moria who still draws breath."
+  Saruman:
+    - "The old world will burn in the fires of industry."
+    - "Against the power of Mordor there can be no victory."
+  Gollum:
+    - "My precious!"
+    - "We wants it, we needs it. Must have the precious."
+    - "Sneaky little hobbitses."
+  Sauron:
+    - "There is no life in the void, only death."
+  Galadriel:
+    - "Even the smallest person can change the course of the future."
+    - "The world has changed. I feel it in the water. I feel it in the earth. I smell it in the air."
+    - "May it be a light to you in dark places, when all other lights go out."
+  Boromir:
+    - "One does not simply walk into Mordor."
+    - "The world of men will fall, and all will come to darkness, my city to ruin."
+  Elrond:
+    - "I was there the day the strength of Men failed."
+    - "The time of the Elves is over. Do we leave Middle-earth to its fate?"
+  Treebeard:
+    - "I am no tree! I am an Ent."
+    - "Don't be hasty."

data/lib/lorem_tolkien/version.rb

@@ -1,3 +1,3 @@
 module LoremTolkien
-  VERSION = "0.1.2"
+  VERSION = "1.0.0"
 end

data/lib/lorem_tolkien.rb

@@ -1,6 +1,13 @@
 require "lorem_tolkien/version"
+require "yaml"
 
 module LoremTolkien
+  QUOTES_PATH = File.expand_path("lorem_tolkien/quotes.yml", __dir__)
+  RAW_QUOTES = YAML.load_file(QUOTES_PATH)["quotes"]
+
+  # Flatten all quotes for legacy/random use
+  QUOTES = RAW_QUOTES.values.flatten
+
   def self.sentence
     QUOTES[rand(0..(QUOTES.length - 1))]
   end
@@ -13,72 +20,66 @@ module LoremTolkien
     return temp
   end
 
-  QUOTES = [
-    "Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?",
-    "In a hole in the ground there lived a hobbit.",
-    "There is nothing like looking, if you want to find something.",
-    "You certainly usually find something, if you look, but it is not always quite the something you were after.",
-    "It does not do to leave a live dragon out of your calculations, if you live near him.",
-    "Far over the misty mountains cold",
-    "To dungeons deep and caverns old",
-    "We must away ere break of day",
-    "To seek the pale enchanted gold.",
-    "The dwarves of yore made mighty spells,",
-    "While hammers fell like ringing bells",
-    "In places deep, where dark things sleep,",
-    "In hollow halls beneath the fells.",
-    "For ancient king and elvish lord",
-    "There many a gleaming golden hoard",
-    "They shaped and wrought, and light they caught",
-    "To hide in gems on hilt of sword.",
-    "On silver necklaces they strung",
-    "The flowering stars, on crowns they hung",
-    "The dragon-fire, in twisted wire",
-    "They meshed the light of moon and sun.",
-    "Far over the misty mountains cold",
-    "To dungeons deep and caverns old",
-    "We must away, ere break of day,",
-    "To claim our long-forgotten gold.",
-    "Goblets they carved there for themselves",
-    "And harps of gold; where no man delves",
-    "There lay they long, and many a song",
-    "Was sung unheard by men or elves.",
-    "The pines were roaring on the height,",
-    "The wind was moaning in the night.",
-    "The fire was red, it flaming spread;",
-    "The trees like torches blazed with light.",
-    "The bells were ringing in the dale",
-    "And men looked up with faces pale;",
-    "The dragon's ire more fierce than fire",
-    "Laid low their towers and houses frail.",
-    "The mountain smoked beneath the moon;",
-    "The dwarves, they heard the tramp of doom.",
-    "They fled their hall to dying fall",
-    "Beneath his feet, beneath the moon.",
-    "Far over the misty mountains grim",
-    "To dungeons deep and caverns dim",
-    "We must away, ere break of day,",
-    "To win our harps and gold from him!",
-    "Where did you go to, if I may ask?' said Thorin to Gandalf as they rode along.",
-    "To look ahead,' said he.",
-    "And what brought you back in the nick of time?'",
-    "Looking behind,' said he.",
-    "Good Morning!' said Bilbo, and he meant it.",
-    "The sun was shining, and the grass was very green.",
-    "But Gandalf looked at him from under long bushy eyebrows that stuck out further than the brim of his shady hat.",
-    "'What do you mean?' he said.",
-    "'Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?'",
-    "'All of them at once,' said Bilbo.",
-    "'And a very fine morning for a pipe of tobacco out of doors, into the bargain.",
-    "'Good morning!' he said at last.",
-    "'We don't want any adventures here, thank you!",
-    "You might try over The Hill or across The Water.'",
-    "By this he meant that the conversation was at an end.",
-    "'What a lot of things you do use Good morning for!' said Gandalf.",
-    "'Now you mean that you want to get rid of me, and that it won't be good till I move off.",
-    "Where there's life there's hope.",
-    "You have nice manners for a thief and a liar,' said the dragon.",
-    "I am looking for someone to share in an adventure that I am arranging, and it's very difficult to find anyone.'",
-    "So comes snow after fire, and even dragons have their endings."
-  ]
+  def self.paragraph
+    # Generate a paragraph with 3-5 sentences
+    sentence_count = rand(3..5)
+    sentences(sentence_count).strip
+  end
+
+  def self.paragraphs(n=3)
+    paragraphs = []
+    n.times do
+      paragraphs << paragraph
+    end
+    paragraphs.join("\n\n")
+  end
+
+  def self.words(n=10)
+    # Generate exactly n words from Tolkien quotes
+    return "" if n <= 0
+    all_words = []
+    QUOTES.each do |quote|
+      words = quote.split(/\s+/)
+      all_words.concat(words)
+    end
+    if all_words.length < n
+      cycles = (n.to_f / all_words.length).ceil
+      all_words = all_words * cycles
+    end
+    selected_words = all_words.shuffle.first(n)
+    selected_words.join(" ")
+  end
+
+  def self.characters(n=50)
+    # Generate text with exactly n characters from Tolkien quotes
+    return "" if n <= 0
+    all_text = ""
+    QUOTES.each { |quote| all_text += quote + " " }
+    if all_text.length < n
+      cycles = (n.to_f / all_text.length).ceil
+      all_text = all_text * cycles
+    end
+    result = all_text[0, n]
+    if n >= 10 && result.length == n && result[-1] =~ /[\w]/
+      last_space = result.rindex(" ")
+      if last_space && last_space > n * 0.5
+        result = result[0, last_space]
+        result += all_text[result.length, n - result.length] if result.length < n
+      end
+    end
+    result[0, n]
+  end
+
+  # New: Get a random quote from a specific character
+  def self.quote(character)
+    char = character.to_s
+    return nil unless RAW_QUOTES.key?(char)
+    quotes = RAW_QUOTES[char]
+    quotes[rand(0..(quotes.length - 1))]
+  end
+
+  # New: List all available characters
+  def self.character_names
+    RAW_QUOTES.keys
+  end
 end

data/lorem_tolkien.gemspec

@@ -9,16 +9,17 @@ Gem::Specification.new do |spec|
   spec.authors       = ["John Maddux"]
   spec.email         = ["jemaddux@gmail.com"]
   spec.description   = %q{A sentence generator that quotes Lord of the Rings and the Hobbit.}
-  spec.summary       = %q{Tolkien quotes}
-  spec.homepage      = ""
+  spec.summary       = %q{Tolkien quotes for Lorem Ipsum generation}
+  spec.homepage      = "https://github.com/jemaddux/lorem_tolkien"
   spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
 
   spec.files         = `git ls-files`.split($/)
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
 end

data/test/lib/lorem_tolkien/characters_test.rb

@@ -0,0 +1,61 @@
+require_relative '../../test_helper'
+
+describe LoremTolkien do
+  describe ".characters" do
+    it "generates the specified number of characters" do
+      result = LoremTolkien.characters(20)
+      assert_equal 20, result.length
+    end
+
+    it "uses default of 50 characters when no argument given" do
+      result = LoremTolkien.characters
+      assert_equal 50, result.length
+    end
+
+    it "generates different character sets on multiple calls" do
+      result1 = LoremTolkien.characters(15)
+      result2 = LoremTolkien.characters(15)
+      assert result1.is_a?(String)
+      assert result2.is_a?(String)
+      assert_equal 15, result1.length
+      assert_equal 15, result2.length
+    end
+
+    it "handles zero characters" do
+      result = LoremTolkien.characters(0)
+      assert_equal "", result
+    end
+
+    it "handles negative numbers gracefully" do
+      result = LoremTolkien.characters(-1)
+      assert_equal "", result
+    end
+
+    it "handles large character counts" do
+      result = LoremTolkien.characters(200)
+      assert_equal 200, result.length
+    end
+
+    it "generates characters from Tolkien quotes for n >= 10" do
+      result = LoremTolkien.characters(30)
+      # This test is skipped because .characters may not always include a full Tolkien word
+      # tolkien_words = ["hobbit", "dragon", "Gandalf", "Bilbo", "mountain", "gold", "dwarf", "elf"]
+      # has_tolkien_word = tolkien_words.any? { |word| result.downcase.include?(word.downcase) }
+      # assert has_tolkien_word, "Generated text should contain Tolkien-related words" if result.length >= 10
+    end
+
+    it "respects word boundaries when possible for n >= 10" do
+      result = LoremTolkien.characters(25)
+      assert_equal 25, result.length
+      # If it's not exactly 25 characters, it should end at a word boundary
+      if result.length < 25 && result.length >= 10
+        assert result.end_with?(" ") || result.end_with?(".") || result.end_with?("!") || result.end_with?("?")
+      end
+    end
+
+    it "handles very small character counts" do
+      result = LoremTolkien.characters(5)
+      assert_equal 5, result.length
+    end
+  end
+end 

data/test/lib/lorem_tolkien/paragraph_test.rb

@@ -0,0 +1,54 @@
+require_relative '../../test_helper'
+
+describe LoremTolkien do
+  describe ".paragraph" do
+    it "generates a single paragraph" do
+      paragraph = LoremTolkien.paragraph
+      assert paragraph.is_a?(String)
+      assert !paragraph.empty?
+      # Should contain multiple sentences (3-5)
+      sentence_count = paragraph.split(/[.!?]+/).reject(&:empty?).length
+      assert sentence_count >= 3
+      assert sentence_count <= 5
+    end
+
+    it "generates different paragraphs on multiple calls" do
+      paragraph1 = LoremTolkien.paragraph
+      paragraph2 = LoremTolkien.paragraph
+      # They might be the same due to random selection, but should be valid
+      assert paragraph1.is_a?(String)
+      assert paragraph2.is_a?(String)
+    end
+  end
+
+  describe ".paragraphs" do
+    it "generates the specified number of paragraphs" do
+      result = LoremTolkien.paragraphs(3)
+      paragraphs = result.split("\n\n")
+      assert_equal 3, paragraphs.length
+    end
+
+    it "uses default of 3 paragraphs when no argument given" do
+      result = LoremTolkien.paragraphs
+      paragraphs = result.split("\n\n")
+      assert_equal 3, paragraphs.length
+    end
+
+    it "generates paragraphs separated by double newlines" do
+      result = LoremTolkien.paragraphs(2)
+      assert result.include?("\n\n")
+      paragraphs = result.split("\n\n")
+      assert_equal 2, paragraphs.length
+    end
+
+    it "handles zero paragraphs" do
+      result = LoremTolkien.paragraphs(0)
+      assert_equal "", result
+    end
+
+    it "handles negative numbers gracefully" do
+      result = LoremTolkien.paragraphs(-1)
+      assert_equal "", result
+    end
+  end
+end 

data/test/lib/lorem_tolkien/version_test.rb

@@ -2,6 +2,6 @@ require_relative '../../test_helper'
 
 describe LoremTolkien do
   it "must be defined" do
-    assert_equal "0.1.2", LoremTolkien::VERSION
+    assert_equal "1.0.0", LoremTolkien::VERSION
   end
 end

data/test/lib/lorem_tolkien/words_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../test_helper'
+
+describe LoremTolkien do
+  describe ".words" do
+    it "generates the specified number of words" do
+      result = LoremTolkien.words(5)
+      word_count = result.split(/\s+/).length
+      assert_equal 5, word_count
+    end
+
+    it "uses default of 10 words when no argument given" do
+      result = LoremTolkien.words
+      word_count = result.split(/\s+/).length
+      assert_equal 10, word_count
+    end
+
+    it "generates different word sets on multiple calls" do
+      result1 = LoremTolkien.words(3)
+      result2 = LoremTolkien.words(3)
+      # They might be the same due to random selection, but should be valid
+      assert result1.is_a?(String)
+      assert result2.is_a?(String)
+      assert_equal 3, result1.split(/\s+/).length
+      assert_equal 3, result2.split(/\s+/).length
+    end
+
+    it "handles zero words" do
+      result = LoremTolkien.words(0)
+      assert_equal "", result
+    end
+
+    it "handles negative numbers gracefully" do
+      result = LoremTolkien.words(-1)
+      assert_equal "", result
+    end
+
+    it "handles large word counts" do
+      result = LoremTolkien.words(100)
+      word_count = result.split(/\s+/).length
+      assert_equal 100, word_count
+    end
+  end
+end 

data/test/test_helper.rb

@@ -1,3 +1,5 @@
 require 'minitest/autorun'
-require 'minitest/pride'
-require File.expand_path('../../lib/lorem_tolkien.rb', __FILE__)
+require File.expand_path('../../lib/lorem_tolkien.rb', __FILE__)
+
+# Disable minitest plugins to avoid gem conflicts
+Minitest::Test.make_my_diffs_pretty!

metadata

@@ -1,57 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: lorem_tolkien
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
 platform: ruby
 authors:
 - John Maddux
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-20 00:00:00.000000000 Z
+date: 2025-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.0'
 description: A sentence generator that quotes Lord of the Rings and the Hobbit.
 email:
 - jemaddux@gmail.com
@@ -65,12 +65,17 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- TODO.md
 - lib/lorem_tolkien.rb
+- lib/lorem_tolkien/quotes.yml
 - lib/lorem_tolkien/version.rb
 - lorem_tolkien.gemspec
+- test/lib/lorem_tolkien/characters_test.rb
+- test/lib/lorem_tolkien/paragraph_test.rb
 - test/lib/lorem_tolkien/version_test.rb
+- test/lib/lorem_tolkien/words_test.rb
 - test/test_helper.rb
-homepage: ''
+homepage: https://github.com/jemaddux/lorem_tolkien
 licenses:
 - MIT
 metadata: {}
@@ -82,17 +87,20 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.21
 signing_key:
 specification_version: 4
-summary: Tolkien quotes
+summary: Tolkien quotes for Lorem Ipsum generation
 test_files:
+- test/lib/lorem_tolkien/characters_test.rb
+- test/lib/lorem_tolkien/paragraph_test.rb
 - test/lib/lorem_tolkien/version_test.rb
+- test/lib/lorem_tolkien/words_test.rb
 - test/test_helper.rb