| Name | mr-studydev JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | https://github.com/the-ai-developer/mr.studydev |
| Summary | 🎯 Ultimate Student & Developer Productivity CLI Tool with Pomodoro, Projects & Study Materials |
| upload_time | 2025-09-16 19:42:25 |
| maintainer | None |
| docs_url | None |
| author | PrinceTheProgrammer |
| requires_python | >=3.8 |
| license | MIT License
Copyright (c) 2025 PrinceTheProgrammer
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE. |
| keywords |
productivity
pomodoro
cli
study
project-management
flashcards
terminal
developer-tools
student-tools
time-management
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
click
rich
typer
json5
pyyaml
python-dateutil
arrow
tqdm
matplotlib
plotext
GitPython
configparser
python-dotenv
colorama
tabulate
prompt-toolkit
pytest
pytest-cov
black
flake8
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🎯 StudyDev - Ultimate Student & Developer Productivity CLI Tool
[](https://python.org/downloads/)
[](LICENSE)
[](https://github.com/yourusername/studydev)
> *Supercharge your productivity with the most comprehensive study and development CLI tool ever created!*
**StudyDev** combines the power of Pomodoro sessions, project organization, and intelligent study material management into one beautiful, feature-rich command-line interface. Built with love for students, developers, and lifelong learners who want to optimize their productivity workflow.
## ✨ Features
### 🍅 **Advanced Pomodoro Session Manager**
- **Interactive Timer**: Beautiful real-time progress display with motivational messages
- **Smart Pause/Resume**: Full session control with keyboard interrupt handling
- **Productivity Ratings**: Rate and track your session effectiveness (1-5 scale)
- **Achievement System**: Unlock achievements for consistency and milestones
- **Session Analytics**: Detailed statistics, streaks, and productivity insights
- **Subject Tracking**: Link sessions to specific subjects or projects
### 📋 **Intelligent Project Organizer**
- **Template System**: Pre-built templates for Python, JavaScript, Research, Thesis, etc.
- **Git Integration**: Automatic repository initialization and .gitignore setup
- **Deadline Management**: Visual urgency indicators and overdue tracking
- **Progress Tracking**: Monitor project completion and milestones
- **Custom Templates**: Create and share your own project templates
- **Smart Filtering**: Sort and filter projects by status, deadline, or type
### 📚 **Smart Study Material Aggregator**
- **Bookmark Management**: Auto-fetch metadata, tags, and subject classification
- **Spaced Repetition Flashcards**: SRS algorithm for optimal memory retention
- **Course Progress Tracking**: Monitor online course completion and learning goals
- **Subject Organization**: Intelligent categorization across all study materials
- **Review Dashboard**: Unified view of due flashcards, unread bookmarks, and active courses
- **Search & Filter**: Powerful filtering by subject, tags, and completion status
### 📊 **Beautiful Analytics & Reports**
- **Productivity Dashboard**: Real-time overview with stunning visual metrics
- **Progress Visualization**: Beautiful gauges, charts, and progress indicators
- **Comprehensive Reports**: Detailed analytics with customizable date ranges
- **Streak Tracking**: Monitor and celebrate study consistency
- **Cross-Module Insights**: Discover patterns between sessions, projects, and materials
- **Export Options**: Generate reports in JSON/CSV for external analysis
### 🎨 **Stunning Interactive UI**
- **Animated Welcome**: Eye-catching ASCII art and smooth animations
- **Rich Terminal Output**: Colors, borders, progress bars, and beautiful tables
- **Interactive Menus**: Guided workflows with intuitive navigation
- **Loading Animations**: Smooth spinners and progress indicators
- **Achievement Celebrations**: Animated unlock notifications for milestones
- **Contextual Help**: Beautiful command reference with examples
### 💾 **Enterprise-Grade Data Management**
- **Automatic Backups**: Comprehensive backup/restore system
- **Data Export**: Multiple formats (JSON, CSV) for data portability
- **Configuration Management**: Flexible settings with easy management
- **SQLite Database**: Reliable local storage with data integrity
- **Multi-Platform**: Works on Linux, macOS, and Windows
## 🚀 Quick Start
### Installation
```bash
# Clone the repository
git clone https://github.com/yourusername/studydev.git
cd studydev
# Create virtual environment
python -m venv studydevenv
source studydevenv/bin/activate # On Windows: studydevenv\Scripts\activate
# Install dependencies
pip install -e .
# Initialize StudyDev (with beautiful welcome animation!)
studydev init
```
### Your First Session
```bash
# Start a 25-minute Pomodoro session
studydev session start --subject "Python Learning"
# View beautiful productivity dashboard
studydev status
# Get comprehensive help
studydev help
```
## 📖 Usage Guide
### Session Management
```bash
# Start a study session
studydev session start # 25-minute default
studydev session start --subject "Math" # With subject
studydev session start --project-id 1 # Link to project
# Control active session
studydev session pause # Pause timer
studydev session resume # Resume paused session
studydev session stop --rating 5 # Stop and rate (1-5)
# View analytics
studydev session stats # Overall statistics
studydev session stats --days 7 # Last week
studydev session history --limit 10 # Recent sessions
```
### Project Organization
```bash
# Create projects
studydev project create "My Web App" # Basic project
studydev project create "Research Paper" --template research # From template
studydev project create "ML Project" --description "Deep learning model"
# Manage projects
studydev project list # All projects
studydev project list --status active # Filter by status
studydev project show 1 # Project details
studydev project update 1 --status completed --deadline "2024-03-01"
# Templates
studydev project template list # Available templates
studydev project template create custom # Create custom template
```
### Study Materials
```bash
# Bookmarks
studydev study bookmark add "https://python.org" --subject "Python" --tags "docs,reference"
studydev study bookmark list --subject Python # Filter by subject
studydev study bookmark list --unread # Unread only
# Flashcards with spaced repetition
studydev study flashcard add --subject "Spanish" # Interactive creation
studydev study flashcard review # Review due cards
studydev study flashcard review --subject "Math" --limit 10
studydev study flashcard stats # Learning progress
# Course tracking
studydev study course add "Machine Learning Course" --url "coursera.org/ml" --total-lessons 50
studydev study course update 1 --progress 75 # Update completion
studydev study course list # All courses
# Unified review
studydev study review # All due materials
studydev study review --subject "Computer Science" --limit 20
```
### Analytics & Reports
```bash
# Real-time dashboard
studydev status # Beautiful productivity overview
studydev dashboard # Detailed current metrics
# Comprehensive reports
studydev report # Last 30 days
studydev report --days 7 # Custom period
studydev report --output report.json # Save to file
```
### Data Management
```bash
# Backup & restore
studydev backup # Create timestamped backup
studydev backup --path ~/backups # Custom location
studydev restore ~/backups/studydev_backup_20240101_120000
# Export data
studydev export --format json # Export all data
studydev export --format csv --data-type sessions # Specific data
studydev export --output my_data.json # Custom filename
# Configuration
studydev config show # View all settings
studydev config set session.default_duration 30 # Update setting
studydev config reset # Reset to defaults
```
## 🎨 Screenshots & Examples
### Beautiful Dashboard
```
╭─────────────────────────── 🎯 Productivity Meter ────────────────────────────╮
│ 🚀 PRODUCTIVITY LEVEL: EXCELLENT │
│ │
│ ████████████████████████░░░░░░░░░ 78.2% │
│ Score: 3.9/5.0 │
╰───────────────────────────────────────────────────────────────────────────────╯
```
### Interactive Timer
```
╭──────────────────── StudyDev Timer - Study ─────────────────────╮
│ 🍅 Study Session │
│ 📚 Machine Learning │
│ │
│ ⏰ 15:42 │
│ │
│ ██████████████████░░░░░░░░░░░░░ 62.1% │
│ │
│ 🔥 Great progress! Keep going! │
╰──────────────────────────────────────────────────────────────────╯
```
### Project Overview
```
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Projects ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ID │ Name │ Status │ Deadline │ Urgency │ Progress ┃
┡━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━┩
│ 1 │ Web Portfolio │ active │ 2024-02-15 │ 🟡 Soon │ ██████░░ │
│ 2 │ Research Paper │ active │ 2024-01-30 │ 🔴 Due! │ ████░░░░ │
│ 3 │ ML Course Project │ planning │ 2024-03-01 │ 🟢 Safe │ ██░░░░░░ │
└────┴───────────────────┴───────────┴────────────┴─────────┴──────────┘
```
## 🛠️ Advanced Features
### Interactive Mode
StudyDev provides guided interactive experiences:
```bash
studydev quickstart # Interactive quick start guide
studydev init # Animated welcome with setup
```
### Productivity Insights
- **Streak Tracking**: Monitor consecutive study days
- **Subject Effectiveness**: Analyze which subjects have highest productivity ratings
- **Project Productivity**: See which projects get most study time
- **Time Distribution**: Understand how you spend your learning time
- **Achievement System**: Unlock motivational milestones
### Spaced Repetition Algorithm
StudyDev uses a sophisticated SRS algorithm for flashcards:
- **Difficulty Adjustment**: Cards adjust based on your performance
- **Optimal Intervals**: Science-based scheduling for maximum retention
- **Performance Tracking**: Monitor learning progress over time
- **Smart Prioritization**: Focus on cards that need the most attention
## 🧪 Testing
StudyDev includes comprehensive testing:
```bash
# Run all tests
pytest
# Run with coverage
pytest --cov=studydev
# Run specific test modules
pytest tests/test_session.py
pytest tests/test_projects.py
pytest tests/test_study.py
```
## 🤝 Contributing
We welcome contributions! Here's how to get started:
1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request
### Development Setup
```bash
git clone https://github.com/yourusername/studydev.git
cd studydev
# Install development dependencies
pip install -e ".[dev]"
# Run linting and formatting
black studydev/
flake8 studydev/
# Run tests
pytest --cov=studydev
```
## 📝 Configuration
StudyDev stores configuration in `~/.studydev/config.json`. Key settings:
```json
{
"session": {
"default_duration": 25,
"notification_sound": true,
"auto_break": false
},
"study": {
"spaced_repetition_algorithm": "sm2",
"review_batch_size": 20
},
"ui": {
"color_scheme": "default",
"animation_speed": "normal"
}
}
```
## 📊 Data Storage
- **Database**: SQLite database at `~/.studydev/data/studydev.db`
- **Backups**: Stored in `~/.studydev/data/backups/`
- **Templates**: Custom templates in `~/.studydev/data/templates/`
- **Config**: Configuration at `~/.studydev/config.json`
## 🐛 Troubleshooting
### Common Issues
**Installation Problems**
```bash
# Ensure Python 3.8+
python --version
# Create fresh virtual environment
python -m venv fresh_env
source fresh_env/bin/activate
pip install --upgrade pip
pip install -e .
```
**Database Issues**
```bash
# Reset database
rm ~/.studydev/data/studydev.db
studydev init
```
**Permission Errors**
```bash
# Fix permissions
chmod -R 755 ~/.studydev/
```
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🌟 Acknowledgments
- **Rich Library**: For beautiful terminal output
- **Typer**: For the elegant CLI framework
- **SQLite**: For reliable local data storage
- **Community**: For feedback and contributions
## 🔗 Links
- **Documentation**: [Full Documentation](https://studydev.readthedocs.io)
- **Issues**: [Report Bugs](https://github.com/yourusername/studydev/issues)
- **Discussions**: [Feature Requests](https://github.com/yourusername/studydev/discussions)
- **Changelog**: [Release Notes](CHANGELOG.md)
---
<div align="center">
**Made with ❤️ by [PrinceTheProgrammer](https://github.com/PrinceTheProgrammer)**
*Happy learning and coding! 🚀*
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/the-ai-developer/mr.studydev",
"name": "mr-studydev",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "productivity, pomodoro, cli, study, project-management, flashcards, terminal, developer-tools, student-tools, time-management",
"author": "PrinceTheProgrammer",
"author_email": "PrinceTheProgrammer <princetheprogrammer@example.com>",
"download_url": "https://files.pythonhosted.org/packages/59/f5/7ed7c39d1262e8f2dac4a1a3c19ed7a8bbac48e52d67af7fba90c8bcd2d3/mr_studydev-1.0.0.tar.gz",
"platform": null,
"description": "# \ud83c\udfaf StudyDev - Ultimate Student & Developer Productivity CLI Tool\n\n[](https://python.org/downloads/)\n[](LICENSE)\n[](https://github.com/yourusername/studydev)\n\n> *Supercharge your productivity with the most comprehensive study and development CLI tool ever created!*\n\n**StudyDev** combines the power of Pomodoro sessions, project organization, and intelligent study material management into one beautiful, feature-rich command-line interface. Built with love for students, developers, and lifelong learners who want to optimize their productivity workflow.\n\n## \u2728 Features\n\n### \ud83c\udf45 **Advanced Pomodoro Session Manager**\n- **Interactive Timer**: Beautiful real-time progress display with motivational messages\n- **Smart Pause/Resume**: Full session control with keyboard interrupt handling\n- **Productivity Ratings**: Rate and track your session effectiveness (1-5 scale)\n- **Achievement System**: Unlock achievements for consistency and milestones\n- **Session Analytics**: Detailed statistics, streaks, and productivity insights\n- **Subject Tracking**: Link sessions to specific subjects or projects\n\n### \ud83d\udccb **Intelligent Project Organizer** \n- **Template System**: Pre-built templates for Python, JavaScript, Research, Thesis, etc.\n- **Git Integration**: Automatic repository initialization and .gitignore setup\n- **Deadline Management**: Visual urgency indicators and overdue tracking\n- **Progress Tracking**: Monitor project completion and milestones\n- **Custom Templates**: Create and share your own project templates\n- **Smart Filtering**: Sort and filter projects by status, deadline, or type\n\n### \ud83d\udcda **Smart Study Material Aggregator**\n- **Bookmark Management**: Auto-fetch metadata, tags, and subject classification\n- **Spaced Repetition Flashcards**: SRS algorithm for optimal memory retention\n- **Course Progress Tracking**: Monitor online course completion and learning goals\n- **Subject Organization**: Intelligent categorization across all study materials\n- **Review Dashboard**: Unified view of due flashcards, unread bookmarks, and active courses\n- **Search & Filter**: Powerful filtering by subject, tags, and completion status\n\n### \ud83d\udcca **Beautiful Analytics & Reports**\n- **Productivity Dashboard**: Real-time overview with stunning visual metrics\n- **Progress Visualization**: Beautiful gauges, charts, and progress indicators\n- **Comprehensive Reports**: Detailed analytics with customizable date ranges\n- **Streak Tracking**: Monitor and celebrate study consistency\n- **Cross-Module Insights**: Discover patterns between sessions, projects, and materials\n- **Export Options**: Generate reports in JSON/CSV for external analysis\n\n### \ud83c\udfa8 **Stunning Interactive UI**\n- **Animated Welcome**: Eye-catching ASCII art and smooth animations\n- **Rich Terminal Output**: Colors, borders, progress bars, and beautiful tables\n- **Interactive Menus**: Guided workflows with intuitive navigation\n- **Loading Animations**: Smooth spinners and progress indicators\n- **Achievement Celebrations**: Animated unlock notifications for milestones\n- **Contextual Help**: Beautiful command reference with examples\n\n### \ud83d\udcbe **Enterprise-Grade Data Management**\n- **Automatic Backups**: Comprehensive backup/restore system\n- **Data Export**: Multiple formats (JSON, CSV) for data portability\n- **Configuration Management**: Flexible settings with easy management\n- **SQLite Database**: Reliable local storage with data integrity\n- **Multi-Platform**: Works on Linux, macOS, and Windows\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/studydev.git\ncd studydev\n\n# Create virtual environment\npython -m venv studydevenv\nsource studydevenv/bin/activate # On Windows: studydevenv\\Scripts\\activate\n\n# Install dependencies\npip install -e .\n\n# Initialize StudyDev (with beautiful welcome animation!)\nstudydev init\n```\n\n### Your First Session\n\n```bash\n# Start a 25-minute Pomodoro session\nstudydev session start --subject \"Python Learning\"\n\n# View beautiful productivity dashboard\nstudydev status\n\n# Get comprehensive help\nstudydev help\n```\n\n## \ud83d\udcd6 Usage Guide\n\n### Session Management\n\n```bash\n# Start a study session\nstudydev session start # 25-minute default\nstudydev session start --subject \"Math\" # With subject\nstudydev session start --project-id 1 # Link to project\n\n# Control active session\nstudydev session pause # Pause timer\nstudydev session resume # Resume paused session\nstudydev session stop --rating 5 # Stop and rate (1-5)\n\n# View analytics\nstudydev session stats # Overall statistics\nstudydev session stats --days 7 # Last week\nstudydev session history --limit 10 # Recent sessions\n```\n\n### Project Organization\n\n```bash\n# Create projects\nstudydev project create \"My Web App\" # Basic project\nstudydev project create \"Research Paper\" --template research # From template\nstudydev project create \"ML Project\" --description \"Deep learning model\"\n\n# Manage projects\nstudydev project list # All projects\nstudydev project list --status active # Filter by status\nstudydev project show 1 # Project details\nstudydev project update 1 --status completed --deadline \"2024-03-01\"\n\n# Templates\nstudydev project template list # Available templates \nstudydev project template create custom # Create custom template\n```\n\n### Study Materials\n\n```bash\n# Bookmarks\nstudydev study bookmark add \"https://python.org\" --subject \"Python\" --tags \"docs,reference\"\nstudydev study bookmark list --subject Python # Filter by subject\nstudydev study bookmark list --unread # Unread only\n\n# Flashcards with spaced repetition\nstudydev study flashcard add --subject \"Spanish\" # Interactive creation\nstudydev study flashcard review # Review due cards\nstudydev study flashcard review --subject \"Math\" --limit 10\nstudydev study flashcard stats # Learning progress\n\n# Course tracking\nstudydev study course add \"Machine Learning Course\" --url \"coursera.org/ml\" --total-lessons 50\nstudydev study course update 1 --progress 75 # Update completion\nstudydev study course list # All courses\n\n# Unified review\nstudydev study review # All due materials\nstudydev study review --subject \"Computer Science\" --limit 20\n```\n\n### Analytics & Reports\n\n```bash\n# Real-time dashboard\nstudydev status # Beautiful productivity overview\nstudydev dashboard # Detailed current metrics\n\n# Comprehensive reports\nstudydev report # Last 30 days\nstudydev report --days 7 # Custom period\nstudydev report --output report.json # Save to file\n```\n\n### Data Management\n\n```bash\n# Backup & restore\nstudydev backup # Create timestamped backup\nstudydev backup --path ~/backups # Custom location\nstudydev restore ~/backups/studydev_backup_20240101_120000\n\n# Export data\nstudydev export --format json # Export all data\nstudydev export --format csv --data-type sessions # Specific data\nstudydev export --output my_data.json # Custom filename\n\n# Configuration\nstudydev config show # View all settings\nstudydev config set session.default_duration 30 # Update setting\nstudydev config reset # Reset to defaults\n```\n\n## \ud83c\udfa8 Screenshots & Examples\n\n### Beautiful Dashboard\n```\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \ud83c\udfaf Productivity Meter \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 \ud83d\ude80 PRODUCTIVITY LEVEL: EXCELLENT \u2502\n\u2502 \u2502\n\u2502 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591 78.2% \u2502\n\u2502 Score: 3.9/5.0 \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n```\n\n### Interactive Timer\n```\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 StudyDev Timer - Study \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 \ud83c\udf45 Study Session \u2502\n\u2502 \ud83d\udcda Machine Learning \u2502\n\u2502 \u2502\n\u2502 \u23f0 15:42 \u2502\n\u2502 \u2502\n\u2502 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591 62.1% \u2502\n\u2502 \u2502\n\u2502 \ud83d\udd25 Great progress! Keep going! \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n```\n\n### Project Overview\n```\n\u250f\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501 Projects \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2513\n\u2503 ID \u2502 Name \u2502 Status \u2502 Deadline \u2502 Urgency \u2502 Progress \u2503\n\u2521\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2547\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2529\n\u2502 1 \u2502 Web Portfolio \u2502 active \u2502 2024-02-15 \u2502 \ud83d\udfe1 Soon \u2502 \u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591 \u2502\n\u2502 2 \u2502 Research Paper \u2502 active \u2502 2024-01-30 \u2502 \ud83d\udd34 Due! \u2502 \u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591 \u2502\n\u2502 3 \u2502 ML Course Project \u2502 planning \u2502 2024-03-01 \u2502 \ud83d\udfe2 Safe \u2502 \u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n## \ud83d\udee0\ufe0f Advanced Features\n\n### Interactive Mode\n\nStudyDev provides guided interactive experiences:\n\n```bash\nstudydev quickstart # Interactive quick start guide\nstudydev init # Animated welcome with setup\n```\n\n### Productivity Insights\n\n- **Streak Tracking**: Monitor consecutive study days\n- **Subject Effectiveness**: Analyze which subjects have highest productivity ratings\n- **Project Productivity**: See which projects get most study time\n- **Time Distribution**: Understand how you spend your learning time\n- **Achievement System**: Unlock motivational milestones\n\n### Spaced Repetition Algorithm\n\nStudyDev uses a sophisticated SRS algorithm for flashcards:\n\n- **Difficulty Adjustment**: Cards adjust based on your performance\n- **Optimal Intervals**: Science-based scheduling for maximum retention\n- **Performance Tracking**: Monitor learning progress over time\n- **Smart Prioritization**: Focus on cards that need the most attention\n\n## \ud83e\uddea Testing\n\nStudyDev includes comprehensive testing:\n\n```bash\n# Run all tests\npytest\n\n# Run with coverage\npytest --cov=studydev\n\n# Run specific test modules \npytest tests/test_session.py\npytest tests/test_projects.py\npytest tests/test_study.py\n```\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Here's how to get started:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Development Setup\n\n```bash\ngit clone https://github.com/yourusername/studydev.git\ncd studydev\n\n# Install development dependencies\npip install -e \".[dev]\"\n\n# Run linting and formatting\nblack studydev/\nflake8 studydev/\n\n# Run tests\npytest --cov=studydev\n```\n\n## \ud83d\udcdd Configuration\n\nStudyDev stores configuration in `~/.studydev/config.json`. Key settings:\n\n```json\n{\n \"session\": {\n \"default_duration\": 25,\n \"notification_sound\": true,\n \"auto_break\": false\n },\n \"study\": {\n \"spaced_repetition_algorithm\": \"sm2\",\n \"review_batch_size\": 20\n },\n \"ui\": {\n \"color_scheme\": \"default\",\n \"animation_speed\": \"normal\"\n }\n}\n```\n\n## \ud83d\udcca Data Storage\n\n- **Database**: SQLite database at `~/.studydev/data/studydev.db`\n- **Backups**: Stored in `~/.studydev/data/backups/`\n- **Templates**: Custom templates in `~/.studydev/data/templates/`\n- **Config**: Configuration at `~/.studydev/config.json`\n\n## \ud83d\udc1b Troubleshooting\n\n### Common Issues\n\n**Installation Problems**\n```bash\n# Ensure Python 3.8+\npython --version\n\n# Create fresh virtual environment\npython -m venv fresh_env\nsource fresh_env/bin/activate\npip install --upgrade pip\npip install -e .\n```\n\n**Database Issues**\n```bash\n# Reset database\nrm ~/.studydev/data/studydev.db\nstudydev init\n```\n\n**Permission Errors**\n```bash\n# Fix permissions\nchmod -R 755 ~/.studydev/\n```\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83c\udf1f Acknowledgments\n\n- **Rich Library**: For beautiful terminal output\n- **Typer**: For the elegant CLI framework\n- **SQLite**: For reliable local data storage\n- **Community**: For feedback and contributions\n\n## \ud83d\udd17 Links\n\n- **Documentation**: [Full Documentation](https://studydev.readthedocs.io)\n- **Issues**: [Report Bugs](https://github.com/yourusername/studydev/issues)\n- **Discussions**: [Feature Requests](https://github.com/yourusername/studydev/discussions)\n- **Changelog**: [Release Notes](CHANGELOG.md)\n\n---\n\n<div align=\"center\">\n\n**Made with \u2764\ufe0f by [PrinceTheProgrammer](https://github.com/PrinceTheProgrammer)**\n\n*Happy learning and coding! \ud83d\ude80*\n\n</div>\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 PrinceTheProgrammer\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.",
"summary": "\ud83c\udfaf Ultimate Student & Developer Productivity CLI Tool with Pomodoro, Projects & Study Materials",
"version": "1.0.0",
"project_urls": {
"Bug Reports": "https://github.com/the-ai-developer/mr.studydev/issues",
"Documentation": "https://github.com/the-ai-developer/mr.studydev#readme",
"Homepage": "https://github.com/the-ai-developer/mr.studydev",
"Source": "https://github.com/the-ai-developer/mr.studydev"
},
"split_keywords": [
"productivity",
" pomodoro",
" cli",
" study",
" project-management",
" flashcards",
" terminal",
" developer-tools",
" student-tools",
" time-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "81b96128ecdbac367700fd3962493b64bc23e5a1143bb21551a8f64f9f67deb6",
"md5": "3c5369e71d621f903e1924351a070c11",
"sha256": "e17439d493bdfb3ef49290332d85db44f84ebb52d1de9c7caa4363e7f59c065c"
},
"downloads": -1,
"filename": "mr_studydev-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c5369e71d621f903e1924351a070c11",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 58485,
"upload_time": "2025-09-16T19:42:21",
"upload_time_iso_8601": "2025-09-16T19:42:21.305173Z",
"url": "https://files.pythonhosted.org/packages/81/b9/6128ecdbac367700fd3962493b64bc23e5a1143bb21551a8f64f9f67deb6/mr_studydev-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "59f57ed7c39d1262e8f2dac4a1a3c19ed7a8bbac48e52d67af7fba90c8bcd2d3",
"md5": "0915c3c79f9b50ad1ac8ee8093c88a8c",
"sha256": "33a6879773b25735851127ea37b8d415fa929e4e422a8a8308f574dc002ccd20"
},
"downloads": -1,
"filename": "mr_studydev-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "0915c3c79f9b50ad1ac8ee8093c88a8c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 57483,
"upload_time": "2025-09-16T19:42:25",
"upload_time_iso_8601": "2025-09-16T19:42:25.956941Z",
"url": "https://files.pythonhosted.org/packages/59/f5/7ed7c39d1262e8f2dac4a1a3c19ed7a8bbac48e52d67af7fba90c8bcd2d3/mr_studydev-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-16 19:42:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "the-ai-developer",
"github_project": "mr.studydev",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "typer",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "json5",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "pyyaml",
"specs": [
[
">=",
"6.0"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
">=",
"2.8.0"
]
]
},
{
"name": "arrow",
"specs": [
[
">=",
"1.2.0"
]
]
},
{
"name": "tqdm",
"specs": [
[
">=",
"4.65.0"
]
]
},
{
"name": "matplotlib",
"specs": [
[
">=",
"3.7.0"
]
]
},
{
"name": "plotext",
"specs": [
[
">=",
"5.2.0"
]
]
},
{
"name": "GitPython",
"specs": [
[
">=",
"3.1.0"
]
]
},
{
"name": "configparser",
"specs": [
[
">=",
"5.3.0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
">=",
"1.0.0"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
},
{
"name": "tabulate",
"specs": [
[
">=",
"0.9.0"
]
]
},
{
"name": "prompt-toolkit",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.4.0"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
">=",
"4.1.0"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"23.0.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"6.0.0"
]
]
}
],
"lcname": "mr-studydev"
}
