leetcode-runner-cli

Executes leetcode testcases and submits your solution through CLI interface

Disclaimer : This is not an official Leetcode tool. I am not affiliated with Leetcode in any way. This tool is not endorsed by leetcode.

---

Installation

1. Install rust from here to compile the source code.

2. Clone the repository and install the binary.

   git clone https://github.com/dvishal485/leetcode-runner-cli.git
   cd leetcode-runner-cli
   cargo install --path .

3. Setup environment variable LC_COOKIE with your leetcode session cookie.

   You can get your session cookie by logging in to leetcode and inspecting the cookie in your browser's developer tools.

   Make sure to put your cookie in double quotes.

    export LC_COOKIE="csrftoken=abcdefgh;LEETCODE_SESSION=ijklmnopqrstuvwxyz;"

4. Execute the tool and verify your authentication.

   leetcode-runner-cli -a

---

Usage

leetcode-runner-cli [FLAGS] [OPTIONS <option>]

Commands

Commands	Description	Arguments
-h, --help	Prints help information	-
-V, --version	Prints version information	-
-a, auth	Authenticate with leetcode	-
-d, daily	Fetch daily challenge question	-
-q, question	Question title / url to fetch	[question_title]
-r, run	Execute file with default testcases	[file_to_run]
-rt, run-custom	Execute file with custom testcases	[testcase_file] [file_to_run]
-s, submit	Submit solution to leetcode after passing testcases	[file_to_submit]
-fs, fast-submit	Submit solution to leetcode	[file_to_submit]

File changes

If you fetch the question from the CLI (using -d or -q), then tool will automatically add the required changes in the boiler plate code.

But if you are using your own code, then you need to make the following changes :

The file you submit to leetcode shouldn't have driver code like main function or struct definition. But no need to manually remove it. The tool will automatically remove the driver code and submit the solution to leetcode. All you need to do is put the delimiters #LCSTART and #LCEND in your solution file in comments, and place leetcode problem link anywhere in the file.

For example :

struct Solution;

// #LCSTART

impl Solution {
    pub fn two_sum(nums: Vec<i32>, target: i32) -> Vec<i32> {
        // real magic here
    }
} // #LCEND https://leetcode.com/problems/two-sum/ 

fn main() {
 // can have anything which may assist you
}

• In case link is not found, the tool will exit with error message for the same.
• In case start delimiter is not found, the tool will run till the end delimiter.
• In case end delimiter is not found, the tool will run till the end of file.
• In case both start and end delimiters are not found, the tool will default to the whole file.

Example usage

• Fetch question koko-eating-bananas

  leetcode-runner-cli -q koko-eating-bananas

  OR

  leetcode-runner-cli -q https://leetcode.com/problems/koko-eating-bananas/

• Run src/main.rs with default testcases for question koko-eating-bananas

  leetcode-runner-cli -r ./src/main.rs

• Run src/main.rs with custom testcase file

  leetcode-runner-cli -rt ./testcase.txt ./src/main.rs

• Submit src/main.rs to leetcode

  leetcode-runner-cli -s ./src/main.rs

  Note : This will first execute the default testcases and then submit the solution to leetcode only if the testcases pass as a preventive measure to avoid submitting wrong solution.

• Submit src/main.rs to leetcode without running testcases

  leetcode-runner-cli -fs ./src/main.rs

Note

1. Code file should have the link of question in the comments for the following examples.
2. If you don't specify file location then the tool will search for code in the current directory and use it by default.
3. If there are multiple files, then the tool will use file named main or the first file it finds in case there is no main file.

So, in the above examples, you can simply do cd ./src and then run the following commands :

• Execute with custom testcases : leetcode-runner-cli -rt ./testcase.txt
• Execute with default testcases : leetcode-runner-cli -r
• Submit : leetcode-runner-cli -s
• Submit without running testcases : leetcode-runner-cli -fs

---

Languages supported

This is a generic module that can be used to run any language. It only needs a mapping to the language on leetcode and extension of the file.

Currently, the following languages are added by default : Rust, Python3, Cpp, Java, C, Javascript, Go, Kotlin, Swift, Typescript, Csharp, Ruby, Scala, PHP, Racket, Erlang, Elixir, Dart.

More languages can be added manually as per requirement by changing enum in the src/file_parser/language.rs file.

---

License & Copyright

• This Project is Apache-2.0 Licensed
• Copyright 2023 Vishal Das

---