리트코드 스터디 도우미

DaleStudy 리트코드 풀이를 찾고, 작성하고, 테스트하고, 제출하는 일을 VS Code 안에서 이어갑니다.

이 확장의 목표는 DaleStudy/leetcode-study 스터디 저장소를 더 쉽고 빠르게 사용하는 것입니다. 75개 문제를 주차별로 탐색하고, 내 풀이 파일을 관리하고, Python 코드를 로컬에서 테스트한 뒤 주차별 PR로 제출할 수 있습니다.

설치 · 상세 사용법 보기 · 빠른 시작 · 설정

설치

사용하는 에디터에서 확장 프로그램 보기를 열고 리트코드 스터디 도우미를 검색해 설치합니다.

• VS Code: Visual Studio Marketplace에서 보기
• Cursor·VSCodium 등 Open VSX 사용 에디터: Open VSX에서 보기

검색 결과에 바로 나타나지 않으면 정확한 확장 ID를 입력하세요.

@id:alphaorderly.leetcode-study-helper

사용법

저장소 준비, 닉네임 설정, 문제 탐색, 풀이 작성, Python 테스트, 주차별 제출, 포크 동기화까지 화면별 안내는 USAGE.md 를 보세요.

무엇이 편해지나요?

대표 화면

현재 문제와 로컬 Python 테스트

문제 본문을 읽으면서 현재 에디터의 Python 코드를 바로 실행합니다. 같은 이름의 Solution 클래스나 메서드가 여러 개면 줄 번호로 실행 대상을 구분합니다.

주차별 제출

작성 중 → 커밋 준비 → push 필요 → PR 진행 → 병합 완료 상태를 문제 카드와 제출 탭에서 함께 확인합니다. 확장에서 직접 선택한 풀이만 커밋 대상으로 사용하며, 주차 커밋 시 week-01 형식의 브랜치를 자동으로 준비합니다.

빠른 시작

1. 에디터의 확장 프로그램 스토어에서 리트코드 스터디 도우미를 검색해 설치합니다.
2. DaleStudy/leetcode-study를 포크하고 로컬에 클론합니다.
3. problem-categories.json과 문제 폴더가 있는 저장소를 에디터로 엽니다.
4. 활동 표시줄에서 리트코드 스터디 도우미 아이콘을 선택합니다.
5. 제출 파일명에 사용하는 닉네임과 기본 언어를 입력하고 적용을 누릅니다.
6. 문제 카드를 눌러 기존 풀이를 열거나 새 풀이 파일을 만듭니다.
7. 풀이를 작성한 뒤 현재 문제 보기에서 테스트하고, 제출 탭에서 커밋·push·PR 흐름을 진행합니다.

닉네임은 파일명의 첫 번째 점 앞부분과 대소문자까지 정확히 비교합니다. 예를 들어 study-user는 study-user.py와 일치하지만 Study-User.py와는 일치하지 않습니다.

설치와 원격 저장소 준비부터 필터, 카드 아이콘, 테스트 실패 확인, 주차별 제출과 포크 동기화까지는 상세 사용법에서 화면별로 확인할 수 있습니다.

핵심 기능

문제 탐색과 풀이 파일

• problem-categories.json과 문제 폴더를 감지해 문제를 주차별·난이도별로 정리합니다.
• 제목 검색, 풀이 있음·없음, 미푸시 필터로 필요한 문제만 남깁니다.
• 닉네임과 기본 언어를 기준으로 기존 풀이를 열거나 새 제출 파일을 만듭니다.
• 같은 문제의 여러 언어 풀이, 다른 참여자의 무작위 풀이, Algodale 정답 링크를 제공합니다.
• 풀이 삭제와 Markdown을 제외한 제출 파일의 마지막 줄바꿈 일괄 정리를 지원합니다.

현재 문제와 Python 테스트

• 풀이 파일을 열면 LeetCode 문제 본문, 예제, 제약과 주제 태그를 표시합니다.
• 저장하지 않은 현재 에디터 코드도 테스트하며 여러 Solution 구현을 개별 선택합니다.
• typing, array, bisect, collections, functools, itertools, heapq, math 등 일반적인 LeetCode Python 환경을 먼저 import합니다.
• 실행은 신뢰된 워크스페이스에서만 가능하고 10초 후 종료되며 출력은 1MB로 제한됩니다.

테스트 데이터는 newfacade/LeetCodeDataset의 고정 리비전 215604aeed660029df7de2fea5a4d7b6ed476a08에서 추출했습니다. 현재 스터디 75문제 중 68문제를 지원하며, 결과는 LeetCode의 공식 실행 또는 제출 결과가 아닙니다.

주차별 제출과 포크 동기화

• 문제 카드에서 직접 커밋에 추가한 풀이만 스테이징합니다.
• 동기화된 main에서 주차 커밋을 만들면 week-XX 브랜치를 안전하게 생성하거나 기존 브랜치를 검증해 재사용합니다.
• 활성 주차의 커밋, push, 열린 PR과 병합 상태를 단일 레일 그래프로 보여 줍니다.
• 여러 주차나 풀이 외 파일이 섞이면 자동 진행하지 않고 먼저 정리할 내용을 안내합니다.
• 안전한 상태에서 공식 main을 병합하고 포크의 origin/main에 push합니다. 내 풀이만 수정된 경우에도 동기화를 시도하며, 풀이 외 변경은 제출 탭에서 되돌릴 수 있습니다.
• PR 병합 후에는 명시적인 버튼으로 main에 돌아와 동기화하며 주차 브랜치는 자동 삭제하지 않습니다.
• rebase, force push, 자동 stash를 사용하지 않으며 충돌 시 merge를 중단합니다.

제출 기능은 origin의 fetch·push URL이 동일하고 GitHub에서 DaleStudy/leetcode-study의 포크로 확인된 저장소에서만 활성화됩니다.

알아둘 점

• 워크스페이스 루트에는 유효한 problem-categories.json과 대응하는 문제 폴더가 하나 이상 있어야 합니다.
• 제한 모드에서는 목록 조회만 지원합니다. 파일 생성·삭제·수정, 로컬 테스트, Git 작업에는 워크스페이스 신뢰가 필요합니다.
• 새 풀이와 제출 파일은 문제 폴더 바로 아래에서 관리하며 같은 이름이나 대소문자만 다른 파일을 덮어쓰지 않습니다.
• Git 상태는 현재 브랜치의 upstream을 기준으로 계산합니다. 확인할 수 없는 정보는 추측하지 않고 상태 확인 불가로 표시합니다.
• 문제 본문은 LeetCode의 비공식 GraphQL API에서 불러옵니다. 네트워크 오류나 Premium 비공개 본문은 LeetCode 페이지에서 확인해야 합니다.
• 다른 참여자 풀이를 처음 열 때, Algodale 정답 링크를 열 때마다 정답 노출 여부를 확인합니다.
• ListNode, TreeNode, Node, NestedInteger처럼 문제별 구조가 필요한 Python 객체는 자동 선언하지 않습니다.

조건별 대응 방법은 문제 해결을 참고하세요.

설정

설정은 전역으로 저장되어 다른 LeetCode Study 워크스페이스에서도 동일하게 사용됩니다.

로컬 개발

Node.js 24.18.0과 Yarn Classic 1.22.22를 사용합니다.

nvm use
yarn install
yarn compile

주요 검증 명령은 다음과 같습니다.

yarn lint
yarn typecheck
yarn test:unit
yarn test:integration
yarn test

통합 테스트는 .tmp에 격리된 멀티 루트 워크스페이스를 만든 뒤 @vscode/test-electron으로 실행합니다.

VSIX 만들기

yarn package:vsix

모든 검사와 테스트가 성공하면 .artifacts/leetcode-study-helper.vsix가 생성됩니다. VS Code의 Extensions: Install from VSIX... 명령으로 설치할 수 있습니다.

라이선스

MIT 라이선스로 배포합니다. 이 프로젝트는 LeetCode 또는 DaleStudy의 공식 제품이 아닙니다.