dsap-cli 0.1.0__tar.gz

dsap_cli-0.1.0/.gitignore

@@ -0,0 +1,103 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.local
+.env.*.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# Secrets - NEVER commit these
+.pypirc
+*.pem
+*.key
+secrets.json
+credentials.json
+PyPI-Recovery-Codes.txt
+*-Recovery-Codes.txt
+
+# Development planning files
+plan.md
+docs/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Local development database (user data is in ~/.dsap/)
+*.db
+
+# uv lock file (commit for reproducible builds)
+# uv.lock
+
+# Claude Code settings (local development)
+.claude/

dsap_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),  
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+<!-- ---
+
+## [Unreleased]
+
+--- -->
+
+## [0.1.0] - 2026-03-08
+
+### Added
+
+#### SM-2 Algorithm Implementation
+- Full implementation of the SuperMemo 2 spaced repetition algorithm
+- Quality ratings from 0–5 for flexible recall assessment
+- Automatic interval calculation based on easiness factor
+- Minimum easiness factor of 1.3 to prevent over-aggressive scheduling
+
+#### Problem Management
+- `dsap load` — Load curated problem sets (Blind 75, NeetCode 150, Grind 75)
+- `dsap add` — Add custom problems with title, URL, difficulty, and category
+- `dsap reset` — Reset problems and/or progress with flexible options
+- Support for custom YAML problem set files
+- Problem categorization by topic (Arrays, Trees, Graphs, etc.)
+- Difficulty levels: Easy, Medium, Hard
+
+#### Problem Sets
+- Blind 75 — 75 essential interview problems
+- NeetCode 150 — 150 comprehensive curriculum problems
+- Grind 75 — 75 flexible study roadmap problems
+
+#### Review System
+- `dsap review` — Interactive review sessions with due problems
+- `dsap next` — Get the next recommended problem
+- Smart prioritization: due problems > new problems > hardest problems
+- `--set` filter for focusing on specific problem sets
+- `--difficulty` filter for targeting specific difficulty levels
+- `--category` filter for practicing specific topics
+- `--new-only` flag for getting only unattempted problems
+
+#### Progress Tracking
+- `dsap stats` — Comprehensive statistics dashboard
+- Track solved problems, review counts, and streaks
+- Per-difficulty breakdown (Easy / Medium / Hard)
+- Due today and due this week counts
+- `dsap list` — List problems with filters
+
+#### Configuration
+- `dsap config` — View and modify settings
+- `preferred_set` — Set default problem set for all commands
+- `preferred_difficulty` — Filter recommendations by difficulty
+- `daily_goal` — Target problems per day
+- `show_hints` — Toggle problem hints
+- `auto_open_browser` — Toggle auto-opening problems in browser
+- Flexible set name parsing (accepts `blind75`, `Blind 75`, `blind_75`, etc.)
+
+#### CLI Features
+- Built with Click for robust command-line interface
+- Rich terminal UI with colors and tables
+- Comprehensive `--help` for all commands
+
+#### Documentation
+- USER_GUIDE.md — Complete daily workflow guide
+- Detailed README with examples
+
+#### Data Storage
+- SQLite database for reliable local storage
+- Stored in `~/.dsap/dsap.db`
+- Configuration in `~/.dsap/config.json`
+
+### Technical
+
+- Python 3.10+ support
+- Type hints throughout the codebase (mypy strict mode)
+- Pydantic v2 models for data validation
+- Comprehensive test suite (134 tests)
+- Google Python Style Guide compliance (ruff + pydocstyle)
+
+---
+
+[Unreleased]: https://github.com/juma-paul/dsap-cli/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/juma-paul/dsap-cli/releases/tag/v0.1.0

dsap_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Juma R. Paul
+
+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.

dsap_cli-0.1.0/PKG-INFO

@@ -0,0 +1,287 @@
+Metadata-Version: 2.4
+Name: dsap-cli
+Version: 0.1.0
+Summary: A CLI for mastering Data Structures & Algorithms using spaced repetition (SM-2).
+Project-URL: Homepage, https://github.com/alquatra/dsap
+Project-URL: Documentation, https://github.com/alquatra/dsap#readme
+Project-URL: Repository, https://github.com/alquatra/dsap.git
+Project-URL: Issues, https://github.com/alquatra/dsap/issues
+Project-URL: Changelog, https://github.com/alquatra/dsap/blob/main/CHANGELOG.md
+Author-email: "Juma R. Paul" <jumarobertpaul@gmail.com>
+Maintainer-email: "Juma R. Paul" <jumarobertpaul@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: algorithms,cli,coding-interview,data-structures,dsa,leetcode,sm2,spaced-repetition,study
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: click<9,>=8.1
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: pyyaml<7,>=6
+Requires-Dist: rich<14,>=13
+Provides-Extra: dev
+Requires-Dist: mypy<2,>=1; extra == 'dev'
+Requires-Dist: pre-commit<4,>=3; extra == 'dev'
+Requires-Dist: pytest-cov<5,>=4; extra == 'dev'
+Requires-Dist: pytest<9,>=8; extra == 'dev'
+Requires-Dist: ruff<1,>=0.4; extra == 'dev'
+Requires-Dist: types-pyyaml<7,>=6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+
+
+# Data Structures and Algorithms Practice (DSAP)
+
+[![PyPI version](https://badge.fury.io/py/dsap-cli.svg)](https://pypi.org/project/dsap-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/dsap-cli)](https://pypi.org/project/dsap-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+DSAP is a terminal-first CLI that schedules coding interview problems using the **SM-2 spaced repetition algorithm**, helping you retain patterns long-term instead of forgetting them after solving once.
+
+---
+
+# Why DSAP?
+
+Most developers preparing for technical interviews solve algorithm problems once and never revisit them.
+
+As a result, they forget patterns they previously learned.
+
+DSAP solves this by scheduling problems using **spaced repetition**, a learning technique proven to improve long-term memory.
+
+Benefits:
+
+- Retain algorithm patterns long-term
+- Structured daily practice
+- Automatic scheduling of reviews
+- Focus on problems you’re about to forget
+
+Instead of guessing what to practice next, **DSAP tells you exactly what to review**.
+
+---
+
+# Installation
+
+```bash
+# Recommended
+uv tool install dsap-cli
+
+# Alternatives
+pipx install dsap-cli
+pip install dsap-cli
+```
+
+Verify installation:
+
+```bash
+dsap --version
+```
+
+---
+
+# Quick Start
+
+```bash
+# Load problems and set focus
+dsap load blind75
+dsap config preferred_set blind75
+
+# Start practicing
+dsap next
+```
+
+For the full workflow see:
+
+```
+USER_GUIDE.md
+```
+
+---
+
+# Example Session
+
+```
+$ dsap next
+
+📌 Next Problem
+Two Sum (Easy)
+
+Category: Arrays
+Set: Blind 75
+
+Open problem in browser? [y/N]
+
+After solving, rate your recall:
+
+5 - Perfect
+4 - Good
+3 - Hard
+2 - Incorrect but remembered idea
+1 - Incorrect
+0 - Complete blackout
+```
+
+DSAP then schedules the next review automatically.
+
+---
+
+# Commands
+
+| Command | Description |
+|--------|-------------|
+| `dsap next` | Get next recommended problem |
+| `dsap review` | Review due problems in a session |
+| `dsap list` | List problems with filters |
+| `dsap stats` | View progress and statistics |
+| `dsap load` | Load curated problem sets |
+| `dsap config` | Manage configuration |
+| `dsap reset` | Reset problems and/or progress |
+| `dsap add` | Add a custom problem |
+
+---
+
+# Examples
+
+```bash
+# Filter by problem set
+dsap next --set blind75
+dsap review --set neetcode150
+
+# Filter by difficulty
+dsap next --difficulty Easy
+dsap list --difficulty Hard
+
+# Filter by category
+dsap list --category "Dynamic Programming"
+
+# Other options
+dsap review --limit 5
+dsap next --new-only
+dsap list --due
+
+# Reset progress
+dsap reset --progress
+
+# Reset a specific set
+dsap reset --set blind75 --all
+```
+
+---
+
+# Problem Sets
+
+| Set | Problems | Description |
+|----|----|----|
+| `blind75` | 75 | Core interview essentials |
+| `neetcode150` | 150 | Comprehensive curriculum |
+| `grind75` | 75 | Flexible study roadmap |
+
+```bash
+dsap load --list
+dsap load blind75
+dsap load ./custom.yaml
+```
+
+---
+
+# Configuration
+
+```bash
+dsap config --list
+dsap config preferred_set blind75
+dsap config daily_goal 5
+dsap config preferred_difficulty Medium
+dsap config auto_open_browser false
+dsap config --reset
+```
+
+| Setting | Default | Description |
+|----|----|----|
+| `preferred_set` | None | Default problem set |
+| `daily_goal` | 5 | Target problems per day |
+| `preferred_difficulty` | None | Filter by difficulty |
+| `show_hints` | true | Show problem hints |
+| `auto_open_browser` | true | Open problems in browser |
+
+---
+
+# How It Works
+
+DSAP implements the **SM-2 (SuperMemo 2)** spaced repetition algorithm.
+
+After solving each problem, rate your recall from **0–5**.
+
+| Rating | Meaning | Effect |
+|----|----|----|
+| 5 | Perfect | Interval grows |
+| 4 | Good | Interval grows |
+| 3 | Hard | Interval grows slowly |
+| 0-2 | Forgot | Interval resets |
+
+Typical interval progression:
+
+```
+1 day → 6 days → 15 days → 38 days → 95 days
+```
+
+After several successful reviews, problems reappear only every few months.
+
+---
+
+# Data Storage
+
+DSAP stores all data locally:
+
+```
+~/.dsap/
+├── dsap.db
+└── config.json
+```
+
+To completely uninstall:
+
+```bash
+uv tool uninstall dsap-cli
+rm -rf ~/.dsap
+```
+
+---
+
+# Development
+
+```bash
+git clone https://github.com/juma-paul/dsap-cli.git
+cd dsap-cli
+
+uv sync --all-extras
+uv run pytest
+```
+
+---
+
+# Changelog
+
+See the full release history in:
+
+```
+CHANGELOG.md
+```
+
+---
+
+# License
+
+MIT