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
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
"""Mirrors tests/traits.rs. Needs a live MariaDB (SQL_URI) and a live
gn-auth (AUTH_SERVER_URL) plus a token (see docs/gn-auth.md); skips
when any is missing, same as test_dataset_probeset_info.py.
auth_token() tries this server's own POST /get-test-token first
(EXTRA_ENV below makes that possible), falling back to
GN4_TEST_AUTH_TOKEN.
"""
import http.client
import json
import socket
import unittest
from auth_helpers import TOKEN_ENV, auth_server_reachable, auth_token
from server_test_case import HOST, PORT, ServerTestCase, envelope_data
def database_reachable():
try:
with socket.create_connection(("127.0.0.1", 3306), timeout=0.5):
return True
except OSError:
return False
class TraitsTest(ServerTestCase):
EXTRA_ENV = TOKEN_ENV
def require_fixtures(self):
if not database_reachable():
self.skipTest("no database on 127.0.0.1:3306")
if not auth_token():
self.skipTest("no token (see docs/gn-auth.md)")
if not auth_server_reachable():
self.skipTest("no gn-auth reachable")
def get(self, path, with_token=True):
conn = http.client.HTTPConnection(HOST, int(PORT), timeout=10)
try:
headers = {"Authorization": f"Bearer {auth_token()}"} if with_token else {}
conn.request("GET", path, headers=headers)
response = conn.getresponse()
return response, response.read()
finally:
conn.close()
def test_trait_info_probeset_category(self):
self.require_fixtures()
response, body = self.get("/traits/Br_U_0803_M/100001_at")
self.assertEqual(response.status, 200)
info = envelope_data(body)
self.assertEqual(info["category"], "probeset")
self.assertEqual(info["name"], "100001_at")
self.assertEqual(info["symbol"], "Cd3g")
def test_trait_info_publish_category_by_group_name(self):
self.require_fixtures()
response, body = self.get("/traits/BXD/10001")
self.assertEqual(response.status, 200)
info = envelope_data(body)
self.assertEqual(info["category"], "publish")
self.assertEqual(info["id"], 10001)
def test_trait_info_publish_category_by_publish_freeze_name(self):
self.require_fixtures()
response, body = self.get("/traits/BXDPublish/10001")
self.assertEqual(response.status, 200)
info = envelope_data(body)
self.assertEqual(info["category"], "publish")
self.assertEqual(info["id"], 10001)
def test_trait_values_probeset_category(self):
self.require_fixtures()
response, body = self.get("/traits/Br_U_0803_M/100001_at/values")
self.assertEqual(response.status, 200)
values = envelope_data(body)
self.assertTrue(values)
self.assertIn("BXD1", {v["name"] for v in values})
def test_trait_values_publish_category(self):
self.require_fixtures()
response, body = self.get("/traits/BXD/10001/values")
self.assertEqual(response.status, 200)
values = envelope_data(body)
self.assertTrue(values)
self.assertIn("BXD1", {v["name"] for v in values})
def test_traits_list_probeset_category(self):
self.require_fixtures()
response, body = self.get("/traits/Br_U_0803_M")
self.assertEqual(response.status, 200)
traits = envelope_data(body)
self.assertTrue(traits)
self.assertTrue(all(t["category"] == "probeset" for t in traits))
self.assertIn("100001_at", {t["name"] for t in traits})
def test_traits_list_publish_category(self):
self.require_fixtures()
response, body = self.get("/traits/BXD")
self.assertEqual(response.status, 200)
traits = envelope_data(body)
self.assertTrue(traits)
self.assertTrue(all(t["category"] == "publish" for t in traits))
self.assertIn(10001, {t["id"] for t in traits})
def test_trait_info_without_a_token_returns_401(self):
if not database_reachable():
self.skipTest("no database on 127.0.0.1:3306")
response, _body = self.get("/traits/BXD/10001", with_token=False)
self.assertEqual(response.status, 401)
def test_trait_info_unknown_dataset_returns_404(self):
self.require_fixtures()
response, body = self.get("/traits/not-a-real-dataset/123")
self.assertEqual(response.status, 404)
error = json.loads(body)
self.assertEqual(error["code"], "dataset_not_found")
self.assertEqual(error["operation_id"], "trait_info")
def test_trait_info_unknown_trait_in_probeset_dataset_returns_404(self):
self.require_fixtures()
response, body = self.get("/traits/Br_U_0803_M/not-a-real-probeset")
self.assertEqual(response.status, 404)
error = json.loads(body)
self.assertEqual(error["code"], "trait_not_found")
def test_trait_info_unknown_trait_in_publish_dataset_returns_404(self):
self.require_fixtures()
response, body = self.get("/traits/BXD/99999999")
self.assertEqual(response.status, 404)
error = json.loads(body)
self.assertEqual(error["code"], "trait_not_found")
def test_trait_info_non_numeric_trait_in_publish_dataset_returns_404(self):
"""A non-numeric trait segment against a Publish dataset can
never match a PublishXRef.Id -- same 404 as a numeric id that
just doesn't exist, not a 500 from a failed parse."""
self.require_fixtures()
response, body = self.get("/traits/BXD/not-a-number")
self.assertEqual(response.status, 404)
error = json.loads(body)
self.assertEqual(error["code"], "trait_not_found")
def test_trait_info_non_public_unlinked_probeset_dataset_returns_403(self):
"""UTHSC_BXD_Cochlea_0225 -- same fixture as
test_dataset_probeset_info.py, exercised here through the
unified endpoint instead."""
self.require_fixtures()
response, body = self.get("/traits/UTHSC_BXD_Cochlea_0225/ENSMUSG00000028180")
self.assertEqual(response.status, 403)
error = json.loads(body)
self.assertEqual(error["code"], "forbidden")
def test_trait_info_recent_non_public_probeset_dataset_returns_403(self):
"""Same as above, but with a dataset genuinely less than a year
old (UTHSC_BXD_Cochlea_0225 above is real but was already ~20
months old by the time this test was written) -- the age-embargo
rule and the "not yet linked to any gn-auth resource" deny path
both need to hold for freshly-added data, not just for something
that merely hasn't aged into public yet.
UTHSC_BXD_2wk_Cochlea_0926 (public=1, confidentiality=1, created
2026-09-01) is the most recently added ProbeSetFreeze in the
database as of this writing.
"""
self.require_fixtures()
response, body = self.get("/traits/UTHSC_BXD_2wk_Cochlea_0926/ENSMUSG00000028180")
self.assertEqual(response.status, 403)
error = json.loads(body)
self.assertEqual(error["code"], "forbidden")
if __name__ == "__main__":
unittest.main()
|