oioioi.pa.controllers

Module Contents

Classes

PARegistrationController	A base class for classes which should have a list of subclasses
PAContestController	Contains the contest logic and rules.
PARankingController	Problems in a PA style contest are divided into two divisions
PADivCRankingController	Problems in a PA style contest are divided into two divisions
PAFinalsContestController	Contains the contest logic and rules.
PADivCContestController	Contains the contest logic and rules.

Attributes

auditLogger
A_PLUS_B_RANKING_KEY
B_RANKING_KEY

oioioi.pa.controllers.auditLogger

class oioioi.pa.controllers.PARegistrationController(contest)

Bases: oioioi.participants.controllers.ParticipantsController

A base class for classes which should have a list of subclasses available.

The list of subclasses is available in their subclasses class attributes. Classes which have explicitly set abstract class attribute to True are not added to subclasses.

If a class has modules_with_subclasses attribute (list or string), then specified modules for all installed applications can be loaded by calling load_subclasses().

property form_class

property participant_admin

classmethod anonymous_can_enter_contest()

Determines if an anonymous user can enter the contest.

Allowed anonymous users will have limited functionality, but they can see the problems, review questions etc. Modules should give them as much functionality as reasonably possible.

Return type

bool

allow_login_as_public_name()

Determines if participants may choose to stay anonymous, i.e. use their logins as public names.

can_enter_contest(request)

Determines if the current user is allowed to enter the contest, i.e. see any page related to the contest.

The default implementation uses filter_visible_contests() with a single-element contest queryset.

Return type

bool

visible_contests_query(request)

Provides a django.db.models.Q expression which can be used on oioioi.contests.models.Contest queryset already limited to contests using this controller to filter for contests the user can enter.

It must not make use of attribute contest of the controller, as it is not guaranteed to be set. It is called with None contest in :function:`oioioi.contests.utils.visible_contests`.

can_register(request)

can_unregister(request, participant)

registration_view(request)

mixins_for_admin()

Returns an iterable of mixins to add to the default oioioi.contests.admin.ContestAdmin for the contest.

The default implementation returns an empty tuple.

can_change_terms_accepted_phrase(request)

Returns

Whether the given contest has custom registered

participants (like the ones in OI and PA). Then and only then we allow to change terms accepted phrase.

class oioioi.pa.controllers.PAContestController(contest)

Bases: oioioi.programs.controllers.ProgrammingContestController

Contains the contest logic and rules.

This is the computerized implementation of the contest’s official rules.

description

create_forum = True

fill_evaluation_environ(environ, submission)

update_user_result_for_problem(result)

registration_controller()

ranking_controller()

separate_public_results()

Determines if there should be two separate dates for personal results (when participants can see their scores for a given round) and public results (when round ranking is published).

Depending on the value returned, contest admins can see and modify both Results date and Public results date or only the first one.

Return type

bool

can_submit(request, problem_instance, check_round_times=True)

Determines if the current user is allowed to submit a solution for the given problem.

The default implementation checks if the user is not anonymous, and if the round is active for the given user. Subclasses should also call this default implementation.

can_see_publicsolutions(request, round)

solutions_must_be_public(qs)

get_division_choices()

adjust_upload_form(request, existing_problem, form)

fill_upload_environ(request, form, env)

get_default_safe_exec_mode()

get_allowed_languages()

Determines which languages are allowed for submissions.

oioioi.pa.controllers.A_PLUS_B_RANKING_KEY = ab

oioioi.pa.controllers.B_RANKING_KEY = b

class oioioi.pa.controllers.PARankingController(contest)

Bases: oioioi.rankings.controllers.DefaultRankingController

Problems in a PA style contest are divided into two divisions (A and B). It is also possible to set a problem’s division to None.

There are three types of rankings in a PA style contest.

1. Trial round ranking. The key (the id) of such a ranking is the id of some trial round (there may be more than one trial round in a contest). Problems displayed in the ranking are the problems attached to the round whose division is set to None.

2. Division B ranking (key = B_RANKING_KEY). It consists of all problems from non-trial rounds whose division is set to B.

3. A + B ranking (key = A_PLUS_B_RANKING_KEY). It consists of problems from both divisions and from all non-trial rounds.

Note that if a problem belongs to A or B and is attached to a trial round, it won’t belong to any ranking. The same applies to problems in non-trial rounds with division set to None.

description

_rounds_for_ranking(request, partial_key=CONTEST_RANKING_KEY)

_rounds_for_key(key)

available_rankings(request)

Returns a list of available rankings.

Each ranking is a pair (key, description).

_filter_pis_for_ranking(partial_key, queryset)

_allow_zero_score()

class oioioi.pa.controllers.PADivCRankingController(contest)

Bases: PARankingController

Problems in a PA style contest are divided into two divisions (A and B). It is also possible to set a problem’s division to None.

There are three types of rankings in a PA style contest.

1. Trial round ranking. The key (the id) of such a ranking is the id of some trial round (there may be more than one trial round in a contest). Problems displayed in the ranking are the problems attached to the round whose division is set to None.

2. Division B ranking (key = B_RANKING_KEY). It consists of all problems from non-trial rounds whose division is set to B.

3. A + B ranking (key = A_PLUS_B_RANKING_KEY). It consists of problems from both divisions and from all non-trial rounds.

Note that if a problem belongs to A or B and is attached to a trial round, it won’t belong to any ranking. The same applies to problems in non-trial rounds with division set to None.

description

available_rankings(request)

Returns a list of available rankings.

Each ranking is a pair (key, description).

_filter_pis_for_ranking(partial_key, queryset)

class oioioi.pa.controllers.PAFinalsContestController(contest)

Bases: oioioi.acm.controllers.ACMContestController

Contains the contest logic and rules.

This is the computerized implementation of the contest’s official rules.

description

registration_controller()

can_print_files(request)

can_see_livedata(request)

is_onsite()

Determines whether the contest is on-site.

default_can_see_ranking(request)

get_round_freeze_time(round)

Returns time after which any further updates should be non-public.

get_safe_exec_mode()

Determines execution mode when USE_UNSAFE_EXEC is False.

Return ‘sio2jail’ if you want to use SIO2Jail. Otherwise return ‘cpu’.

class oioioi.pa.controllers.PADivCContestController(contest)

Bases: PAContestController

Contains the contest logic and rules.

This is the computerized implementation of the contest’s official rules.

description

ranking_controller()

get_division_choices()