U gs @sdZddlmZddlmZddlZddlmZddlmZddl m Z ddl m Z dd l mZdd lmZd d lmZd d lmZmZdddgZde eeeeee dddZde eeeeee dddZde eejejeedddZdS)z< This module defines pyHanko's high-level API entry points. )datetime)OptionalN)cms)embed)BasePdfFileWriter) SigFieldSpec) SigningError) TimeStamper)Signer)PdfSignatureMetadata PdfSignersign_pdfasync_sign_pdfembed_payload_with_cmsF)pdf_outsignature_metasigner timestampernew_field_specc Cs8|dk r|rtdt||||d} | j|||||dS)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)rr r rrrrrrrrr pdf_signerrB/tmp/pip-unpacked-wheel-owvgwkas/pyhanko/sign/signers/functions.pyrs"/ c s>|dk r|rtdt||||d} | j|||||dIdHS)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)rr rrrrr r[s"/ .sig) pdf_writerfile_spec_stringpayloadcms_obj file_namec Cstjtd}tjj||ddtj||dd} | ddd|} d } } |d k r|| ddd|} tj | | d g} tj f|||tj | | d g| d |pi} t || tj f| | | d |pi}t ||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)Z creation_dateZmodification_date)r"datacompressZ mime_typeparams.r rN) embedded_data)r#r&r,Zf_related_filesuf_related_files)r#r&r,) rnowtzlocalZ get_localzonerEmbeddedFileObjectZfrom_file_datadumpZEmbeddedFileParamsrsplitZRelatedFileSpecZFileSpecZ embed_file)r"r#r$r% extensionr&Zfile_spec_kwargsZcms_file_spec_kwargsr.Z cms_ef_objZ cms_data_fZ cms_data_ufr-specZcms_specrrr rsH/    )NNFNFN)NNFNFN)r!NNN)__doc__rtypingrr/Z asn1cryptorZpyhanko.pdf_utilsrZpyhanko.pdf_utils.writerrZpyhanko.sign.fieldsrZpyhanko.sign.generalrZpyhanko.sign.timestampsr Zpdf_cmsr rr r __all__rrstrr0Z ContentInforrrrr sb           H I