https://github.com/vinodnimbalkar/dinvishesh
ЁЯЧУя╕П A simple NPM package that returns Marathi dinvishesh.
https://github.com/vinodnimbalkar/dinvishesh
dinvishesh javascript marathi nodejs npm-package returns-dinvishesh
Last synced: 10 months ago
JSON representation
ЁЯЧУя╕П A simple NPM package that returns Marathi dinvishesh.
- Host: GitHub
- URL: https://github.com/vinodnimbalkar/dinvishesh
- Owner: vinodnimbalkar
- License: mit
- Created: 2019-10-17T13:05:51.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-10T15:02:51.000Z (over 1 year ago)
- Last Synced: 2025-08-11T17:23:45.047Z (10 months ago)
- Topics: dinvishesh, javascript, marathi, nodejs, npm-package, returns-dinvishesh
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/dinvishesh
- Size: 2.4 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DinVishesh
[](https://travis-ci.org/vinodnimbalkar/dinvishesh)
[](https://coveralls.io/github/vinodnimbalkar/dinvishesh?branch=master)
A Node.js package that provides "On This Day in History" (dinvishesh) information in Marathi. Get historical events, births, and deaths for any date to enhance your knowledge of Indian history and culture.
## Features
- Get historical data for any specific date
- Three categories of information:
- **Janm** (Births) - Notable personalities born on a date
- **Mrutyu** (Deaths) - Notable personalities who passed away on a date
- **Ghatana** (Events) - Significant historical events that occurred on a date
- Flexible API with multiple ways to query data
- Data available in Marathi language
- Zero dependencies
## Installation
```bash
npm install dinvishesh
```
## API Reference
### 1. dinVisheshToday()
Returns historical information for the current date.
```javascript
const dinvishesh = require('dinvishesh');
const today = dinvishesh.dinVisheshToday();
```
Example response:
```javascript
{
"janm": [
"резреореорез: рд╕реНрдкреЕрдирд┐рд╢ рдЪрд┐рддреНрд░рдХрд╛рд░ рдЖрдгрд┐ рд╢рд┐рд▓реНрдкрдХрд╛рд░ рдкрд╛рдмреНрд▓реЛ рдкрд┐рдХрд╛рд╕реЛ рдпрд╛рдВрдЪрд╛ рдЬрдиреНрдо.",
"резрепрейрен: рд╕рдВрдЧреАрдд рд╕рдореАрдХреНрд╖рдХ рдбреЙ. рдЕрд╢реЛрдХ рд░рд╛рдирдбреЗ рдпрд╛рдВрдЪрд╛ рдЬрдиреНрдо."
],
"mrutyu": [...],
"ghatana": [...]
}
```
### 2. dinVishesh(category, month, day)
Retrieve historical information for a specific date and category.
**Parameters:**
- `category` (optional): 'janm', 'mrutyu', or 'ghatana' (default: 'janm')
- `month` (optional): Month name in lowercase English (e.g., 'january')
- `day` (optional): Day of month as string (e.g., '25')
```javascript
const births = dinvishesh.dinVishesh('janm', 'january', '11');
```
### 3. dinVisheshByCategory(category)
Get all entries for a specific category organized by month.
**Parameters:**
- `category`: 'janm', 'mrutyu', or 'ghatana'
```javascript
const allBirths = dinvishesh.dinVisheshByCategory('janm');
```
### 4. dinVisheshAll()
Retrieve the complete database of historical information.
```javascript
const completeData = dinvishesh.dinVisheshAll();
```
## Usage Examples
```javascript
const dinvishesh = require('dinvishesh');
// Get today's historical events
const today = dinvishesh.dinVisheshToday();
console.log('Today in history:', today.ghatana);
// Get births on a specific date
const births = dinvishesh.dinVishesh('janm', 'january', '11');
console.log('Born on January 11:', births);
// Get all deaths by month
const deaths = dinvishesh.dinVisheshByCategory('mrutyu');
console.log('Deaths in January:', deaths.january);
```
For more examples, check the `examples` directory in the repository:
```bash
git clone https://github.com/vinodnimbalkar/dinvishesh.git
cd dinvishesh/example
npm install
node demo.js
```
## Contributing
Contributions are welcome! Here's how you can help:
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
Please ensure your PR includes appropriate tests and documentation updates.
## Support the Project
If you find this package useful, consider supporting the development:
## License
MIT ┬й [Vinod Nimbalkar](https://github.com/vinodnimbalkar/dinvishesh/blob/master/LICENSE)