# xztools
A fun and useful Python library with time utilities and random compliments!
## Installation
```bash
pip install xztools
```
## Features
### 🕐 Time Remaining Function
Get a beautiful countdown report showing how many days are left for:
- **Weekend**: Days until the end of Sunday
- **Month**: Days until the end of current month
- **Year**: Days until New Year's Eve
### 💝 Random Compliments
Get random compliments to brighten your day!
## Usage
```python
import xztools
# Get time remaining report
print(xztools.time_remaining())
# Get a random compliment
print(xztools.random_compliment())
```
## Example Output
```
⏰ TIME REMAINING REPORT ⏰
========================================
📅 Today: Wednesday, December 20, 2023
========================================
🎉 Weekend Countdown: 4 days until Sunday
📅 Month Countdown: 11 days until end of December
🎊 Year Countdown: 11 days until New Year!
========================================
You're awesome!
```
## Requirements
- Python 3.6 or higher
## License
MIT License
## Contributing
Feel free to contribute by adding more fun utilities to this package!
Raw data
{
"_id": null,
"home_page": null,
"name": "xztools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "time countdown weekend month year utilities fun",
"author": "Your Name",
"author_email": "your_email@example.com",
"download_url": "https://files.pythonhosted.org/packages/a1/49/cb020fcd6041801aa46eb29cbe75cfc9bf5158d26869ae6373a832011f1c/xztools-0.2.1.tar.gz",
"platform": null,
"description": "# xztools\r\n\r\nA fun and useful Python library with time utilities and random compliments!\r\n\r\n## Installation\r\n\r\n```bash\r\npip install xztools\r\n```\r\n\r\n## Features\r\n\r\n### \ud83d\udd50 Time Remaining Function\r\nGet a beautiful countdown report showing how many days are left for:\r\n- **Weekend**: Days until the end of Sunday\r\n- **Month**: Days until the end of current month \r\n- **Year**: Days until New Year's Eve\r\n\r\n### \ud83d\udc9d Random Compliments\r\nGet random compliments to brighten your day!\r\n\r\n## Usage\r\n\r\n```python\r\nimport xztools\r\n\r\n# Get time remaining report\r\nprint(xztools.time_remaining())\r\n\r\n# Get a random compliment\r\nprint(xztools.random_compliment())\r\n```\r\n\r\n## Example Output\r\n\r\n```\r\n\u23f0 TIME REMAINING REPORT \u23f0\r\n========================================\r\n\r\n\ud83d\udcc5 Today: Wednesday, December 20, 2023\r\n========================================\r\n\r\n\ud83c\udf89 Weekend Countdown: 4 days until Sunday\r\n\ud83d\udcc5 Month Countdown: 11 days until end of December\r\n\ud83c\udf8a Year Countdown: 11 days until New Year!\r\n\r\n========================================\r\n\r\nYou're awesome!\r\n```\r\n\r\n## Requirements\r\n\r\n- Python 3.6 or higher\r\n\r\n## License\r\n\r\nMIT License\r\n\r\n## Contributing\r\n\r\nFeel free to contribute by adding more fun utilities to this package! \r\n",
"bugtrack_url": null,
"license": null,
"summary": "A fun library with time utilities and random compliments!",
"version": "0.2.1",
"project_urls": null,
"split_keywords": [
"time",
"countdown",
"weekend",
"month",
"year",
"utilities",
"fun"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a149cb020fcd6041801aa46eb29cbe75cfc9bf5158d26869ae6373a832011f1c",
"md5": "3b9b7768bec7779596d5665414bd7ca2",
"sha256": "019c6dbc7d7ab1c922b191fb576f6b38f5bc112f831f6b6d218daaf9bb503582"
},
"downloads": -1,
"filename": "xztools-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3b9b7768bec7779596d5665414bd7ca2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 2598,
"upload_time": "2025-08-01T14:51:50",
"upload_time_iso_8601": "2025-08-01T14:51:50.978157Z",
"url": "https://files.pythonhosted.org/packages/a1/49/cb020fcd6041801aa46eb29cbe75cfc9bf5158d26869ae6373a832011f1c/xztools-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 14:51:50",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "xztools"
}