Skip to main content

A tool for studying Leetcode with Python

Project description

💻 Leetcode Study Tool

Tests Status Style Status Python Versions PyPi contributions welcome

Leetcode Study Tool Diagram

This package lets you get grokking as quickly as possible with Leetcode. It provides a command-line tool for interracting with Leetcode to create either an Excel file or Anki flashcards for study. Currently, this tool supports taking in a list of leetcode question slugs or URLs or popular study sets (including the Blind 75, Grind 75, and Neetcode 150).

🤔 Why?

This package was created as an opinionated alternative to other existing packages (as listed at the bottom of this README).

📥 Installation

$ pip install leetcode-study-tool

💻 Usage

usage: leetcode-study-tool [-h] (--url URL | --file FILE | --preset {blind_75,grind_75,grind_169,neetcode_150,neetcode_250,neetcode_all}) [--format {anki,excel}]
                           [--template TEMPLATE] [--csrf CSRF] [--output OUTPUT] [--language LANGUAGE] [--include-code]

Generates problems from LeetCode questions in a desired format.

options:
  -h, --help            show this help message and exit
  --url URL, -u URL     The URL(s) or slug(s) of the LeetCode question(s) to generate problem(s) for. (default: None)
  --file FILE, -f FILE  The file containing the URL(s) or slug(s) of the LeetCode question(s) to generate problem(s) for. (default: None)
  --preset {blind_75,grind_75,grind_169,neetcode_150,neetcode_250,neetcode_all}, -p {blind_75,grind_75,grind_169,neetcode_150,neetcode_250,neetcode_all}
                        The preset to use to generate problem(s) for. (default: None)
  --format {anki,excel}, -F {anki,excel}
                        The format to save the Leetcode problem(s) in. (default: anki)
  --template TEMPLATE, -t TEMPLATE
                        Path to a custom Jinja template file for rendering problems. (default: None)
  --csrf CSRF, -c CSRF  The CSRF token to use for LeetCode authentication. (default: None)
  --output OUTPUT, -o OUTPUT
                        The output file to write the problem(s) to. (default: output.txt)
  --language LANGUAGE, -l LANGUAGE
                        The language to generate problem(s) for. (default: None)
  --include-code, -ic   Include solution code from NeetCode GitHub repository using the specified language. (default: False)

💡 Example

In the simplest case, if you want to Grok the most commonly asked questions, you should generate from a preset. For example, generating Anki cards from the Grind 75 is as simple as

$ leetcode-study-tool -p grind_75

Perhaps, instead, you'd prefer to import questions that you've already worked on. In a directory with a file named questions.txt, where each line is either a Leetcode problem URL or slug (or a combination of both), we can run the command

$ leetcode-study-tool -f questions.txt 

which will generate the file output.txt. We can then open Anki to import these problems as demonstrated below, ensuring to select semicolon as a field separator.

anki demo

Including Solution Code

You can include solution code from the NeetCode GitHub repository by using the --include-code flag along with specifying a programming language:

$ leetcode-study-tool -p grind_75 --language python --include-code

This will fetch solution code in the specified language (when available) and include it in your Anki cards or Excel output.

Supported languages include: c, cpp, csharp, dart, go, java, javascript, kotlin, python, ruby, rust, scala, swift, and typescript.

📒 Anki

When generating an Anki output, the resulting "cards" are saved as a .txt file. These cards include three fields:

  1. The front of the study card, containing the question ID, Title, URL, and problem description
  2. The publicly available solutions (and NeetCode solution or code, if available)
  3. The tags associated with the problem (i.e., if the problem involves a hash map, arrays, etc...)

📊 Excel

When generating an Excel output, the resulting questions are saved in an .xlsx file. Each problem includes the following fields:

  1. ID of the leetcode question
  2. Title of the leetcode question
  3. URL of the leetcode question
  4. Last date that this question was attempted by the user (please note that this is not pulled from your leetcode profile, but left for you to update as you progress in solving leetcode questions)
  5. The tags associated with the problem (i.e., if the problem involves a hash map, arrays, etc...)
  6. Neetcode video link (if it exists)
  7. Solution links for the problem (if they are reachable)
  8. Companies that have asked this question recently in interviews (if they are reachable)

Custom Templates

LeetCode Study Tool supports custom Jinja2 templates for generating Anki cards or other outputs. You can specify your own template file using the --template flag:

leetcode-study-tool --url "https://leetcode.com/problems/two-sum/" --template "path/to/my_template.jinja"

Template Variables

When creating your custom template, the following variables are available:

Variable Description
url The URL to the LeetCode problem
slug The problem slug
data Object containing all problem data
data.id Problem ID
data.title Problem title
data.content Problem description (HTML)
data.difficulty Problem difficulty (Easy, Medium, Hard)
data.tags List of topic tags for the problem
data.companies List of companies that ask this problem
data.solutions List of available solutions on LeetCode
data.neetcode_solution NeetCode solution code (if --include-code is used)
data.language Language of the solution code
neetcode NeetCode video information (when available)

Solution Code Example

Here's an example template that highlights the solution code:

<h1>{{ data.id }}. {{ data.title }} ({{ data.difficulty }})</h1>

<div class="content">
  {{ data.content }}
</div>

<div class="tags">
  {% for tag in data.tags %}
    <span class="tag">{{ tag.name }}</span>
  {% endfor %}
</div>

;

{% if data.neetcode_solution %}
<h3>Solution Code ({{ data.language }})</h3>
<pre><code>
{{ data.neetcode_solution }}
</code></pre>
{% endif %}

{% if data.solutions %}
<div class="community-solutions">
  <h3>Community Solutions:</h3>
  <ul>
    {% for solution in data.solutions[:3] %}
      <li><a href="{{ solution_url(slug, solution.id) }}">Solution {{ loop.index }}</a></li>
    {% endfor %}
  </ul>
</div>
{% endif %}

;

{{ data.tags|map(attribute='slug')|join(' ') }}

🛣 Roadmap

  • Use TQDM to show card generation progress
  • Add support for exporting to an excel sheet
  • Add support for showing neetcode solutions on the back of the card as a
  • Add support for getting the difficulty of questions
  • Add support for Jinja templating formatters
  • Add support for including NeetCode solution code
  • Add NeetCode shorts
  • Add support for fetching premium questions via authentification
  • Add support for importing cards into Quizlet
  • Add support for fetching questions by topic or tag link
  • Reach 90% test coverage

🔎 Other Usefull Stuff

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

leetcode_study_tool-1.3.5.tar.gz (46.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

leetcode_study_tool-1.3.5-py3-none-any.whl (40.4 kB view details)

Uploaded Python 3

File details

Details for the file leetcode_study_tool-1.3.5.tar.gz.

File metadata

  • Download URL: leetcode_study_tool-1.3.5.tar.gz
  • Upload date:
  • Size: 46.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for leetcode_study_tool-1.3.5.tar.gz
Algorithm Hash digest
SHA256 a1fac2b1ad20919d04c2935994f94ba6bc8f73712032b7846ded8c7ad47f750a
MD5 d93ece678fdfef699009e38c3f443913
BLAKE2b-256 f1e3c7f8a8b73e637a5a1602c71882ce6f8a95309e04d27ff177694a02399bf6

See more details on using hashes here.

Provenance

The following attestation bundles were made for leetcode_study_tool-1.3.5.tar.gz:

Publisher: publish.yml on johnsutor/leetcode-study-tool

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file leetcode_study_tool-1.3.5-py3-none-any.whl.

File metadata

File hashes

Hashes for leetcode_study_tool-1.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 947ca2e39d51c7e4f76cc71de9eab7525b4943ccf14f8b7a1a2a467931a12647
MD5 802dec430f3a8c85644887763e9ee80d
BLAKE2b-256 9f87ab55c6760a22b4baa49e5021777f0023b7995fe0935aa8c9e3cf40df9528

See more details on using hashes here.

Provenance

The following attestation bundles were made for leetcode_study_tool-1.3.5-py3-none-any.whl:

Publisher: publish.yml on johnsutor/leetcode-study-tool

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page