📚 quotes-cli

Your daily dose of wisdom and inspiration, right from the terminal 🌟

Installation • Features • Usage • Documentation • Contributing

✨ Features

| Feature | Description | | -------------------- | ------------------------------------- | | 🎲 Random Quotes | Get instant wisdom with random quotes | | 🏷️ Tagged Quotes | Find quotes by specific categories | | 🔍 Smart Search | Search by author or book titles | | 📚 Bulk Fetch | Get multiple quotes at once | | 🎯 Filtered Bulk | Get multiple quotes by tag or search |

🚀 Installation

• Node.js installed on your system
• npm or yarn package manager
• Active internet connection

# Using npm
npm install -g quotes-cli

📖 Usage

🎯 Available Commands

💫 Command Examples

Get a Random Quote

$ quotes-cli quote

┌─────────────────────────────────────────────────────┐
│  "Be yourself; everyone else is already taken."     │
│                               - Oscar Wilde         │
└─────────────────────────────────────────────────────┘

Get Multiple Quotes by Tag

$ quotes-cli bulk-tag humor 3

╔════════════════════════════════════════════════════╗
║ "Laughter is timeless, imagination has no age,     ║
║  and dreams are forever."                          ║
║                               - Walt Disney        ║
╚════════════════════════════════════════════════════╝

╔════════════════════════════════════════════════════╗
║ "A day without laughter is a day wasted."          ║
║                               - Charlie Chaplin    ║
╚════════════════════════════════════════════════════╝

╔════════════════════════════════════════════════════╗
║ "Life is short. Smile while you still have teeth." ║
║                               - Unknown            ║
╚════════════════════════════════════════════════════╝

🏷️ Available Tags

| Category 1 | Category 2 | Category 3 | Category 4 | | -------------- | ------------ | ------------- | ------------- | | 💝 love | 🌟 life | 💡 wisdom | 🎭 poetry | | ✨ inspiration | 😄 humor | 🤔 philosophy | 💑 romance | | ⛪ religion | 🎯 success | 📚 knowledge | 🤝 friendship | | 🎨 motivation | 😊 happiness | 🌈 hope | ✌️ peace |

🛠️ Technical Notes

Usage: quotes-cli [options] [command]

Options:
  -V, --version              output the version number
  -h, --help                 output usage information

Commands:
  quote | q                  Get a random quote
  tag | t <name>             Get a random quote from a tag
  search | s <query>         Get a random quote from an author or book
  bulk | b <number>          Get multiple random quotes (max 10)
  bulk-tag | bt <name> <number>
                            Get multiple quotes from a tag (max 10)
  bulk-search | bs <query> <number>
                            Get multiple quotes from a search query (max 10)

• Maximum 10 quotes per bulk request (applies to bulk, bulk-tag, and bulk-search)
• Requires active internet connection
• Real-time Goodreads scraping
• Random page selection for variety

👥 Contributing

We love contributions! 💝

1. 🍴 Fork the repository
2. 🌿 Create your feature branch
3. 💫 Make your changes
4. 🚀 Submit a pull request

⚖️ Legal

This tool scrapes data from Goodreads for personal use. Please comply with Goodreads' Terms of Service.

📜 License

Copyright © 2024 anilpdv

Made with ❤️ by Anil Palli

⬆ back to top