Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/NeverMendel/leetcode-export
Python script and Docker image to export your LeetCode submissions
https://github.com/NeverMendel/leetcode-export
collaborate docker github github-codespaces leetcode leetcode-solutions python python3
Last synced: 3 months ago
JSON representation
Python script and Docker image to export your LeetCode submissions
- Host: GitHub
- URL: https://github.com/NeverMendel/leetcode-export
- Owner: NeverMendel
- License: mit
- Created: 2021-12-30T17:00:45.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-14T10:19:06.000Z (9 months ago)
- Last Synced: 2024-04-14T11:14:31.306Z (9 months ago)
- Topics: collaborate, docker, github, github-codespaces, leetcode, leetcode-solutions, python, python3
- Language: Python
- Homepage:
- Size: 72.3 KB
- Stars: 15
- Watchers: 2
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# LeetCode Export
Python script and Docker image to export your LeetCode submissions.
If you find LeetCode Export helpful, please consider giving it a star ⭐️. Your support helps me gauge its usage and motivates further development.
## 📝 Table of Contents
- [DISCLAIMER](#DISCLAIMER)
- [About](#about)
- [Getting started](#getting-started)
- [Script arguments](#script-arguments)
- [Special mentions](#special-mentions)
- [License](#license)
The problems hosted on leetcode.com are intellectual propriety of LeetCode LLC unless specified otherwise. **DO NOT
UPLOAD THE DESCRIPTION OF LEETCODE PROBLEMS ON GITHUB OR ON ANY OTHER WEBSITE** or you might receive ad DMCA Takedown
notice.
Before using this script read the [LeetCode Terms of Service](https://leetcode.com/terms/).
This script uses LeetCode REST and GraphQL APIs to download all your LeetCode submitted solutions.
Before running the script, make sure that python3 is installed in your system.
If you prefer, you can use the Docker image to download LeetCode submissions. For more information read the
section [Docker Image](#docker-image).
### Download `leetcode-export`
To use `leetcode-export` download it from pypi.org, pull the docker image, or clone this repository.
#### Download from pypi.org
Run `pip install leetcode-export` to install leetcode-export, you might have to use `pip3` of your system. Then execute
run the script `leetcode-export`, optionally supply the script arguments. For more information read the
section [script arguments](#script-arguments).
#### Docker Image
Download the docker image from DockerHub:
```bash
docker pull nevermendel/leetcode-export
```
Download all your LeetCode submission in the current folder:
```bash
docker run -it -v $(pwd):/usr/app/out --rm nevermendel/leetcode-export
```
#### Clone the repository
Clone this repository:
```bash
git clone https://github.com/NeverMendel/leetcode-export
```
Install all the needed dependencies:
```bash
pip install -r requirements.txt
```
Install leetcode-export in your system or just execute it:
- To install the script:
```bash
pip install .
```
- To execute the script without installing it:
```bash
python -m leetcode_export --folder submissions
```
### Login
`leetcode-export` requires a valid LeetCode account to download its submissions. Login to your LeetCode account by
providing the cookies. To log in using cookies, get them from an existing session.
**Steps required**:
- Login in to LeetCode in the web browser
- Open the browser's Dev Tool
- Click on the Network tab
- Copy the cookie header that can be found under Request Headers in any leetcode.com request.
You can insert the cookie string that you have just copied in the interactive menu (recommended) or you can pass it as a
program argument when lunching the script, like in the following example:
```bash
python leetcode-export --cookies {COOKIES}
```
Using the interactive menu is preferred because it will avoid storing cookies in the command history.
## Script arguments
The script accepts the following arguments:
```
usage: leetcode-export [-h] [--cookies COOKIES] [--folder FOLDER]
[--problem-folder-name PROBLEM_FOLDER_NAME]
[--no-problem-statement]
[--problem-statement-filename PROBLEM_STATEMENT_FILENAME]
[--problem-statement-content PROBLEM_STATEMENT_CONTENT]
[--submission-filename SUBMISSION_FILENAME]
[--only-accepted] [--only-last-submission]
[--language LANGUAGE_UNPROCESSED] [-v] [-vv] [-V]
Export LeetCode submissions
options:
-h, --help show this help message and exit
--cookies COOKIES set LeetCode cookies
--folder FOLDER set output folder
--problem-folder-name PROBLEM_FOLDER_NAME
problem folder name format
--no-problem-statement
do not save problem statement
--problem-statement-filename PROBLEM_STATEMENT_FILENAME
problem statement filename format
--problem-statement-content PROBLEM_STATEMENT_CONTENT
problem statement content format
--submission-filename SUBMISSION_FILENAME
submission filename format
--only-accepted save accepted submissions only
--only-last-submission
only save the last submission for each programming language
--language LANGUAGE_UNPROCESSED
save submissions for specified programming languages.
syntax: --language=,,...
languages: python, python3, c, cpp, csharp, java,
kotlin, mysql, mssql, oraclesql, javascript,
html, php, golang, scala, pythonml,
rust, ruby, bash, swift
example: --language=python,cpp,java
-v, --verbose enable verbose logging details
-vv, --extra-verbose enable more verbose logging details
-V, --version show program's version number and exit
```
### Problem template arguments
#### Problem statement filename template
To change the format of the problem statement filename provide a template as a string when executing the
script.
```bash
python leetcode-export --problem-statement-filename PROBLEM_STATEMENT_FILENAME
```
The template can contain parameters that will later be replaced based on the LeetCode problem information. The available
parameters are the following:
```python
question_id: int
difficulty: str
stats: str
title: str
title_slug: str
```
Default problem statement filename template: `${question_id} - ${title_slug}.html`
#### Problem statement content template
To change the format of the problem statement content provide a template as a string when executing the
script.
```bash
python leetcode-export --problem-statement-content PROBLEM_STATEMENT_CONTENT
```
The template can contain parameters that will later be replaced based on the LeetCode problem information. The available
parameters are the ones contained in [problem statement filename template](#problem-statement-filename-template) plus:
```python
content: str
```
Default problem statement content template:
`
${question_id} - ${title}
Difficulty: ${difficulty} - ${title_slug}
${content}`
#### Submission filename template
To change the format of the submission filename, you can provide a template as a string when lunching the script.
```bash
python leetcode-export --submission-filename SUBMISSION_FILENAME
```
The template can contain parameters that will later be replaced based on the submission information. The available
parameters are the following:
```python
id: int
lang: str
time: str
timestamp: int
status_display: str
runtime: str
url: str
is_pending: str
title: str
memory: str
code: str
compare_result: str
title_slug: str
date_formatted: str
extension: str
```
Default submission filename
template: `${date_formatted} - ${status_display} - runtime ${runtime} - memory ${memory}.${extension}`
## Special mentions
Thanks to [skygragon](https://github.com/skygragon) for
developing [leetcode-cli](https://github.com/skygragon/leetcode-cli), which I used as documentation for LeetCode APIs.
The license of leetcode-cli is available [here](https://github.com/skygragon/leetcode-cli/blob/master/LICENSE).
## License
[MIT License](LICENSE)