quotes-cli
v1.2.4
Published
Generates random quotes
Downloads
395
Maintainers
Readme
📚 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! 💝
- 🍴 Fork the repository
- 🌿 Create your feature branch
- 💫 Make your changes
- 🚀 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