"""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()