:py:mod:`oioioi.confirmations.utils`
====================================

.. py:module:: oioioi.confirmations.utils


Module Contents
---------------


Functions
~~~~~~~~~

.. autoapisummary::

   oioioi.confirmations.utils.sign_submission_metadata
   oioioi.confirmations.utils.unsign_submission_metadata
   oioioi.confirmations.utils.submission_receipt_proof
   oioioi.confirmations.utils.grouper
   oioioi.confirmations.utils.format_proof
   oioioi.confirmations.utils.verify_submission_receipt_proof
   oioioi.confirmations.utils.send_submission_receipt_confirmation



Attributes
~~~~~~~~~~

.. autoapisummary::

   oioioi.confirmations.utils.SUBMISSION_RECEIVED_SALT
   oioioi.confirmations.utils.logger


.. py:data:: SUBMISSION_RECEIVED_SALT
   :annotation: = submission_reveived

   

.. py:data:: logger
   

   

.. py:exception:: ProofCorrupted

   Bases: :py:obj:`ValueError`

   Inappropriate argument value (of correct type).


.. py:function:: sign_submission_metadata(data)


.. py:function:: unsign_submission_metadata(data)


.. py:function:: submission_receipt_proof(submission)

   Returns pair of data and its signed version which may be used by
   the user to prove that we received his submission someday.

   The returned data are not encrypted, just signed.


.. py:function:: grouper(n, iterable, fillvalue=None)

   grouper(3, 'ABCDEFG', 'x') --> ABC DEF Gxx


.. py:function:: format_proof(proof)


.. py:function:: verify_submission_receipt_proof(proof, source)

   Verifies a signed proof of user's submission and returns proven
   metadata.

   :raises :class:`ProofCorrupted` upon failure of any reason.


.. py:function:: send_submission_receipt_confirmation(request, submission)