lh.dZddlZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z ddl mZdZd Zd Ziad Zd Zejd ZGddeZGdde eeZGddejZeZdS)z:mod:`wand.resource` --- Global resource management ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There is the global resource to manage in MagickWand API. This module implements automatic global resource management through reference counting. N)library)abc string_type)TYPE_MAP WandException)MAGICK_VERSION_NUMBER)genesislimitsshutdownterminusDestroyedResourceErrorResourceResourceLimitsc,tjdS)zInstantiates the MagickWand API. .. warning:: Don't call this function directly. Use :func:`increment_refcount()` and :func:`decrement_refcount()` functions instead. N)rMagickWandGenesisP/var/www/html/research.buxo.ca/env/lib/python3.11/site-packages/wand/resource.pyr r s rctjtjdStjrtjdSdS)zCleans up the MagickWand API. .. warning:: Don't call this function directly. Use :func:`increment_refcount()` and :func:`decrement_refcount()` functions instead. N)rIsMagickWandInstantiatedMagickWandTerminusrrrr r "sR'/"$$$$$  ) + +%"$$$$$%%rcnttdkrt|r |t|<dSdSNr)lenallocation_mapr addr deallocators r allocate_refr 4s@ >a  +*t++rc|ttvr6t|}t|r||dSdSdSN)listrpopcallablers rdeallocate_refr&<s` tN####$((.. K   K     $#  rcttD]G} t|}t|r ||8#t$rYDwxYwt dSr")r#rr$r%KeyErrorr rs rr r Ds^$$ (,,T22K $$ " D!!!    D  JJJJJs4A  AAceZdZdZeZeZeZeZe dZ e j dZ e j dZ e jdZdZdZdd Zdd Zd Zd ZdZd S)raAbstract base class for MagickWand object that requires resource management. Its all subclasses manage the resource semiautomatically and support :keyword:`with` statement as well:: with Resource() as resource: # use the resource... pass It doesn't implement constructor by itself, so subclasses should implement it. Every constructor should assign the pointer of its resource data into :attr:`resource` attribute inside of :keyword:`with` :meth:`allocate()` context. For example:: class Pizza(Resource): '''My pizza yummy.''' def __init__(self): with self.allocate(): self.resource = library.NewPizza() .. versionadded:: 0.1.2 cpt|ddtt|dz|jS)zInternal pointer to the resource instance. It may raise :exc:`DestroyedResourceError` when the resource has destroyed already. c_resourceNz is destroyed already)getattrrreprr+selfs rresourcezResource.resources8 4t , , 4(d6M)MNN Nrct|ddr|||r#||_t |j|jdSt t|dz)Nr+z is an invalid resource)r,destroy c_is_resourcer+r c_destroy_resource TypeErrorr-r/r0s rr0zResource.resourcesx 4t , ,  LLNNN   h ' ' H&DO $*A B B B B BDNN-FFGG Grc^t|ddrt|jd|_dS)Nr+)r,r&r+r.s rr0zResource.resources1 4t , , , 4? + + +rc#.Kt|VdS)a$Allocates the memory for the resource explicitly. Its subclasses should assign the created resource into :attr:`resource` attribute inside of this context. For example:: with resource.allocate(): resource.resource = library.NewResource() N)r r.s rallocatezResource.allocates   rc |`dS)zCleans up the resource explicitly. If you use the resource in :keyword:`with` statement, it was called implicitly so have not to call it. N)r0r.s rr2zResource.destroys MMMrctj}||jtj|}|jdkr|rt j|}dS||jt|j}|r)tj |}t j|}nd}t|ts| d}||S)zGets a current exception instance. :returns: a current exception. it can be ``None`` as well if any errors aren't occurred :rtype: :class:`wand.exceptions.WandException` rNrreplace)errors)ctypesc_intc_get_exceptionr0byrefvaluerMagickRelinquishMemoryc_clear_exceptionr string_at isinstancerdecode)r/severitydescexc_clsmessages r get_exceptionzResource.get_exceptions<>>##DM6<3I3IJJ >Q   <5d;; F t}---8>*  &t,,G1$77DDG';// 7nnIn66Gwwrrc|}t|trtj||dzdSt|t r|dS)z2Raises an exception or warning if it has occurred.r) stacklevelN)rLrFWarningwarningswarn Exception)r/rNes rraise_exceptionzResource.raise_exceptionse     a ! !  M! Q 7 7 7 7 7 7 9 % % G  rNctr")NotImplementedError)r/formats r make_blobzResource.make_blobs!!rc|Sr"rr.s r __enter__zResource.__enter__s rc.|dSr")r2)r/typerB tracebacks r__exit__zResource.__exit__s rcR |dS#t$rYdSwxYwr")r2rr.s r__del__zResource.__del__s:  LLNNNNN%    DD s  &&)rr")__name__ __module__ __qualname____doc__NotImplementedr3r4r@rDpropertyr0setterdeleter contextlibcontextmanagerr9r2rLrTrXrZr^r`rrrrrQs'@#M(%O' X_ H H_ H       2""""rrceZdZdZdS)rzAn error that rises when some code tries access to an already destroyed resource. .. versionchanged:: 0.3.0 It becomes a subtype of :exc:`wand.exceptions.WandException`. N)rarbrcrdrrrrrsrrcVeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdS)raWrapper for MagickCore resource limits. Useful for dynamically reducing system resources before attempting risky, or slow running, :class:`~wand.image.Image` operations. For example:: from wand.image import Image from wand.resource import limits # Use 100MB of ram before writing temp data to disk. limits['memory'] = 1024 * 1024 * 100 # Reject images larger than 1000x1000. limits['width'] = 1000 limits['height'] = 1000 # Debug resources used. with Image(filename='user.jpg') as img: print('Using {0} of {1} memory'.format(limits.resource('memory'), limits['memory'])) # Dump list of all limits. for label in limits: print('{0} => {1}'.format(label, limits[label])) Available resource keys: - ``'area'`` - Maximum `width * height` of a pixel cache before writing to disk. - ``'disk'`` - Maximum bytes used by pixel cache on disk before exception is thrown. - ``'file'`` - Maximum cache files opened at any given time. - ``'height'`` - Maximum height of image before exception is thrown. - ``'list_length'`` - Maximum images in sequence. Only available with recent version of ImageMagick. - ``'map'`` - Maximum memory map in bytes to allocated for pixel cache before using disk. - ``'memory'`` - Maximum bytes to allocated for pixel cache before using disk. - ``'thread'`` - Maximum parallel task sub-routines can spawn - if using OpenMP. - ``'throttle'`` - Total milliseconds to yield to CPU - if possible. - ``'time'`` - Maximum seconds before exception is thrown. - ``'width'`` - Maximum width of image before exception is thrown. .. versionadded:: 0.5.1 ) undefinedareadiskfilemapmemorythreadtimethrottlewidthheight) rmrnrorprwrqrrrsrurtrv list_lengthcPtdkr|j|_dS|j|_dS)Ni)r _limits6r _limits7r.s r__init__zResourceLimits.__init__5s' 5 ( (-DKKK-DKKKrc,||Sr")get_resource_limitr/rs r __getitem__zResourceLimits.__getitem__;s&&q)))rc2|||dSr")set_resource_limit)r/rvs r __setitem__zResourceLimits.__setitem__>s 1%%%%%rcd||<dSrrrs r __delitem__zResourceLimits.__delitem__AsQrc*t|jSr")iterr r.s r__iter__zResourceLimits.__iter__DsDK   rc*t|jSr")rr r.s r__len__zResourceLimits.__len__Gs4;rc6|j|S)z3Helper method to map resource string to enum value.)r indexr6s r_to_idxzResourceLimits._to_idxJs{  ***rcPtj||S)zGet the current value for the resource type. :param resource: Resource type. :type resource: :class:`basestring` :rtype: :class:`numeric.Integral` .. versionadded:: 0.5.1 )rMagickGetResourcerr6s rr0zResourceLimits.resourceNs!(h)?)?@@@rclttj||S)zGet the current limit for the resource type. :param resource: Resource type. :type resource: :class:`basestring` :rtype: :class:`numeric.Integral` .. versionadded:: 0.5.1 )r rMagickGetResourceLimitrr6s rr~z!ResourceLimits.get_resource_limitYs*  -dll8.D.DEEErcttj|}tj|||dS)aSets a new limit for resource type. .. note:: The new limit value must be equal to or less than the maximum limit defined by the :file:`policy.xml`. Any values set outside normal bounds will be ignored silently. :param resource: Resource type. :type resource: :class:`basestring` :param limit: New limit value. :type limit: :class:`numeric.Integral` .. versionadded:: 0.5.1 N)r r> c_ulonglongrMagickSetResourceLimitr)r/r0limitulls rrz!ResourceLimits.set_resource_limitesB   ''&t||H'='=sCCCCCrN)rarbrcrdrzr{r|rrrrrrr0r~rrrrrrs--`7HFH((( ***&&&!!!   +++ A A A F F FDDDDDrr)rdatexitrir>rPapircompatrr exceptionsrrversionr __all__r r rr r&registerr objectrReferenceErrorAttributeErrorrMutableMappingrr rrrrs  $$$$$$$$////////****** C     % % %+++   _____v___D]NNzDzDzDzDzDS'zDzDzD@   r