<h2>Editing File: /lib/python3.6/site-packages/tracer/resources/rules.py</h2><form method='post'><textarea name='content' class='file-edit'>#-*- coding: utf-8 -*-
# rules.py
# Manager for rules file
#
# Copyright (C) 2016 Jakub Kadlcik
#
# This copyrighted material is made available to anyone wishing to use,
# modify, copy, or redistribute it subject to the terms and conditions of
# the GNU General Public License v.2, or (at your option) any later version.
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY expressed or implied, including the implied warranties of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
# Public License for more details.  You should have received a copy of the
# GNU General Public License along with this program; if not, write to the
# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
# 02110-1301, USA.
#

from __future__ import absolute_import

from xml.dom import minidom
from xml.parsers.expat import ExpatError
from tracer.paths import DATA_DIR, USER_CONFIG_DIRS
from tracer.resources.exceptions import PathNotFound, TracerError
from os.path import dirname


class Rules(object):

	DEFINITIONS = map(lambda x: x + &quot;/rules.xml&quot;, [DATA_DIR] + USER_CONFIG_DIRS)

	ACTIONS = {
		&quot;CALL-PARENT&quot;  :  &quot;call-parent&quot;,
		&quot;RETURN&quot;        :  &quot;return&quot;,
	}
	_DEFAULT_ACTION = ACTIONS[&quot;CALL-PARENT&quot;]
	_rules = None

	@staticmethod
	def find(app_name):
		if not Rules._rules:
			Rules._load_definitions()

		for rule in Rules._rules:
			if rule.name == app_name:
				return rule

	@staticmethod
	def all():
		if not Rules._rules:
			Rules._load_definitions()

		return Rules._rules

	@staticmethod
	def _load_definitions():
		Rules._rules = []
		for file in Rules.DEFINITIONS:
			try: Rules._load(file);
			except PathNotFound as ex:
				if not dirname(file) in USER_CONFIG_DIRS:
					raise ex

	@staticmethod
	def _load(file):
		try:
			with open(file, &quot;r&quot;) as f:
				xmldoc = minidom.parseString(f.read())
		except IOError:
			raise PathNotFound('DATA_DIR')
		except ExpatError as ex:
			msg = &quot;Unable to parse {0}\nHint: {1}&quot;.format(file, ex)
			raise TracerError(msg)

		for rules in xmldoc.getElementsByTagName(&quot;rules&quot;):
			for rule in rules.getElementsByTagName(&quot;rule&quot;):
				attrs = dict(rule.attributes.items())
				r = Rule(attrs)
				if r in Rules._rules:
					i = Rules._rules.index(r)
					Rules._rules[i].update(r)
				else:
					r.setdefault('action', Rules._DEFAULT_ACTION)
					Rules._rules.append(r)


class Rule(object):

	&quot;&quot;&quot;
	Represent the rule defined in `rules.xml`

	Attributes
	----------
	name : str
	action : str
		See `Rules.ACTIONS` for possible values
	&quot;&quot;&quot;

	_attributes = None

	def __init__(self, attributes_dict):
		self._attributes = attributes_dict

	def __eq__(self, other):
		return isinstance(other, Rule) and self.name == other.name

	def __ne__(self, other):
		return not self.__eq__(other)

	def __getattr__(self, item):
		return self._attributes[item]

	def __len__(self):
		return len(self._attributes)

	def __contains__(self, item):
		return item in self._attributes

	def __str__(self):
		return &quot;&lt;Rule: &quot; + self._attributes[&quot;name&quot;] + &quot;&gt;&quot;

	def __repr__(self):
		return self.__str__()

	def setdefault(self, key, value):
		self._attributes.setdefault(key, value)

	def update(self, values):
		if isinstance(values, Rule):
			values = values._attributes
		self._attributes.update(values)
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fpython3.6%2Fsite-packages%2Ftracer%2Fresources'>Back to Directory</a>