hs `dZddlmZddlmZddlZddlmZddlmZddl m Z ddl m Z dd l mZdd lmZd d lmZd d lmZmZgdZ dde dededeedee f dZ dde dededeedee f dZ dde dedejdejdeef dZdS) z< This module defines pyHanko's high-level API entry points. )datetime)OptionalN)cms)embed)BasePdfFileWriter) SigFieldSpec) SigningError) TimeStamper)Signer)PdfSignatureMetadata PdfSigner)sign_pdfasync_sign_pdfembed_payload_with_cmsFpdf_outsignature_metasigner timestampernew_field_specc ||rtdt||||} | |||||S)a Thin convenience wrapper around :meth:`.PdfSigner.sign_pdf`. :param pdf_out: An :class:`.IncrementalPdfFileWriter`. :param bytes_reserved: Bytes to reserve for the CMS object in the PDF file. If not specified, make an estimate based on a dummy signature. :param signature_meta: The specification of the signature to add. :param signer: :class:`.Signer` object to use to produce the signature object. :param timestamper: :class:`.TimeStamper` object to use to produce any time stamp tokens that might be required. :param in_place: Sign the input in-place. If ``False``, write output to a :class:`.BytesIO` object. :param existing_fields_only: If ``True``, never create a new empty signature field to contain the signature. If ``False``, a new field may be created if no field matching :attr:`~.PdfSignatureMetadata.field_name` exists. :param new_field_spec: If a new field is to be created, this parameter allows the caller to specify the field's properties in the form of a :class:`.SigFieldSpec`. This parameter is only meaningful if ``existing_fields_only`` is ``False``. :param output: Write the output to the specified output stream. If ``None``, write to a new :class:`.BytesIO` object. Default is ``None``. :return: The output stream containing the signed output. NSSpecifying a signature field spec is not meaningful when existing_fields_only=True.rrexisting_fields_onlybytes_reservedin_placeoutput)r rr rrrrrrrrr pdf_signers Z/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/pyhanko/sign/signers/functions.pyrrsx^!&:! )   % J   1%   c K||rtdt||||} | |||||d{VS)a Thin convenience wrapper around :meth:`.PdfSigner.async_sign_pdf`. :param pdf_out: An :class:`.IncrementalPdfFileWriter`. :param bytes_reserved: Bytes to reserve for the CMS object in the PDF file. If not specified, make an estimate based on a dummy signature. :param signature_meta: The specification of the signature to add. :param signer: :class:`.Signer` object to use to produce the signature object. :param timestamper: :class:`.TimeStamper` object to use to produce any time stamp tokens that might be required. :param in_place: Sign the input in-place. If ``False``, write output to a :class:`.BytesIO` object. :param existing_fields_only: If ``True``, never create a new empty signature field to contain the signature. If ``False``, a new field may be created if no field matching :attr:`~.PdfSignatureMetadata.field_name` exists. :param new_field_spec: If a new field is to be created, this parameter allows the caller to specify the field's properties in the form of a :class:`.SigFieldSpec`. This parameter is only meaningful if ``existing_fields_only`` is ``False``. :param output: Write the output to the specified output stream. If ``None``, write to a new :class:`.BytesIO` object. Default is ``None``. :return: The output stream containing the signed output. Nrrr)r rrrs r!rr[s^!&:! )   % J **1% +      r".sig pdf_writerfile_spec_stringpayloadcms_obj file_namec ztjtj}tj||ddt j||} | ddd|z} d x} } |6| ddd|z} t j | | g} t j d |||t j | | g| d |pi} t j || t j d | | | d |pi}t j ||d S)a Embed some data as an embedded file stream into a PDF, and associate it with a CMS object. The resulting CMS object will also be turned into an embedded file, and associated with the original payload through a related file relationship. This can be used to bundle (non-PDF) detached signatures with PDF attachments, for example. .. versionadded:: 0.7.0 :param pdf_writer: The PDF writer to use. :param file_spec_string: See :attr:`~pyhanko.pdf_utils.embed.FileSpec.file_spec_string` in :class:`~pyhanko.pdf_utils.embed.FileSpec`. :param payload: Payload object. :param cms_obj: CMS object pertaining to the payload. :param extension: File extension to use for the CMS attachment. :param file_name: See :attr:`~pyhanko.pdf_utils.embed.FileSpec.file_name` in :class:`~pyhanko.pdf_utils.embed.FileSpec`. :param file_spec_kwargs: Extra arguments to pass to the :class:`~pyhanko.pdf_utils.embed.FileSpec` constructor for the main attachment specification. :param cms_file_spec_kwargs: Extra arguments to pass to the :class:`~pyhanko.pdf_utils.embed.FileSpec` constructor for the CMS attachment specification. )tzFzapplication/pkcs7-mime) creation_datemodification_date)r%datacompress mime_typeparams.r rN) embedded_data)r&r)r3f_related_filesuf_related_files)r&r)r3) rnowtzlocal get_localzonerEmbeddedFileObjectfrom_file_datadumpEmbeddedFileParamsrsplitRelatedFileSpecFileSpec embed_file)r%r&r'r( extensionr)file_spec_kwargscms_file_spec_kwargsr7 cms_ef_obj cms_data_f cms_data_ufr5speccms_specs r!rrs^ ,'/11 2 2 2C)88 \\^^*'   9J"((a003i?J&*)K"&&sA..q1I=  !+Z H H H  > )  !*J G G G *    !r  D Z&&&~#  %2 H  Z*****r")NNFNFN)r$NNN)__doc__rtypingrr8 asn1cryptorpyhanko.pdf_utilsrpyhanko.pdf_utils.writerrpyhanko.sign.fieldsrpyhanko.sign.generalr pyhanko.sign.timestampsr pdf_cmsr r r r__all__rrstrr: ContentInforr6r"r!rVs3######666666,,,,,,------//////77777777 B B B*.-1  AA A(A A+& A \* AAAAP*.-1  AA A(A A+& A \* AAAAR#Y+Y+!Y+Y+ %Y+_ Y+ } Y+Y+Y+Y+Y+Y+r"