B |b-@sdZddlZddlZddlZddlZddlmZddlmZm Z ddl m Z m Z ddl mZdZd d Zd d Ziad dZddZejddZGdddeZGddde eeZGdddejZeZdS)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)genesislimitsshutdownterminusDestroyedResourceErrorResourceResourceLimitscCs tdS)zInstantiates the MagickWand API. .. warning:: Don't call this function directly. Use :func:`increment_refcount()` and :func:`decrement_refcount()` functions instead. N)rZMagickWandGenesisrrP/home/ankuromar296_gmail_com/.local/lib/python3.7/site-packages/wand/resource.pyr s r cCs(tjdkrtntr$tdS)zCleans up the MagickWand API. .. warning:: Don't call this function directly. Use :func:`increment_refcount()` and :func:`decrement_refcount()` functions instead. N)rZIsMagickWandInstantiatedZMagickWandTerminusrrrrr "s  r cCs"ttdkrt|r|t|<dS)Nr)lenallocation_mapr )addr deallocatorrrr allocate_ref4s rcCs*|ttkr&t|}t|r&||dS)N)listrpopcallable)rrrrrdeallocate_ref<s  rc CsPxDttD]8}yt|}t|r*||Wq tk r@Yq Xq WtdS)N)rrrrKeyErrorr )rrrrrr Ds   r c@seZdZdZeZeZeZeZe ddZ e j ddZ e j ddZ e jddZdd Zd d Zdd dZdddZddZddZddZdS)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 cCs&t|dddkr tt|d|jS)zInternal pointer to the resource instance. It may raise :exc:`DestroyedResourceError` when the resource has destroyed already. c_resourceNz is destroyed already)getattrr reprr)selfrrrresourceszResource.resourcecCsHt|ddr|||r4||_t|j|jntt|ddS)Nrz is an invalid resource)rdestroy c_is_resourcerrc_destroy_resource TypeErrorr)rr rrrr s   cCs t|ddrt|jd|_dS)Nr)rrr)rrrrr s  ccs |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() Nr)rrrrallocates zResource.allocatecCs|`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)r )rrrrr!szResource.destroycCst}||jt|}|jdkr8|r4t|}dS||jt |j}|rht |}t|}nd}t |t s|j dd}||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` rNreplace)errors)ctypesc_intc_get_exceptionr byrefvaluerZMagickRelinquishMemoryc_clear_exceptionr string_at isinstancerdecode)rZseveritydescZexc_clsmessagerrr get_exceptions        zResource.get_exceptionrcCs8|}t|tr&tj||ddnt|tr4|dS)z2Raises an exception or warning if it has occurred.r) stacklevelN)r4r0Warningwarningswarn Exception)rr5errrraise_exceptions   zResource.raise_exceptionNcCstdS)N)NotImplementedError)rformatrrr make_blobszResource.make_blobcCs|S)Nr)rrrr __enter__szResource.__enter__cCs |dS)N)r!)rtyper- tracebackrrr__exit__szResource.__exit__cCs&y |Wntk r YnXdS)N)r!r )rrrr__del__s zResource.__del__)r)N)__name__ __module__ __qualname____doc__NotImplementedr"r#r+r.propertyr setterdeleter contextlibcontextmanagerr%r!r4r;r>r?rBrCrrrrrQs          rc@seZdZdZdS)r zAn 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)rDrErFrGrrrrr sr c@sheZdZdZdZdZddZddZdd Zd d Z d d Z ddZ ddZ ddZ ddZddZdS)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) rNrOrPrQrXrRrSrTrVrUrWZ list_lengthcCstdkr|j|_n|j|_dS)Ni)r_limits6r _limits7)rrrr__init__2s zResourceLimits.__init__cCs ||S)N)get_resource_limit)rrrrr __getitem__8szResourceLimits.__getitem__cCs|||dS)N)set_resource_limit)rr]vrrr __setitem__;szResourceLimits.__setitem__cCs d||<dS)Nrr)rr]rrr __delitem__>szResourceLimits.__delitem__cCs t|jS)N)iterr )rrrr__iter__AszResourceLimits.__iter__cCs t|jS)N)rr )rrrr__len__DszResourceLimits.__len__cCs |j|S)z3Helper method to map resource string to enum value.)r index)rr rrr_to_idxGszResourceLimits._to_idxcCst||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 )rZMagickGetResourcerg)rr rrrr Ks zResourceLimits.resourcecCstt||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 rZMagickGetResourceLimitrg)rr rrrr\Vs z!ResourceLimits.get_resource_limitcCs&tt|}t|||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_ulonglongrZMagickSetResourceLimitrg)rr limitZullrrrr_bs z!ResourceLimits.set_resource_limitN)rDrErFrGrYrZr[r^rarbrdrergr r\r_rrrrrs.  r)rGatexitrLr)r7apircompatrr exceptionsrrversionr__all__r r rrrregisterr objectrReferenceErrorAttributeErrorr MutableMappingrr rrrrs*