Welcome to AtCoder’s documentation!

atcoder package

Submodules

atcoder.auth module

exception atcoder.auth.InvalidSessionError(message: str | None = None)[source]

Bases: Exception

DEFAULT_MESSAGE = 'Your login session is invalid. please relogin.'
class atcoder.auth.LoginCredentials(username: 'str', password: 'str')[source]

Bases: object

password: str
username: str

atcoder.constant module

atcoder.contest module

class atcoder.contest.Color(value)[source]

Bases: enum.Enum

An enumeration.

BLUE = 2
GREEN = 1
ORANGE = 3
RED = 4
class atcoder.contest.Contest(id: 'str', title: 'str', status: 'Status | None' = None, color: 'Color | None' = None, start_datetime: 'datetime.datetime | None' = None, duration: 'datetime.timedelta | None' = None)[source]

Bases: object

color: Color | None = None
duration: datetime.timedelta | None = None
id: str
start_datetime: datetime.datetime | None = None
status: Status | None = None
title: str
class atcoder.contest.Status(value)[source]

Bases: enum.Enum

An enumeration.

FINISHED = 4
PERMANENT = 2
RUNNING = 1
UPCOMING = 3
async atcoder.contest.fetch_all_contests(session: aiohttp.client.ClientSession) → AsyncIterator[atcoder.contest.Contest][source]
async atcoder.contest.fetch_finished_contests(session: aiohttp.ClientSession, page: int) → list[Contest] | None[source]
atcoder.contest.scrape_contest(html: str) → atcoder.contest.Contest[source]

atcoder.crawl module

atcoder.editorial module

atcoder.home module

atcoder.language module

class atcoder.language.Language(id: 'int', text: 'str', name: 'str', compiler_or_runtime: 'str | None' = None, version: 'str | None' = None, compile_to: 'str | None' = None, category: 'str | None' = None, file_extensions: 'list[str] | None' = None)[source]

Bases: object

category: str | None = None
compile_to: str | None = None
compiler_or_runtime: str | None = None
file_extensions: list[str] | None = None
id: int
name: str
text: str
version: str | None = None

atcoder.login module

atcoder.login.login(credentials: atcoder.auth.LoginCredentials) → requests.sessions.Session[source]

atcoder.network module

atcoder.score module

atcoder.scrape module

class atcoder.scrape.Pagination(current: 'int', last: 'int')[source]

Bases: object

current: int
last: int

atcoder.standings module

atcoder.submission module

class atcoder.submission.Details(code: 'str', judge_results: 'list[JudgeResult] | None' = None)[source]

Bases: object

code: str
judge_results: list[JudgeResult] | None = None
class atcoder.submission.JudgeResult(case_name: 'str', status: 'SubmissionStatus', exec_time_ms: 'int', memory_usage_kb: 'int')[source]

Bases: object

case_name: str
exec_time_ms: int
memory_usage_kb: int
status: atcoder.submission.SubmissionStatus
exception atcoder.submission.LanguageParseError[source]

Bases: Exception

class atcoder.submission.SubmissionResult(id: 'int', summary: 'Summary', details: 'Details | None' = None)[source]

Bases: object

details: Details | None = None
id: int
summary: Summary
class atcoder.submission.SubmissionStatus(value)[source]

Bases: enum.Enum

An enumeration.

AC = 1
CE = 7
IE = 9
JUDGING = 12
MLE = 5
OLE = 8
QLE = 6
RE = 3
TLE = 4
WA = 2
WJ = 10
WR = 11
class atcoder.submission.SubmissionsSearchParams(task_id: 'str | None' = None, language_category: 'str | None' = None, language_id: 'int | None' = None, status: 'str | None' = None, username: 'str | None' = None)[source]

Bases: object

language_category: str | None = None
language_id: int | None = None
status: str | None = None
task_id: str | None = None
username: str | None = None
class atcoder.submission.Summary(datetime: 'datetime.datetime', task_id: 'str', username: 'str', language: 'atcoder.language.Language', score: 'int', code_size_kb: 'int', status: 'SubmissionStatus', exec_time_ms: 'int | None' = None, memory_usage_kb: 'int | None' = None)[source]

Bases: object

code_size_kb: int
datetime: datetime.datetime
exec_time_ms: int | None = None
language: atcoder.language.Language
memory_usage_kb: int | None = None
score: int
status: SubmissionStatus
task_id: str
username: str
atcoder.submission.fetch_all_my_submissions(session: requests.Session, contest_id: str, params: SubmissionsSearchParams | None = None) → Iterator[SubmissionResult][source]
async atcoder.submission.fetch_all_submissions(session: aiohttp.ClientSession, contest_id: str, params: SubmissionsSearchParams | None = None) → AsyncIterator[SubmissionResult][source]
atcoder.submission.fetch_my_submissions(session: requests.Session, contest_id: str, params: SubmissionsSearchParams | None = None, page: int | None = None) → list[SubmissionResult] | None[source]
async atcoder.submission.fetch_submission_details(session: aiohttp.client.ClientSession, contest_id: str, submission_id: int) → atcoder.submission.SubmissionResult[source]
async atcoder.submission.fetch_submissions(session: aiohttp.ClientSession, contest_id: str, params: SubmissionsSearchParams | None = None, page: int | None = None) → list[SubmissionResult] | None[source]

atcoder.submit module

class atcoder.submit.SubmitPostParams(task_id: 'str', language_id: 'int', source_code: 'str', csrf_token: 'str')[source]

Bases: object

csrf_token: str
language_id: int
source_code: str
task_id: str
atcoder.submit.fetch_languages(session: requests.sessions.Session) → list[atcoder.language.Language][source]
atcoder.submit.submit_task(session: requests.sessions.Session, contest_id: str, task_id: str, source_code: str, language_id: int) → None[source]

atcoder.task module

class atcoder.task.Task(id: 'str', name: 'str | None' = None, order: 'str | None' = None, contest_id: 'str | None' = None, time_limit_ms: 'int | None' = None, memory_limit_kb: 'int | None' = None)[source]

Bases: object

contest_id: str | None = None
id: str
memory_limit_kb: int | None = None
name: str | None = None
order: str | None = None
time_limit_ms: int | None = None

atcoder.top module

atcoder.user module

atcoder.user_agent module

class atcoder.user_agent.UserSessionAgent(credentials: atcoder.auth.LoginCredentials)[source]

Bases: object

fetch_languages() → list[atcoder.language.Language][source]
fetch_my_submissions(contest_id: str, params: atcoder.submission.SubmissionsSearchParams | None = None) → Iterator[atcoder.submission.SubmissionResult][source]
submit(contest_id: str, task_id: str, source_code: str, language_id: int) → None[source]

Module contents

Indices and tables