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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
# -*- coding: utf-8 -*-
# basetest.py
# Copyright (C) 2013 LEAP
#
# This program 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 3 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, see <http://www.gnu.org/licenses/>.
"""
Common testing facilities
"""
import os
import platform
import shutil
import tempfile
try:
import unittest2 as unittest
except ImportError:
import unittest
from leap.common.check import leap_assert
from leap.common.events import server as events_server
from leap.common.events import client as events_client
from leap.common.files import mkdir_p, check_and_fix_urw_only
class BaseLeapTest(unittest.TestCase):
"""
Base Leap TestCase
"""
__name__ = "leap_test"
_system = platform.system()
@classmethod
def setUpClass(cls):
cls.setUpEnv()
@classmethod
def tearDownClass(cls):
cls.tearDownEnv()
@classmethod
def setUpEnv(cls):
"""
Sets up common facilities for testing this TestCase:
- custom PATH and HOME environmental variables
- creates a temporal folder to which those point.
It saves the old path and home vars so they can be restored later.
"""
cls.old_path = os.environ['PATH']
cls.old_home = os.environ['HOME']
cls.old_xdg_config = None
if "XDG_CONFIG_HOME" in os.environ:
cls.old_xdg_config = os.environ["XDG_CONFIG_HOME"]
cls.tempdir = tempfile.mkdtemp(prefix="leap_tests-")
cls.home = cls.tempdir
bin_tdir = os.path.join(
cls.tempdir,
'bin')
os.environ["PATH"] = bin_tdir
os.environ["HOME"] = cls.tempdir
os.environ["XDG_CONFIG_HOME"] = os.path.join(cls.tempdir, ".config")
cls._init_events()
@classmethod
def _init_events(cls):
cls._server = events_server.ensure_server(
emit_addr="tcp://127.0.0.1:0",
reg_addr="tcp://127.0.0.1:0")
events_client.configure_client(
emit_addr="tcp://127.0.0.1:%d" % cls._server.pull_port,
reg_addr="tcp://127.0.0.1:%d" % cls._server.pub_port)
@classmethod
def tearDownEnv(cls):
"""
Cleanup common facilities used for testing this TestCase:
- restores the default PATH and HOME variables
- removes the temporal folder
"""
events_client.shutdown()
cls._server.shutdown()
os.environ["PATH"] = cls.old_path
os.environ["HOME"] = cls.old_home
if cls.old_xdg_config is not None:
os.environ["XDG_CONFIG_HOME"] = cls.old_xdg_config
# safety check! please do not wipe my home...
# XXX needs to adapt to non-linuces
leap_assert(
cls.tempdir.startswith('/tmp/leap_tests-') or
(cls.tempdir.startswith('/tmp/') and
cls.tempdir.startswith(tempfile.gettempdir()) and
'leap_tests-' in cls.tempdir) or
cls.tempdir.startswith('/var/folder'),
"beware! tried to remove a dir which does not "
"live in temporal folder!")
shutil.rmtree(cls.tempdir)
# you have to override these methods
# this way we ensure we did not put anything
# here that you can forget to call.
def setUp(self):
"""not implemented"""
raise NotImplementedError("abstract base class")
def tearDown(self):
"""not implemented"""
raise NotImplementedError("abstract base class")
#
# helper methods
#
def _missing_test_for_plat(self, do_raise=False):
"""
Raises NotImplementedError for this platform
if do_raise is True
:param do_raise: flag to actually raise exception
:type do_raise: bool
"""
if do_raise:
raise NotImplementedError(
"This test is not implemented "
"for the running platform: %s" %
self._system)
def get_tempfile(self, filename):
"""
Returns the path of a given filename
prepending the temporal dir associated with this
TestCase
:param filename: the filename
:type filename: str
"""
return os.path.join(self.tempdir, filename)
def touch(self, filepath):
"""
Touches a filepath, creating folders along
the way if needed.
:param filepath: path to be touched
:type filepath: str
"""
folder, filename = os.path.split(filepath)
if not os.path.isdir(folder):
mkdir_p(folder)
self.assertTrue(os.path.isdir(folder))
with open(filepath, 'w') as fp:
fp.write(' ')
self.assertTrue(os.path.isfile(filepath))
def chmod600(self, filepath):
"""
Chmods 600 a file
:param filepath: filepath to be chmodded
:type filepath: str
"""
check_and_fix_urw_only(filepath)
|
