dsap-cli 0.1.0__py3-none-any.whl

dsap_cli-0.1.0.dist-info/METADATA

@@ -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

dsap_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+dsap/__init__.py,sha256=5XgE49uJFttFU9TWfcb0rIqzvwtuUuWAiaHZhx2ossU,618
+dsap/__main__.py,sha256=GwLikf--QR1WA0rvXyJjF1pDO6-DHf74s8XcVC3z4VQ,122
+dsap/cli.py,sha256=_fwbdCIHB-jf2zDYqhwk9-Gq5S4MN7ZLeAWGil0g8Nw,17886
+dsap/config.py,sha256=Sx2kMclYGrwMz3RaC4LDy5h4bPWoHfqiFm7tuaGBOrs,4648
+dsap/database.py,sha256=nzFvKuy4AITvicOTmici66yaFxnUcQHQXQu3NhyKRR4,27217
+dsap/models.py,sha256=ekQvBxkf0vCRI-58sWPajuIzOTiHVq8HZ_kpIvwP0sE,7009
+dsap/problem_sets.py,sha256=ZZvAr4kHlXqnQbCVQT5N7HW2EznZTENDZWd2KYKXHZw,5427
+dsap/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dsap/sm2.py,sha256=oVW0BSCIvCR8T-WZuSUkmXCXX0vQSuFSB1UshQlisHQ,17129
+dsap/ui.py,sha256=yD7-AE_SiHiSWI-haBKyUTK6X35TlEaICwmhx_HPqNc,13288
+dsap/data/blind75.yaml,sha256=ZiIZlySgIJUwiBz2qQW9oYE15MjIVVpo-sT9iJtC4aw,14375
+dsap/data/grind75.yaml,sha256=DepmLsHYhSOgRlRg2CCu7JZG7bk2zxUz5gIt1-Q5-og,14078
+dsap/data/neetcode150.yaml,sha256=aKjMy79ZVyl71CLD_fKkkZJx6oACeLId7trSb2bSuDo,28040
+dsap_cli-0.1.0.dist-info/METADATA,sha256=VfrFXCXxfibuQC2XfXJSrTX-tNytTO4a8GtbVld0_io,6383
+dsap_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+dsap_cli-0.1.0.dist-info/entry_points.txt,sha256=VVbhRF2SvefP5ILXgmDe0DxsGu6Vl26tntajkIERPJY,39
+dsap_cli-0.1.0.dist-info/licenses/LICENSE,sha256=BwtbR5kJlaACk5LKNYgGtMraQK5t9wyAgCUw1eV9Src,1069
+dsap_cli-0.1.0.dist-info/RECORD,,

dsap_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dsap_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dsap = dsap.cli:main

dsap_cli-0.1.0.dist-info/licenses/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.