leetcode-py

leetcode-py

LeetCode practice made efficient and accessible through a powerful Python package designed to generate a complete coding environment. The package facilitates the creation of problem README files, typed solution stubs, and parameterized pytest suites containing over 10 test cases, all derived from JSON templates. Additional features include helper functions and a dedicated playground notebook to enhance the coding experience. Comprehensive documentation is available at leetcode-py.wisl.dev.

Key Features

• LLM-Assisted Workflow: Quickly generate new problems with AI support. For more information, visit the Problem Creation section.
• Visual Debugging: Data structures like TreeNode, ListNode, and GraphNode can be visualized as Graphviz diagrams in Jupyter and clean ASCII outputs in terminal environments. Explore this in the Visualizations section.
• Production Testing: Ensure comprehensive test coverage with edge case scenarios and reproducibility. Learn more about testing in the Testing section.
• Modern Python Support: Features like PEP 585/604 type hints, uv, and professional tooling are implemented for enhanced coding practices.
• Quality Assurance: The project ensures over 95% test coverage and conducts regular security scans with automated linting.
• Powerful CLI: The lcpy command allows problem generation from any environment, enhancing usability. Further details are provided in the CLI documentation.

Quick Start

Requirements include Python 3.10+ along with Graphviz for visualizations, with the installation instructions documented in the repository.

# Install the package
pip install leetcode-py-sdk

# Generate problems
lcpy gen -n 1                    # Generate Two Sum
lcpy gen -t grind-75             # Generate all Grind 75 problems
lcpy list -t blind-75            # List Blind 75 problems

# Begin coding practice
cd leetcode/two_sum
python -m pytest test_solution.py  # Execute tests
# Modify solution.py, then rerun tests

Collections

The repository boasts 1404 problems available for exploration, organized into several curated collections. Review the complete list in the catalog:

Development

Development contributions are welcome. Clone the repository to get started:

git clone https://github.com/wislertt/leetcode-py.git
cd leetcode-py
uv sync
bake test

Problems are generated from JSON templates, and detailed instructions for adding new problems are found in the LLM-assisted workflow and bakefile guide.

Documentation Overview

• Why leetcode-py
• Installation
• Problem Anatomy
• Testing Pattern
• Visualizations
• Notebook Workflow
• CLI Reference
• Contributing

Support the Project

If this project proves beneficial, consider starring the repository or supporting its development.