Command line interface for Baekjoon Online Judge.
Python <= 3.12MacOS,Linux,Windows
$ pip install boj-cli# ~/myproject/.boj/config.yaml
general:
selenium_browser: "chrome" # required - firefox | chrome | edge
default_filetype: "cpp" # optional - default filetype for 'boj add'
editor_command: "nvim -o" # required - code | nvim | ..
workspace:
ongoing_dir: "problems" # optional - ongoing problem directory. default: ""
archive_dir: "archives" # optional - archive directory. default: "archives"
filetype:
py:
language: "python3" # required - language for your submission
main: "main.py" # required - the main file name
run: "python3 $file" # required - the run command
cpp:
language: "c++17"
main: "main.cpp"
source_templates: # optional - these files will be copied into source dir
- "main.cpp"
root_templates: # optional - these files will be copied into root dir
- "compile_flags.txt"
compile: "g++ -std=c++17 $file" # optional - set this option if you use compile language
run: "./a.out"
after: "rm -rf a.out" # optional - command to execute after 'boj run'
# other filetypes ..
filetype.language에 들어갈 수 있는 값들은 Supported languages를 참고해주세요.
usage: boj [-h] [-v] {init,add,login,open,random,run,submit,clean,case} ...
positional arguments:
{init,add,login,open,random,run,submit,clean,case}
init initializes BOJ directory
add sets up an environment of the given problem id
login logs in to BOJ
open opens a problem of given id in browser
random queries and opens a random problem in browser
run runs generated testcases
submit submit your solution and trace the realtime statement
clean archives accepted source files
case manages testcases
options:
-h, --help show this help message and exit
-v, --version show version
$ boj init현재 경로를 BOJ 디렉토리로 설정하고 다음과 같은 리소스들을 생성합니다.
./.boj./.boj/config.yaml./.boj/templates
$ boj login백준 온라인 저지에서는 로그인 시 reCAPTCHA를 사용하고있기 때문에 로그인 과정은 조금 번거로울 수 있습니다.
위 명령어를 실행하면 selenium 브라우저가 실행되고, reCAPTCHA를 포함한 로그인을 수행하면 세션 정보를 로컬 디렉토리 $HOME/.boj-cli에 암호화해서 저장합니다.
로그인 시 "로그인 상태 유지" 체크 박스를 반드시 선택해주세요.
$ boj add 1234 -f cpp
Testcases have been created.
$ tree .
├── 1234
│ ├── compile_flags.txt
│ ├── main.cpp
│ └── testcases
│ ├── 1
│ │ ├── input.txt
│ │ └── output.txt
│ ├── 2
│ │ ├── input.txt
│ │ └── output.txt
│ ├── 3
│ │ ├── input.txt
│ │ └── output.txt
│ ├── 4
│ │ ├── input.txt
│ │ └── output.txt
│ └── 5
│ ├── input.txt
│ └── output.txt
└── .boj
├── config.yaml
└── templates
├── compile_flags.txt
└── main.cpp백준 온라인 저지 문제를 풀기위한 폴더를 생성하고 다음과 같은 작업들을 수행합니다.
./.boj/templates폴더에 위치한 템플릿 파일 불러오기.- 크롤링을 활용해서 텍스트로 파싱한 테스트케이스 파일 생성.
--type, -t str: 파일 타입을 지정합니다. (e.g. cpp, ts, rs, py ...)
(이 옵션은 'config.general.default_filetype'을 override 합니다.)
--force, -f: 이미 문제가 존재하는 경우에도 덮어씁니다.
# Outside of problem dir
$ boj run 1234
# Inside of problem dir
$ cd 1234 && boj runtestcases 경로에 있는 모든 테스트케이스를 비동기적으로 실행하고 정답을 비교합니다.
문제 폴더 안에서 실행하면 문제 번호 인자를 생략할 수 있습니다.
--timeout int(sec): 각 테스트케이스의 타임아웃을 설정합니다 (default: 10초)
# Outside of problem directory
$ boj submit 1234
# Inside of problem directory
$ cd 1234 && boj run로컬 소스 파일을 백준 온라인 저지에 제출하고 채점 현황을 실시간으로 구독합니다.
문제 폴더 안에서 실행하면 문제 번호 인자를 생략할 수 있습니다.
--open [ 'open' | 'close' | 'onlyaccepted' ]: 코드 공개 여부를 설정합니다. default: 'onlyaccepted'
--timeout int: 제출 현황 웹소켓의 타임아웃 설정(초) (default: 10)
$ boj cleanboj submit 명령어 수행 결과로 accepted를 받은 모든 문제들을 config.workspace.archive_dir로 아카이브힙니다.
아카이브 되는 파일은
yyyymmdd_hhmmss_{filename}의 포멧으로 저장됩니다. 마지막 제출 이후에 변경된 소스 코드에 대해서는 아카이빙을 수행하지 않습니다.
--origin, -o: 아카이브 파일 포멧을 무시하고 원본 파일 이름을 사용하며, 파일 이름이 이미 존재하면 덮어씁니다.
# Outside of problem directory
$ boj open 1234
# Inside of problem directory
$ cd 1234 && boj open기본 브라우저에서 문제 번호에 해당하는 페이지의 링크로 이동합니다.
문제 폴더 안에서 실행하면 문제 번호 인자를 생략할 수 있습니다.
$ boj random --tier g1..g5 --tags dp mathsolvedac API를 활용해서 문제를 검색하고, 기본 브라우저에서 링크로 이동합니다.
여러개의 tags 옵션은 'OR' 조건으로 동작합니다.
'내가 풀지 않은 문제' 만 쿼리됩니다.
--tier, -i: 문제 티어 쿼리
--tags, -t: 문제 태그 쿼리
$ boj case -e 1
$ boj case -n
config.general.editor_command 값을 참조하여 테스트 케이스 파일을 관리합니다.
--edit $TESTCASE_ID, -e $TESTACSE_ID: 주어진 id에 해당하는 테스트케이스 파일들을 편집합니다.
--new, -n: 새로운 테스트케이스를 생성하고 편집합니다. TESTCASE_ID는 자동부여 됩니다.
c++17 python3 pypy3 c99 c11 text golfscript java8 c++98 ruby
c++11 java11 kotlin(jvm) c++14 swift java8(openjdk) c++20 c#
node.js go d rust2018 go(gccgo) c++17(clang) java15 d(ldc) php
rust2015 pascal lua perl f# visual-basic objective-c c99(clang)
c++98(clang) c++11(clang) c++14(clang) objective-c++ c11(clang) c90
c90(clang) c2x(clang) typescript c++20(clang) bash fortran scheme
awk c2x assembly(32bit) assembly(64bit) o-caml whitespace lolcode
intercal rhino cobol pike sed tcl brainf**k ada system-verilog
algol68 befunge haxe 아희 bc free-basic rust2021 scala