pori-python 1.5.0__tar.gz → 1.7.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. {pori_python-1.5.0/pori_python.egg-info → pori_python-1.7.0}/PKG-INFO +5 -2
  2. {pori_python-1.5.0 → pori_python-1.7.0}/README.md +1 -1
  3. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/match.py +2 -27
  4. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/util.py +125 -39
  5. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/vocab.py +9 -15
  6. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/content.spec.json +4 -0
  7. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/ipr.py +29 -9
  8. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/main.py +46 -23
  9. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/summary.py +6 -6
  10. {pori_python-1.5.0 → pori_python-1.7.0/pori_python.egg-info}/PKG-INFO +5 -2
  11. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python.egg-info/SOURCES.txt +1 -0
  12. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python.egg-info/requires.txt +3 -0
  13. {pori_python-1.5.0 → pori_python-1.7.0}/setup.cfg +8 -1
  14. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/test_match.py +0 -16
  15. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/test_statement.py +14 -3
  16. pori_python-1.7.0/tests/test_graphkb/test_util.py +393 -0
  17. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_annotate.py +25 -1
  18. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_ipr.py +6 -0
  19. pori_python-1.7.0/tests/test_ipr/test_ipr_integration.py +102 -0
  20. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_main.py +142 -39
  21. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_summary.py +32 -32
  22. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_upload.py +27 -21
  23. pori_python-1.5.0/tests/test_graphkb/test_util.py +0 -193
  24. {pori_python-1.5.0 → pori_python-1.7.0}/LICENSE +0 -0
  25. {pori_python-1.5.0 → pori_python-1.7.0}/MANIFEST.in +0 -0
  26. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/__init__.py +0 -0
  27. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/__init__.py +0 -0
  28. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/constants.py +0 -0
  29. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/genes.py +0 -0
  30. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/graphkb/statement.py +0 -0
  31. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/__init__.py +0 -0
  32. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/annotate.py +0 -0
  33. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/connection.py +0 -0
  34. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/constants.py +0 -0
  35. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/inputs.py +0 -0
  36. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/therapeutic_options.py +0 -0
  37. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/ipr/util.py +0 -0
  38. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/py.typed +0 -0
  39. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python/types.py +0 -0
  40. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python.egg-info/dependency_links.txt +0 -0
  41. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python.egg-info/entry_points.txt +0 -0
  42. {pori_python-1.5.0 → pori_python-1.7.0}/pori_python.egg-info/top_level.txt +0 -0
  43. {pori_python-1.5.0 → pori_python-1.7.0}/pyproject.toml +0 -0
  44. {pori_python-1.5.0 → pori_python-1.7.0}/setup.py +0 -0
  45. {pori_python-1.5.0 → pori_python-1.7.0}/tests/__init__.py +0 -0
  46. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/__init__.py +0 -0
  47. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/data.py +0 -0
  48. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/test_genes.py +0 -0
  49. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/test_graphkb.py +0 -0
  50. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_graphkb/test_vocab.py +0 -0
  51. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/__init__.py +0 -0
  52. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/constants.py +0 -0
  53. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_connection.py +0 -0
  54. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_inputs.py +0 -0
  55. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_probe.py +0 -0
  56. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/test_util.py +0 -0
  57. {pori_python-1.5.0 → pori_python-1.7.0}/tests/test_ipr/util.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pori_python
3
- Version: 1.5.0
3
+ Version: 1.7.0
4
4
  Home-page: https://github.com/bcgsc/pori_python
5
5
  Author-email: dat@bcgsc.ca
6
6
  Maintainer-email: dat@bcgsc.ca
@@ -12,6 +12,9 @@ Requires-Dist: pandas>=1.1.0
12
12
  Requires-Dist: requests
13
13
  Requires-Dist: tqdm
14
14
  Requires-Dist: typing_extensions<5,>=3.7.4.2
15
+ Requires-Dist: requests-cache<2.0,>=1.3.0
16
+ Requires-Dist: requests-ratelimiter
17
+ Requires-Dist: pyrate-limiter
15
18
  Provides-Extra: deploy
16
19
  Requires-Dist: twine; extra == "deploy"
17
20
  Requires-Dist: wheel; extra == "deploy"
@@ -43,7 +46,7 @@ Dynamic: license-file
43
46
 
44
47
  # PORI Python Adaptor
45
48
 
46
- ![build](https://github.com/bcgsc/pori_python/workflows/build/badge.svg) [![codecov](https://codecov.io/gh/bcgsc/pori_python/branch/master/graph/badge.svg)](https://codecov.io/gh/bcgsc/pori_python)
49
+ ![build](https://github.com/bcgsc/pori_python/workflows/build/badge.svg) [![codecov](https://codecov.io/gh/bcgsc/pori_python/branch/main/graph/badge.svg)](https://codecov.io/gh/bcgsc/pori_python)
47
50
 
48
51
  This repository is part of the [Platform for Oncogenomic Reporting and Interpretation (PORI)](https://bcgsc.github.io/pori/).
49
52
 
@@ -1,7 +1,7 @@
1
1
 
2
2
  # PORI Python Adaptor
3
3
 
4
- ![build](https://github.com/bcgsc/pori_python/workflows/build/badge.svg) [![codecov](https://codecov.io/gh/bcgsc/pori_python/branch/master/graph/badge.svg)](https://codecov.io/gh/bcgsc/pori_python)
4
+ ![build](https://github.com/bcgsc/pori_python/workflows/build/badge.svg) [![codecov](https://codecov.io/gh/bcgsc/pori_python/branch/main/graph/badge.svg)](https://codecov.io/gh/bcgsc/pori_python)
5
5
 
6
6
  This repository is part of the [Platform for Oncogenomic Reporting and Interpretation (PORI)](https://bcgsc.github.io/pori/).
7
7
 
@@ -2,7 +2,7 @@
2
2
  Functions which return Variants from GraphKB which match some input variant definition
3
3
  """
4
4
 
5
- from typing import Dict, List, Optional, Set, Union, cast
5
+ from typing import Dict, List, Optional, Union, cast
6
6
 
7
7
  from pori_python.types import (
8
8
  BasicPosition,
@@ -31,14 +31,7 @@ from .util import (
31
31
  looks_like_rid,
32
32
  stringifyVariant,
33
33
  )
34
- from .vocab import (
35
- get_equivalent_terms,
36
- get_term_by_name,
37
- get_term_tree,
38
- get_terms_set,
39
- )
40
-
41
- FEATURES_CACHE: Set[str] = set()
34
+ from .vocab import get_equivalent_terms, get_term_by_name, get_term_tree, get_terms_set
42
35
 
43
36
 
44
37
  def get_equivalent_features(
@@ -97,8 +90,6 @@ def get_equivalent_features(
97
90
  filters.append(
98
91
  {'OR': [{'sourceIdVersion': source_id_version}, {'sourceIdVersion': None}]}
99
92
  )
100
- elif FEATURES_CACHE and gene_name.lower() not in FEATURES_CACHE and not ignore_cache:
101
- return []
102
93
  else:
103
94
  filters.append({'OR': [{'sourceId': gene_name}, {'name': gene_name}]})
104
95
 
@@ -111,22 +102,6 @@ def get_equivalent_features(
111
102
  )
112
103
 
113
104
 
114
- def cache_missing_features(conn: GraphKBConnection) -> None:
115
- """
116
- Create a cache of features that exist to avoid repeatedly querying
117
- for missing features
118
- """
119
- genes = cast(
120
- List[Ontology],
121
- conn.query({'target': 'Feature', 'returnProperties': ['name', 'sourceId'], 'neighbors': 0}),
122
- )
123
- for gene in genes:
124
- if gene['name']:
125
- FEATURES_CACHE.add(gene['name'].lower())
126
- if gene['sourceId']:
127
- FEATURES_CACHE.add(gene['sourceId'].lower())
128
-
129
-
130
105
  def match_category_variant(
131
106
  conn: GraphKBConnection,
132
107
  reference_name: str,
@@ -1,27 +1,27 @@
1
- import requests
2
- from requests.adapters import HTTPAdapter
3
-
4
- import hashlib
5
1
  import json
6
2
  import logging
7
3
  import os
8
4
  import re
9
5
  import time
10
6
  from datetime import datetime
11
- from typing import Any, Dict, Iterable, List, Optional, Union, cast
12
- from urllib3.util.retry import Retry
7
+ from typing import Dict, Iterable, List, Optional, Union, cast
13
8
  from urllib.parse import urlsplit
14
9
 
10
+ import requests
11
+ from requests.adapters import HTTPAdapter
12
+ from requests_cache import CachedSession
13
+ from requests_ratelimiter import LimiterAdapter
14
+ from urllib3.util.retry import Retry
15
+
15
16
  from pori_python.types import ParsedVariant, PositionalVariant, Record
16
17
 
17
18
  from .constants import DEFAULT_LIMIT, TYPES_TO_NOTATION, AA_3to1_MAPPING
18
19
 
19
- QUERY_CACHE: Dict[Any, Any] = {}
20
-
21
20
  # name the logger after the package to make it simple to disable for packages using this one as a dependency
22
21
  # https://stackoverflow.com/questions/11029717/how-do-i-disable-log-messages-from-the-requests-library
23
22
 
24
23
  logger = logging.getLogger('graphkb')
24
+ DEFAULT_LIMITER = LimiterAdapter(per_second=3)
25
25
 
26
26
 
27
27
  def convert_to_rid_list(records: Iterable[Record]) -> List[str]:
@@ -88,11 +88,17 @@ def millis_interval(start: datetime, end: datetime) -> int:
88
88
  return millis
89
89
 
90
90
 
91
- def cache_key(request_body) -> str:
92
- """Create a cache key for a query request to GraphKB."""
93
- body = json.dumps(request_body, sort_keys=True)
94
- hash_code = hashlib.md5(f'/query{body}'.encode('utf-8')).hexdigest()
95
- return hash_code
91
+ def cache_filter(response):
92
+ """
93
+ Only cache POST requests when they are for the /query endpoint. Otherwise they are creating content
94
+ and should not be cached
95
+ """
96
+ request = response.request
97
+
98
+ if request.method == 'POST':
99
+ return request.url.rstrip('/').endswith('/query')
100
+
101
+ return True
96
102
 
97
103
 
98
104
  class GraphKBConnection:
@@ -102,23 +108,89 @@ class GraphKBConnection:
102
108
  username: str = '',
103
109
  password: str = '',
104
110
  use_global_cache: bool = True,
111
+ cache_name: str = '',
112
+ only_if_cached: bool = False,
113
+ session: Optional[requests.Session] = None,
114
+ limiter_kwargs: Optional[dict] = None,
115
+ **session_kwargs,
105
116
  ):
106
- self.http = requests.Session()
107
- retries = Retry(
117
+ """
118
+ Docstring for __init__
119
+
120
+ Args:
121
+ - use_global_cache: cache requests across all requests to GKB
122
+ - cache_name: Path or connection URL to the database which stors the requests cache. see https://requests-cache.readthedocs.io/en/v0.6.4/user_guide.html#cache-name
123
+ - only_if_cached: this will set the cache-control header for all requests to only-if-cached which will raise 504 errors if a request does not exist in the cache already rather than making a new network request
124
+ """
125
+ session_cls = requests.Session
126
+ if session is not None:
127
+ if limiter_kwargs is not None:
128
+ raise NotImplementedError('cannot add limiter to an existing session')
129
+ if use_global_cache:
130
+ raise NotImplementedError(
131
+ 'the use_global_cache parameter should not be used with a custom session'
132
+ )
133
+ if cache_name:
134
+ raise NotImplementedError(
135
+ 'cache_name should not be used with a custom input session'
136
+ )
137
+ if not use_global_cache and cache_name:
138
+ raise NotImplementedError('cache_name only applies when use_global_cache is True')
139
+ if only_if_cached and not use_global_cache:
140
+ raise NotImplementedError(
141
+ 'only_if_cached=True and use_global_cache=False are conflicting settings'
142
+ )
143
+
144
+ if use_global_cache:
145
+ session_cls = CachedSession
146
+ if not cache_name:
147
+ session_kwargs['backend'] = 'memory'
148
+ else:
149
+ session_kwargs['cache_name'] = cache_name
150
+ session_kwargs['allowable_methods'] = ['GET', 'POST']
151
+ session_kwargs['filter_fn'] = cache_filter
152
+ session_kwargs['cache_control'] = True
153
+
154
+ if 'PYTEST_CURRENT_TEST' in os.environ or only_if_cached:
155
+ if limiter_kwargs is not None:
156
+ logging.warning(
157
+ 'rate limiting is by default turned off for tests and cache-only queries. Setting limiter to None'
158
+ )
159
+ limiter_kwargs = None
160
+
161
+ if not session:
162
+ self.http = session_cls(**session_kwargs)
163
+ else:
164
+ self.http = session
165
+
166
+ max_retries = Retry(
108
167
  total=100,
109
168
  connect=5,
110
169
  status=5,
111
170
  backoff_factor=5,
112
171
  status_forcelist=[429, 500, 502, 503, 504],
113
172
  )
114
- self.http.mount('https://', HTTPAdapter(max_retries=retries))
173
+
174
+ if limiter_kwargs:
175
+ adapter = LimiterAdapter(max_retries=max_retries, **limiter_kwargs)
176
+ else:
177
+ adapter = HTTPAdapter(max_retries=max_retries)
178
+
179
+ if not only_if_cached:
180
+ # do not need adapters at all for cache-only hits
181
+ self.http.mount('http://', adapter)
182
+ self.http.mount('https://', adapter)
183
+ self.only_if_cached = only_if_cached
184
+
115
185
  self.token = ''
116
186
  self.token_kc = ''
117
187
  self.url = url
118
188
  self.username = username
119
189
  self.password = password
120
- self.headers = {'Accept': 'application/json', 'Content-Type': 'application/json'}
121
- self.cache: Dict[Any, Any] = {} if not use_global_cache else QUERY_CACHE
190
+ self.headers = {
191
+ 'Accept': 'application/json',
192
+ 'Content-Type': 'application/json',
193
+ }
122
194
  self.request_count = 0
123
195
  self.first_request: Optional[datetime] = None
124
196
  self.last_request: Optional[datetime] = None
@@ -137,7 +209,16 @@ class GraphKBConnection:
137
209
  return self.request_count * 1000 / msec
138
210
  return None
139
211
 
140
- def request(self, endpoint: str, method: str = 'GET', **kwargs) -> Dict:
212
+ def request(
213
+ self,
214
+ endpoint: str,
215
+ method: str = 'GET',
216
+ headers: Optional[dict[str, str]] = None,
217
+ ignore_cache=False,
218
+ force_refresh=False,
219
+ only_if_cached=False,
220
+ **kwargs,
221
+ ) -> Dict:
141
222
  """Request wrapper to handle adding common headers and logging.
142
223
 
143
224
  Args:
@@ -147,6 +228,13 @@ class GraphKBConnection:
147
228
  Returns:
148
229
  dict: the json response as a python dict
149
230
  """
231
+ if headers is None:
232
+ headers = {}
233
+
234
+ if ignore_cache or force_refresh:
235
+ headers['Cache-Control'] = 'no-cache'
236
+ elif only_if_cached or self.only_if_cached:
237
+ headers['Cache-Control'] = 'only-if-cached'
150
238
  url = join_url(self.url, endpoint)
151
239
  self.request_count += 1
152
240
  connect_timeout = 7
@@ -158,6 +246,11 @@ class GraphKBConnection:
158
246
  if endpoint in ['query', 'parse']:
159
247
  timeout = (connect_timeout, read_timeout)
160
248
 
249
+ request_headers = {}
250
+ request_headers.update(self.headers)
251
+ if headers is not None:
252
+ request_headers.update(headers)
253
+
161
254
  start_time = datetime.now()
162
255
 
163
256
  if not self.first_request:
@@ -176,11 +269,12 @@ class GraphKBConnection:
176
269
  try:
177
270
  if need_refresh_login:
178
271
  self.refresh_login()
272
+ request_headers.update(self.headers)
179
273
  need_refresh_login = False
180
274
 
181
275
  self.request_count += 1
182
- resp = requests.request(
183
- method, url, headers=self.headers, timeout=timeout, **kwargs
276
+ resp = self.http.request(
277
+ method, url, headers=request_headers, timeout=timeout, **kwargs
184
278
  )
185
279
  if resp.status_code == 401 or resp.status_code == 403:
186
280
  logger.debug(f'/{endpoint} - {resp.status_code} - retrying')
@@ -293,39 +387,29 @@ class GraphKBConnection:
293
387
  def refresh_login(self) -> None:
294
388
  self.login(self.username, self.password)
295
389
 
296
- def set_cache_data(self, request_body: Dict, result: List[Record]) -> None:
297
- """Explicitly add a query to the cache."""
298
- hash_code = cache_key(request_body)
299
- self.cache[hash_code] = result
300
-
301
390
  def query(
302
391
  self,
303
392
  request_body: Dict = {},
304
393
  paginate: bool = True,
305
- ignore_cache: bool = False,
306
- force_refresh: bool = False,
307
394
  limit: int = DEFAULT_LIMIT,
395
+ **kwargs,
308
396
  ) -> List[Record]:
309
397
  """
310
398
  Query GraphKB
311
399
  """
312
- result: List[Record] = []
313
- hash_code = ''
314
-
315
- if not ignore_cache and paginate:
316
- hash_code = cache_key(request_body)
317
- if hash_code in self.cache and not force_refresh:
318
- return self.cache[hash_code]
319
400
 
401
+ result: List[Record] = []
320
402
  while True:
321
- content = self.post('query', data={**request_body, 'limit': limit, 'skip': len(result)})
403
+ content = self.post(
404
+ 'query',
405
+ data={**request_body, 'limit': limit, 'skip': len(result)},
406
+ **kwargs,
407
+ )
322
408
  records = content['result']
323
409
  result.extend(records)
324
410
  if len(records) < limit or not paginate:
325
411
  break
326
412
 
327
- if not ignore_cache and paginate:
328
- self.cache[hash_code] = result
329
413
  return result
330
414
 
331
415
  def parse(self, hgvs_string: str, requireFeatures: bool = False) -> ParsedVariant:
@@ -500,7 +584,9 @@ def stripDisplayName(displayName: str, withRef: bool = True, withRefSeq: bool =
500
584
 
501
585
 
502
586
  def stringifyVariant(
503
- variant: Union[PositionalVariant, ParsedVariant], withRef: bool = True, withRefSeq: bool = True
587
+ variant: Union[PositionalVariant, ParsedVariant],
588
+ withRef: bool = True,
589
+ withRefSeq: bool = True,
504
590
  ) -> str:
505
591
  """
506
592
  Convert variant record to a string representation (displayName/hgvs)
@@ -1,10 +1,12 @@
1
- from typing import Callable, Dict, Iterable, List, Set, cast, Union
1
+ from typing import Callable, Dict, Iterable, List, Set, Union, cast
2
2
 
3
3
  from pori_python.types import Ontology
4
4
 
5
5
  from . import GraphKBConnection
6
6
  from .util import convert_to_rid_list
7
7
 
8
+ DEFAULT_RETURN_PROPERTIES = ['sourceId', 'sourceIdVersion', 'deprecated', 'name', '@rid']
9
+
8
10
 
9
11
  def query_by_name(ontology_class: str, base_term_name: Union[str, list[str]]) -> Dict:
10
12
  return {'target': ontology_class, 'filters': {'name': base_term_name}}
@@ -17,6 +19,7 @@ def get_equivalent_terms(
17
19
  ontology_class: str = 'Vocabulary',
18
20
  ignore_cache: bool = False,
19
21
  build_base_query: Callable = query_by_name,
22
+ return_properties=DEFAULT_RETURN_PROPERTIES,
20
23
  ) -> List[Ontology]:
21
24
  """
22
25
  Get a list of terms equivalent to the current term up to the root term
@@ -35,7 +38,7 @@ def get_equivalent_terms(
35
38
  'target': {'target': base_records, 'queryType': 'descendants'},
36
39
  'queryType': 'similarTo',
37
40
  'treeEdges': [],
38
- 'returnProperties': ['sourceId', 'sourceIdVersion', 'deprecated', 'name', '@rid'],
41
+ 'returnProperties': return_properties,
39
42
  },
40
43
  ignore_cache=ignore_cache,
41
44
  ),
@@ -54,13 +57,7 @@ def get_equivalent_terms(
54
57
  'target': {'target': root_records, 'queryType': 'descendants'},
55
58
  'queryType': 'similarTo',
56
59
  'treeEdges': [],
57
- 'returnProperties': [
58
- 'sourceId',
59
- 'sourceIdVersion',
60
- 'deprecated',
61
- 'name',
62
- '@rid',
63
- ],
60
+ 'returnProperties': ['@rid'],
64
61
  },
65
62
  ignore_cache=ignore_cache,
66
63
  )
@@ -78,6 +75,7 @@ def get_term_tree(
78
75
  include_superclasses: bool = True,
79
76
  ignore_cache: bool = False,
80
77
  build_base_query: Callable = query_by_name,
78
+ return_properties=DEFAULT_RETURN_PROPERTIES,
81
79
  ) -> List[Ontology]:
82
80
  """
83
81
  Get terms equivalent to the base term by traversing the subclassOf tree and expanding related
@@ -105,7 +103,7 @@ def get_term_tree(
105
103
  'target': {'target': base_records, 'queryType': 'ancestors'},
106
104
  'queryType': 'similarTo',
107
105
  'treeEdges': [],
108
- 'returnProperties': ['sourceId', 'sourceIdVersion', 'deprecated', 'name', '@rid'],
106
+ 'returnProperties': return_properties,
109
107
  },
110
108
  ignore_cache=ignore_cache,
111
109
  ),
@@ -119,6 +117,7 @@ def get_term_tree(
119
117
  ontology_class=ontology_class,
120
118
  ignore_cache=ignore_cache,
121
119
  build_base_query=build_base_query,
120
+ return_properties=return_properties,
122
121
  )
123
122
  else:
124
123
  parent_terms = []
@@ -181,9 +180,6 @@ def get_terms_set(
181
180
  ) -> Set[str]:
182
181
  """Get a set of vocabulary rids given some base/parent term names."""
183
182
  base_terms = [base_terms] if isinstance(base_terms, str) else base_terms
184
- cache_key = tuple(sorted(base_terms))
185
- if graphkb_conn.cache.get(cache_key, None) and not ignore_cache:
186
- return graphkb_conn.cache[cache_key]
187
183
  terms = set()
188
184
  for base_term in base_terms:
189
185
  terms.update(
@@ -193,6 +189,4 @@ def get_terms_set(
193
189
  )
194
190
  )
195
191
  )
196
- if not ignore_cache:
197
- graphkb_conn.cache[cache_key] = terms
198
192
  return terms
@@ -564,6 +564,10 @@
564
564
  "hrd": {
565
565
  "properties": {
566
566
  "kbCategory": {
567
+ "examples": [
568
+ "homologous recombination deficiency strong signature",
569
+ "homologous recombination deficiency moderate signature"
570
+ ],
567
571
  "type": "string"
568
572
  },
569
573
  "score": {
@@ -322,15 +322,26 @@ def create_key_alterations(
322
322
 
323
323
  counts[type_mapping[variant_type]].add(variant_key)
324
324
 
325
- if variant_type == 'exp':
326
- alterations.append(f'{variant.get("gene", "")} ({variant.get("expressionState")})')
327
- elif variant_type == 'cnv':
328
- alterations.append(f'{variant.get("gene", "")} ({variant.get("cnvState")})')
329
- # only show germline if relevant
330
- elif kb_match['category'] in GERMLINE_BASE_TERMS and variant.get('germline'):
331
- alterations.append(f'germline {variant["variant"]}')
325
+ # DEVSU-2013 returning an alteration object for IPR API to look up an observed variant for association at report creation.
326
+ # variantType: the type of variant (mut, cnv, sv, exp)
327
+ # variant: the observed variant's key property (eg: e90293983749cf4)
328
+ # Example value: {'variantType': 'mut', 'variant': 'e90293983749cf4'}
329
+ if kb_match['category'] in GERMLINE_BASE_TERMS:
330
+ # only include germline-category matches when the observed variant is germline
331
+ if variant.get('germline'):
332
+ alterations.append(
333
+ {
334
+ 'variantType': variant_type,
335
+ 'variant': variant['key'],
336
+ },
337
+ )
332
338
  else:
333
- alterations.append(variant['variant'])
339
+ alterations.append(
340
+ {
341
+ 'variantType': variant_type,
342
+ 'variant': variant['key'],
343
+ },
344
+ )
334
345
 
335
346
  counted_variants = set.union(*counts.values())
336
347
  counts['variantsUnknown'] = set()
@@ -340,8 +351,17 @@ def create_key_alterations(
340
351
  if variant['variant'] and variant['key'] not in counted_variants:
341
352
  counts['variantsUnknown'].add(variant['key'])
342
353
 
354
+ unique_alterations = []
355
+ seen = set()
356
+ for alt in alterations:
357
+ dedupe_key = (alt['variantType'], alt['variant'])
358
+ if dedupe_key in seen:
359
+ continue
360
+ seen.add(dedupe_key)
361
+ unique_alterations.append(alt)
362
+
343
363
  return (
344
- [{'geneVariant': alt} for alt in set(alterations)],
364
+ unique_alterations,
345
365
  {k: len(v) for k, v in counts.items()},
346
366
  )
347
367