X fdZddlZddlZddlZddlmZmZmZddlm Z m Z m Z m Z ddl mZejeZde jjdee jjfdZd eee jjd ee jjdeee jjfd Z dd ee jjde jjd ee jjee jjfd ede jdeejf dZdS)a0Automagic modules allow the framework to populate configuration elements that a user has not provided. Automagic objects accept a `context` and a `configurable`, and will make appropriate changes to the `context` in an attempt to fulfill the requirements of the `configurable` object (or objects upon which that configurable may rely). Several pre-existing modules include one to stack layers on top of each other (allowing automatic detection and loading of file format types) as well as a module to reconstruct layers based on their provided requirements. N)ListTypeUnion)class_subclasses import_files interfaces constants) requirementscontextreturncttjttjt fdttj j DdS)alReturns an ordered list of all subclasses of :class:`~volatility3.framework.interfaces.automagic.AutomagicInterface`. The order is based on the priority attributes of the subclasses, in order to ensure the automagics are listed in an appropriate order. Args: context: The context that will contain any automagic configuration values. c ng|]1}|tj|j2S)r configuration path_join__name__).0clazz config_pathr s Z/home/panchajanya/Development/work/volatility3/volatility3/framework/automagic/__init__.py zavailable..(sQ    E1;;KXX     c|jSN)priority)xs rzavailable...sajr)key) rsysmodulesrr AUTOMAGIC_CONFIG_PATHsortedrr automagicAutomagicInterface)r rs`@r availabler%s}X&'''1K      ***>*QRR    !    r automagicsplugincd}|jd}t|}tjD]C} |||kr||}|}4#t $rY@wxYw|tjvrtd|Std|dg}|D]}||j vr||gz }|S)zOChooses which automagics to run, maintaining the order they were handed in.None.zNo plugin category detectedz Detected a z category plugin) __module__splitlenr OS_CATEGORIESindex ValueErrorvolloginfoexclusion_list)r&r'plugin_categoryplugin_categories lowest_indexosoutputamagics rchoose_automagicr:2sO)//44())L%  &&r**\99066r:: "$    D i555 1222 KK?o???@@@ F &"7 7 7 vh F Ms0A,, A98A9 configurablerprogress_callbackc|D]0}t|tjjst d1t|tjjs.t|tjjst dt|tjjr|j}n|}tj |j }| D]}| |g} |D]} td|jj |||||9#t $r<} | t$j| Yd} ~ zd} ~ wwxYw| S)avRuns through the list of `automagics` in order, allowing them to make changes to the context. Args: automagics: A list of :class:`~volatility3.framework.interfaces.automagic.AutomagicInterface` objects context: The context (that inherits from :class:`~volatility3.framework.interfaces.context.ContextInterface`) for modification configurable: An object that inherits from :class:`~volatility3.framework.interfaces.configuration.ConfigurableInterface` config_path: The path within the `context.config` for options required by the `configurable` progress_callback: A function that takes a percentage (and an optional description) that will be called periodically This is where any automagic is allowed to run, and alter the context in order to satisfy/improve all requirements Returns a list of traceback objects that occurred during the autorun procedure Note: The order of the `automagics` list is important. An `automagic` that populates configurations may be necessary for an `automagic` that populates the context based on the configuration information. z:Automagics must only contain AutomagicInterface subclassesz(Automagic operates on configurables only)namezRunning automagic: N) isinstancerr#r$ TypeErrorrConfigurableInterface issubclass __class__r MultiRequirementrget_requirementsadd_requirementr1r2 Exceptionappend tracebackTracebackExceptionfrom_exception) r&r r;rr<r#configurable_class requirementreq exceptionsexcps rrunrQSs8  )Z%9%LMM L   j.D  Dz'?'UVVDBCCC , 8 NOO*)3)/5G5PQQQK,,..))##C((((JQQ  Q KKLi.A.JLL M M M Ig{K9J K K K K Q Q Q   i:II$OO P P P P P P P P Q s75D-- E372E..E3r) __doc__loggingrrItypingrrrvolatility3.frameworkrrrr #volatility3.framework.configurationr getLoggerrr1r ContextInterfacer#r$r%pluginsPluginInterfacer:rrAstrProgressCallbackrJrQrrrr]s $$$$$$$$$$WWWWWWWWWWWW<<<<<<  8 $ $   0 *  122T*.ABC #3 4 $z#6 78R59::Z)<=:   0: 6 Z % ;< >::!1: ) &'::::::r