Ng*dZddlmZddlmZmZddlmZddlm Z m Z m Z ddl m Z ddlmZmZmZmZe rddl mZee_ee_Gd d eeZGd d eZGd deeZGddeeZGddeeZGddeeZGddeeZGddeeZdS)atProvide classes to stand in for PDF objects. The purpose of these is to provide nice-looking classes to allow explicit construction of PDF objects and more pythonic idioms and facilitate discovery by documentation generators and linters. It's also a place to narrow the scope of input types to those more easily converted to C++. There is some deliberate "smoke and mirrors" here: all of the objects are truly instances of ``pikepdf.Object``, which is a variant container object. The ``__new__`` constructs a ``pikepdf.Object`` in each case, and the rest of the class definition is present as an aide for code introspection. ) annotations)IterableMapping) token_urlsafe) TYPE_CHECKINGAnycast)_core)MatrixObject ObjectType Rectangle)PdfceZdZdZddZdS) _ObjectMetazSupport instance checking.instancerreturnboolcRt|turdS|j|jkS)NF)typer object_type _type_code)selfrs K/var/www/html/ai-engine/env/lib/python3.11/site-packages/pikepdf/objects.py__instancecheck__z_ObjectMeta.__instancecheck__0s) >> ' '58#666N)rrrr)__name__ __module__ __qualname____doc__rrrrr-s.$$777777rrc*eZdZdZddZdd Zdd Zd S)_NameObjectMetaz9Support usage pikepdf.Name.Whatever -> Name('/Whatever').attrstrrNamec|ds|dkrtt|Std|zS)N_r/) startswithgetattrrr&)rr$s r __getattr__z_NameObjectMeta.__getattr__:sB ??3   .4=#8#8;-- -C$JrvaluerNonec td)NzgAttributes may not be set on pikepdf.Name. Perhaps you meant to modify a Dictionary rather than a Name?)AttributeError)rr$r-s r __setattr__z_NameObjectMeta.__setattr__?s 6   ritemcl|dr |dd}td|d|d)Nr)zHpikepdf.Name is not subscriptable. You probably meant: pikepdf.Name.z or pikepdf.Name('/z') )r* TypeError)rr2s r __getitem__z_NameObjectMeta.__getitem__Hs[ ??3   8D - $ - -#' - - -   rN)r$r%rr&)r$r%r-rrr.)r2r%rr.)rrrr r,r1r6r!rrr#r#7sVCC              rr#cBeZdZdZejZddZeddd Z d S)r&aNConstruct a PDF Name object. Names can be constructed with two notations: 1. ``Name.Resources`` 2. ``Name('/Resources')`` The two are semantically equivalent. The former is preferred for names that are normally expected to be in a PDF. The latter is preferred for dynamic names and attributes. name str | Namerct|trtdt|tr|St j|S)zConstruct a PDF Name.zName should be str) isinstancebytesr5r&r _new_nameclsr8s r__new__z Name.__new__csL dE " " 2011 1 dD ! ! Kt$$$rlen_intprefixr%cRt|}tjd||S)a`Generate a cryptographically strong, random, valid PDF Name. If you are inserting a new name into a PDF (for example, name for a new image), you can use this function to generate a cryptographically strong random name that is almost certainly already not already in the PDF, and not colliding with other existing names. This function uses Python's secrets.token_urlsafe, which returns a URL-safe encoded random number of the desired length. An optional *prefix* may be prepended. (The encoding is ultimately done with :func:`base64.urlsafe_b64encode`.) Serendipitously, URL-safe is also PDF-safe. When the length parameter is 16 (16 random bytes or 128 bits), the result is probably globally unique and can be treated as never colliding with other names. The length of the returned string may vary because it is encoded, but will always have ``8 * len_`` random bits. Args: len_: The length of the random string. prefix: A prefix to prepend to the random string. r))rr r=)r?rCrE random_strings rrandomz Name.randomms/4&d++ :6:=::;;;rN)r8r9rr&)rArB)rCrDrEr%rr&) rrrr r name_rr@ classmethodrHr!rrr&r&Ssa  "K%%%%<<<<[<<s rr@zOperator.__new__sJ 3D 9 9:::rN)r8r%rrM)rrrr r operatorrr@r!rrrMrMs<  %K;;;;;;rrMc(eZdZdZejZddZdS)StringzConstruct a PDF String object.s str | bytesrc|t|trtj|Stj|S)zConstruct a PDF String. Args: s: The string to use. String will be encoded for PDF, bytes will be constructed without encoding. )r;r<r _new_string_new_string_utf8)r?rSs rr@zString.__new__s8 a   ($Q'' '%a(((rN)rSrTrrR)rrrr r stringrr@r!rrrRrRs6((#K ) ) ) ) ) )rrRc*eZdZdZejZdddZdS) ArrayzConstruct a PDF Array object.Na$Iterable | Rectangle | Matrix | Nonercbt|ttfrtd|g}nlt|tt fr|St|tr'tt| Stj |S)zConstruct a PDF Array. Args: a: An iterable of objects. All objects must be either `pikepdf.Object` or convertible to `pikepdf.Object`. z.Strings cannot be converted to arrays of chars) r;r%r<r5rr as_arrayrZr __copy__r _new_array)r?r[s rr@z Array.__new__s a#u & & NLMM M 9AA Iv. / / -::<<  5 ! ! -qzz||,, ,"""rN)r[r\rrZ)rrrr r arrayrr@r!rrrZrZs;''"K#######rrZc*eZdZdZejZdddZdS) Dictionaryz"Construct a PDF Dictionary object.NdMapping | Nonerc |r|td|r0tjd|DSt |t r|S|si}|r:td|Drtdtj|S)aConstruct a PDF Dictionary. Works from either a Python ``dict`` or keyword arguments. These two examples are equivalent: .. code-block:: python pikepdf.Dictionary({'/NameOne': 1, '/NameTwo': 'Two'}) pikepdf.Dictionary(NameOne=1, NameTwo='Two') In either case, the keys must be strings, and the strings correspond to the desired Names in the PDF Dictionary. The values must all be convertible to `pikepdf.Object`. Nz1Cannot use both a mapping object and keyword argsc i|] \}}d|z| S)r)r!).0kvs r z&Dictionary.__new__..s")R)R)R41a37Q)R)R)Rrc3NK|] }|dkp|d V!dS)r)N)r*)rikeys r z%Dictionary.__new__..s:OOsSCZ:s~~c':':#:OOOOOOrz3Dictionary created from strings must begin with '/') ValueErrorr _new_dictionaryitemsr;rdr_anykeysKeyError)r?rekwargss rr@zDictionary.__new__s"  RamPQQ Q  T()R)R6<<>>)R)R)RSS S a $ $ ::<<  A  ROOaffhhOOOOO RPQQ Q$Q'''rra)rerfrrd)rrrr r dictionaryrr@r!rrrdrds;,,'K(((((((rrdc*eZdZdZejZd d dZdS) StreamzConstruct a PDF Stream object.Nownerrdata bytes | Nonerc |tdd}|s|r t|fi|}tj||}|r||_|S)aCreate a new stream object. Streams stores arbitrary binary data and may or may not be compressed. It also may or may not be a page or Form XObject's content stream. A stream dictionary is like a pikepdf.Dictionary or Python dict, except it has a binary payload of data attached. The dictionary describes how the data is compressed or encoded. The dictionary may be initialized just like pikepdf.Dictionary is initialized, using a mapping object or keyword arguments. Args: owner: The Pdf to which this stream shall be attached. data: The data bytes for the stream. d: An optional mapping object that will be used to construct the stream's dictionary. kwargs: Keyword arguments that will define the stream dictionary. Do not set /Length here as pikepdf will manage this value. Set /Filter if the data is already encoded in some format. Examples: Using kwargs: >>> pdf = pikepdf.Pdf.new() >>> s1 = pikepdf.Stream( ... pdf, ... b"uncompressed image data", ... BitsPerComponent=8, ... ColorSpace=pikepdf.Name.DeviceRGB, ... ) Using dict: >>> pdf = pikepdf.Pdf.new() >>> d = pikepdf.Dictionary(Key1=1, Key2=2) >>> s2 = pikepdf.Stream( ... pdf, ... b"data", ... d ... ) .. versionchanged:: 2.2 Support creation of ``pikepdf.Stream`` from existing dictionary. .. versionchanged:: 3.0 ``obj`` argument was removed; use ``data``. Nz!Must make Stream from binary data)r5rdr _new_stream stream_dict)r?rzr{rervrstreams rr@zStream.__new__si\ <?@@ @  2 2$Q11&11K"5$//  -!,F  r)NN)rzrr{r|rry)rrrr r rrr@r!rrryrys;((#K8888888rryN)r __future__rcollections.abcrrsecretsrtypingrrr pikepdfr pikepdf._corer r r rrrrrrr#r&rMrRrZrdryr!rrrs]  #"""""--------"!!!!!++++++++++????????????  77777$$v,,777     k   85<5<5<5<5<6_5<5<5<5