File: utils.py

package info (click to toggle)
unknown-horizons 2019.1-8
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 347,924 kB
  • sloc: python: 46,805; xml: 3,137; sql: 1,189; sh: 736; makefile: 39; perl: 35
file content (91 lines) | stat: -rw-r--r-- 2,383 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# ###################################################
# Copyright (C) 2008-2017 The Unknown Horizons Team
# team@unknown-horizons.org
# This file is part of Unknown Horizons.
#
# Unknown Horizons is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty 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 St, Fifth Floor, Boston, MA  02110-1301  USA
# ###################################################

import functools
import signal

from pytest import skip

# check if SIGALRM is supported, this is not the case on Windows
# we might provide an alternative later, but for now, this will do
try:
	from signal import SIGALRM
	SUPPORTED = True
except ImportError:
	SUPPORTED = False


class Timer:
	"""
	Example

		def handler(signum, frame):
			print 'Timer triggered'

		t = Timer(handler)
		# handler will be called after 2 seconds
		t.start(2)

		# if 2 seconds have not passed, this will stop the timer
		t.stop()

	Note: if SIGALRM is not supported, this class does nothing
	"""

	def __init__(self, handler):
		"""Install the passed function as handler that is called when the signal
		triggers.
		"""
		if not SUPPORTED:
			return

		signal.signal(signal.SIGALRM, handler)

	def start(self, timeout):
		"""Start the timer. A timeout of 0 means that the signal will never trigger."""
		if not SUPPORTED or timeout == 0:
			return

		signal.alarm(timeout)

	@classmethod
	def stop(cls):
		"""Stop the timer. This can be called on both the instance and class (when you
		have no access to the instance for example).
		"""
		if not SUPPORTED:
			return

		signal.alarm(0)


def mark_flaky(func):
	"""
	Ignore test failures marked with this decorator. We have some tests that sometimes fail
	unfortunately.
	"""
	@functools.wraps(func)
	def wrapped(*args, **kwargs):
		try:
			func(*args, **kwargs)
		except Exception:
			skip()
	return wrapped