OAi*NSrSSKJr SSKJrJr SSKJr SSKJ r J r J r SSK J r SSKJrJrJrJr \ (aSSK Jr \\l\\l"S S \"\55r"S S \5r"S S\\S9r"SS\\S9r"SS\\S9r"SS\\S9r"SS\\S9r"SS\\S9rg)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)Pdfc"\rSrSrSrSSjrSrg) _ObjectMeta-zSupport instance checking.cZ[U5[LagURUR:H$)NF)typer object_type _type_code)selfinstances K/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pikepdf/objects.py__instancecheck___ObjectMeta.__instancecheck__0s( > '8#6#666N)rrreturnbool)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__rrrrr-s $7rrc6\rSrSrSrSSjrS SjrS SjrSrg) _NameObjectMeta7z9Support usage pikepdf.Name.Whatever -> Name('/Whatever').cvURS5(dUS:Xa[[U5$[SU-5$)N_r/) startswithgetattrrName)rattrs r __getattr___NameObjectMeta.__getattr__:s4 ??3  4=#8;- -C$Jrc[S5e)NzgAttributes may not be set on pikepdf.Name. Perhaps you meant to modify a Dictionary rather than a Name?)AttributeError)rr/values r __setattr___NameObjectMeta.__setattr__?s 6  rc\URS5(aUSSn[SUSUS35e)Nr+zHpikepdf.Name is not subscriptable. You probably meant: pikepdf.Name.z or pikepdf.Name('/z') )r, TypeError)ritems r __getitem___NameObjectMeta.__getitem__HsD ??3  8D $v&""&t -  rrN)r/strrr.)r/r=r4rrNone)r:r=rr>) r r!r"r#r$r0r5r;r%rrrr'r'7sC   rr'cR\rSrSrSr\R rSSjr\ SS Sjj5r Sr g) r.Sa2Construct 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. c[U[5(a [S5e[U[5(aU$[R "U5$)zConstruct a PDF Name.zName should be str) isinstancebytesr9r.r _new_nameclsnames r__new__ Name.__new__cs> dE " "01 1 dD ! !Kt$$rcN[U5n[R"SUU35$)aGenerate 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 rD)rFlen_prefix random_strings rrandom Name.randomms(4&d+ 6(=/:;;rrN)rGz str | Namerr.))rKintrLr=rr.) r r!r"r#r$r name_rrH classmethodrNr%rrrr.r.Ss- ""K%<\rSrSrSr\R rSSSjjrSr g)ArrayzConstruct a PDF Array object.NcF[U[[-5(a [S5eUc/nO_[U[[ -5(aUR 5$[U[5(a[[UR55$[R"U5$)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) rBr=rCr9rr as_arrayrgr __copy__r _new_array)rFas rrH Array.__new__sz au % %LM M 9A 9v- . .::<  5 ! !qzz|, ,""rrN)rmz$Iterable | Rectangle | Matrix | Nonerrg) r r!r"r#r$r arrayrrHr%rrrrgrgs'""K##rrgc>\rSrSrSr\R rSSSjjrSr g) Dictionaryz"Construct a PDF Dictionary object.Nc U(aUb [S5eU(a=[R"UR5VVs0sH up4SU-U_M snn5$[ U[ 5(aUR 5$U(d0nU(a0[SUR555(a [S5e[R"U5$s snnf)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`. z1Cannot use both a mapping object and keyword argsr+c3d# UH&oS:H=(d URS5(+v M( g7f)r+N)r,).0keys r %Dictionary.__new__..s&OhsCZ:s~~c':#::hs.0z3Dictionary created from strings must begin with '/') ValueErrorr _new_dictionaryitemsrBrrrkanykeysKeyError)rFdkwargskvs rrHDictionary.__new__s" amPQ Q ((6<<>)R>4137Q;>)RS S a $ $::< A OaffhOOOPQ Q$$Q''*SsC rro)rzMapping | Nonerrr) r r!r"r#r$r dictionaryrrHr%rrrrrrrs,''K((rrrc>\rSrSrSr\R rSSSjjrSr g)StreamzConstruct a PDF Stream object.Nc Uc [S5eSnU(dU(a [U40UD6n[R"X5nU(aXVlU$)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)r9rrr _new_stream stream_dict)rFownerdatarrrstreams rrHStream.__new__sM\ <?@ @ $Q1&1K""5/ !,  rr)NN)rrrz bytes | Nonerr) r r!r"r#r$r rrrHr%rrrrrs(##K88rrN)r$ __future__rcollections.abcrrsecretsrtypingrrr pikepdfr pikepdf._corer r r rrr r!rrr'r.rWr^rgrrrrrrrs #-"++??  7$v,7 k 85<6_5