onlinejudge.service.atcoder module

the module for AtCoder (https://atcoder.jp/)

note

There are some useful endpoints:

• https://atcoder.jp/contests/abc001/standings/json

• https://atcoder.jp/users/chokudai/history/json

note

There is an unofficial API https://github.com/kenkoooo/AtCoderProblems

note

Some methods not inherited from classes onlinejudge.type may be modified in future, because the specification is not fixed yet.

class onlinejudge.service.atcoder.AtCoderContest(*, contest_id)

Bases: onlinejudge.type.Contest

Variables

contest_id – str

download_data(*, session=None, lang='en')

Return type

AtCoderContestDetailedData

classmethod from_url(url)

Parameters

url (str) – example:

• https://kupc2014.contest.atcoder.jp/tasks/kupc2014_d

• https://atcoder.jp/contests/agc030

Return type

Optional[AtCoderContest]

get_service()

Return type

AtCoderService

get_url(*, type=None, lang=None)

Return type

str

iterate_submission_data_where(*, me=False, problem_id=None, language_id=None, status=None, user_glob=None, order=None, desc=False, lang=None, pages=None, session=None)

Note

If you use certain combination of options, then the results may not correct when there are new submissions while crawling.

Parameters

• status (Optional[str]) – must be one of AC, WA, TLE, MLE, RE, CLE, OLE, IE, WJ, WR, or Judging

• order (Optional[str]) – must be one of created, score, source_length, time_consumption, or memory_consumption

• me (bool) – use the …/submissions/me page instead of …/submission

• user_glob (Optional[str]) – is used as the value of f.User query parameter

• language_id (Optional[NewType()(LanguageId, str)]) – is used as the value of f.Language query parameter

• lang (Optional[str]) – must be one of ja, en

• pages (Optional[Iterator[int]]) – is an iterator to list the page numbers to GET

Return type

Iterator[AtCoderSubmissionData]

iterate_submissions(*, session=None)

Note

in implementation, use “ORDER BY created DESC” to list all submissions even when there are new submissions

Return type

Iterator[AtCoderSubmission]

iterate_submissions_where(**kwargs)

Return type

Iterator[AtCoderSubmission]

list_problem_data(*, session=None)

Return type

List[AtCoderProblemData]

list_problems(*, session=None)

Return type

List[AtCoderProblem]

class onlinejudge.service.atcoder.AtCoderContestData(*, contest, duration, lang, name, rated_range, response, session, start_time, timestamp)

Bases: onlinejudge.type.ContestData

Variables

• contest – AtCoderContest

• duration – datetime.timedelta

• lang – str

• name – str

• rated_range – str

• start_time – datetime.datetime

property contest

Return type

AtCoderContest

property html

Return type

bytes

property name

Return type

str

property response

Return type

Response

property session

Return type

Session

property timestamp

Return type

datetime

class onlinejudge.service.atcoder.AtCoderContestDetailedData(*, can_participate, penalty, **kwargs)

Bases: onlinejudge.service.atcoder.AtCoderContestData

Variables

• can_participate – str

• penalty – datetime.timedelta

class onlinejudge.service.atcoder.AtCoderProblem(*, contest_id, problem_id)

Bases: onlinejudge.type.Problem

Variables

• contest_id – str

• problem_id – str

Note

AtCoder has problems independently from contests. Therefore the notions contest_id, alphabet, and url don’t belong to problems itself.

download_data(*, session=None)

Raises

Exception – if no such problem exists

Return type

AtCoderProblemDetailedData

download_input_format(*, session=None)

Raises

Exception – if no such problem exists

Return type

Optional[str]

download_sample_cases(*, session=None)

Raises

• requests.exceptions.HTTPError – if no such problem exists

• SampleParseError – if parsing failed

Return type

List[TestCase]

classmethod from_url(s)

Return type

Optional[AtCoderProblem]

get_available_languages(*, session=None)

Raises

NotLoggedInError –

Return type

List[Language]

get_contest()

Return type

AtCoderContest

get_name(*, session=None)

Return type

str

get_service()

Return type

AtCoderService

get_url(*, type=None, lang=None)

Return type

str

iterate_submissions(*, session=None)

Note

in implementation, use “ORDER BY created DESC” to list all submissions even when there are new submissions

Return type

Iterator[AtCoderSubmission]

iterate_submissions_where(**kwargs)

Return type

Iterator[AtCoderSubmission]

submit_code(code, language_id, *, filename=None, session=None)

Raises

• NotLoggedInError –

• SubmissionError –

Return type

AtCoderSubmission

class onlinejudge.service.atcoder.AtCoderProblemData(*, alphabet, memory_limit_byte, name, problem, response, session, time_limit_msec, timestamp, html=None)

Bases: onlinejudge.type.ProblemData

Note

AtCoderProblemData is obtained the list page (e.g. https://atcoder.jp/contests/agc001/tasks )

Variables

• alphabet – str

• memory_limit_byte – int

• name – str

• problem – AtCoderProblem

• time_limit_msec – str

property html

Return type

bytes

property name

for example of Problem:

• 器物損壊！高橋君

• AtCoDeerくんと変なじゃんけん / AtCoDeer and Rock-Paper

• Xor Sum

Return type

str

property problem

Return type

AtCoderProblem

property response

Return type

Optional[Response]

property session

Return type

Optional[Session]

property timestamp

Return type

Optional[datetime]

class onlinejudge.service.atcoder.AtCoderProblemDetailedData(*, available_languages, input_format, sample_cases, score, **kwargs)

Bases: onlinejudge.service.atcoder.AtCoderProblemData

Note

AtCoderProblemDetailedData is obtained the problem page (e.g. https://atcoder.jp/contests/agc001/tasks/agc001_a )

Variables

• available_languages – Optional [ List [ Language ] ]

• input_format – Optional [ str ]

• sample_cases – Optional [ List [ TestCase ] ]

• score – Optional [ float ]

classmethod from_html(html, *, problem, session=None, response=None, timestamp=None)

Parameters

html (bytes) – must be a HTML of the new (beta) version of AtCoder

New in version 6.2.0.

Return type

AtCoderProblemDetailedData

property sample_cases

Return type

Optional[List[TestCase]]

class onlinejudge.service.atcoder.AtCoderService

Bases: onlinejudge.type.Service

classmethod from_url(url)

Parameters

url (str) – example:

• https://atcoder.jp/

• http://agc012.contest.atcoder.jp/

Return type

Optional[AtCoderService]

get_name()

example:

• AtCoder

• Codeforces

• PKU JudgeOnline

Note

If you want something like identifier (e.g. atcoder, codeforces or poj), you can use a domain obtained from get_url().

Return type

str

get_url()

Return type

str

get_url_of_login_page()

Return type

str

get_user_history_url(user_id)

Return type

str

is_logged_in(*, session=None)

Return type

bool

iterate_contest_data(*, lang='ja', session=None)

Parameters

lang (str) – must be ja (default) or en.

Note

lang=ja is required to see some Japanese-local contests.

Note

You can use lang=en to see the English names of contests.

Return type

Iterator[AtCoderContestData]

iterate_contests(*, lang='ja', session=None)

Return type

Iterator[AtCoderContest]

login(*, get_credentials, session=None)

Raises

LoginError –

Return type

None

class onlinejudge.service.atcoder.AtCoderSubmission(*, contest_id, submission_id)

Bases: onlinejudge.type.Submission

Variables

• contest_id – str

• submission_id – str

download_data(*, session=None)

Note

Exec Time is undefined when the status is RE or TLE

Note

Memory is undefined when the status is RE or TLE

Return type

AtCoderSubmissionDetailedData

download_problem(*, session=None)

Return type

AtCoderProblem

classmethod from_url(s)

Return type

Optional[AtCoderSubmission]

get_problem()

Raises

Exception –

Note

There is no way to reconstruct problem_id without networking

Return type

AtCoderProblem

get_service()

Return type

AtCoderService

get_url(*, type=None, lang=None)

Return type

str

class onlinejudge.service.atcoder.AtCoderSubmissionData(*, code_size, exec_time_msec, language_name, memory_byte, problem, problem_id, response, score, session, status, submission, submission_time, timestamp, user_id)

Bases: onlinejudge.type.SubmissionData

Variables

• alphabet – str

• memory_limit_byte – int

• name – str

• problem – AtCoderProblem

• time_limit_msec – str

property problem

Return type

AtCoderProblem

property response

Return type

Optional[Response]

property session

Return type

Optional[Session]

property status

Return type

str

property submission

Return type

AtCoderSubmission

property timestamp

Return type

Optional[datetime]

class onlinejudge.service.atcoder.AtCoderSubmissionDetailedData(*, source_code, compile_error, test_sets, test_cases, **kwargs)

Bases: onlinejudge.service.atcoder.AtCoderSubmissionData

property source_code

Return type

bytes

class onlinejudge.service.atcoder.AtCoderSubmissionTestCaseResult(*, case_name, status, exec_time_msec, memory_byte)

Bases: object

Variables

• case_name – str

• status – str

• exec_time_msec – int in millisecond

• memory_byte – int in byte

class onlinejudge.service.atcoder.AtCoderSubmissionTestSet(*, set_name, score, max_score, test_case_names)

Bases: object

Variables

• set_name – str

• score – float

• max_score – float

• test_case_names – List [ str ]