Administrative Modules

hedwig.admin.poll

hedwig.admin.poll.close_completed_call(db, dry_run=False, _test_date=None)

Close calls for which the submission deadline has passed.

hedwig.admin.poll.close_completed_mid_call(db, dry_run=False, _test_date=None)

Process intermediate call closures.

hedwig.admin.poll._closure_deadline()

Get the closure deadline for use in finding calls to close.

This returns the current UT time less the configured grade period.

hedwig.admin.poll.send_proposal_feedback(db, dry_run=False)

Send feedback for proposals when have been reviewed.

Finds proposals which:

• Are in the FINAL_REVIEW state.

• Have decisions defined and marked “ready”.

and then groups the proposals by call and passes them to send_call_feedback so that the feedback email messages can include aggregate information about the call.

hedwig.admin.proposal

exception hedwig.admin.proposal.FeedbackError(fmt_string, *fmt_args)

hedwig.admin.proposal.close_call_proposals(db, call_id, dry_run=False)

Function to update the status of proposals at the closure of a call.

• Sets the status to REVIEW (or ABANDONED if not submitted).

• Freezes proposal member institutions.

• Writes the member institutions into the member table.

hedwig.admin.proposal.close_mid_call(db, call_id, mid_close_id, dry_run=False)

Function to process an intermediate closure for a call.

• Sets the status of SUBMITTED proposals to REVIEW.

• Freezes proposal member institutions.

• Marks the intermediate closure as closed.

hedwig.admin.proposal._close_proposal(db, proposal, new_state, dry_run=False)

hedwig.admin.proposal._message_call_closed(db, call, n_proposal, is_mid_close, dry_run=False)

hedwig.admin.proposal.finalize_call_review(db, call_id, proposals=None)

Function to update the status of proposals at the closure of a review process, prior to the final decision making process of the time allocation committee.

• Sets the status to FINAL_REVIEW.

Parameters:

• db – database access object

• call_id – identifer of call to update

• proposals – list of Proposal objects when individual proposals are to be selected. If this is not specified, then all proposals for the given call are updated.

Note

This function simply sets the state of the corresponding proposals, so it can be used from the web interface. If it ever needs to do more work than this, it should be run offline in the poll process and gain logger output. An alternative way to specify individual proposals may also be required.

hedwig.admin.proposal.send_call_proposal_feedback(db, call_id, proposals, dry_run=False)

Sends feedback for the given proposals.

Applies the following action to each of the given proposals:

• Sets the status to ACCEPTED or REJECTED based on the decision.

• Write a feedback email message into the database including the feedback report.

The proposals argument must be a list of Proposal objects including the feedback reviews, decision note and all members.