Skip to content

Commit 4d78b0e

Browse files
author
Gerit Wagner
committed
update docs and wos: deprecated fields
1 parent 8583449 commit 4d78b0e

40 files changed

+628
-42
lines changed

README.md

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -70,25 +70,21 @@ print(wos_query.to_string())
7070
# Output:
7171
# (AB="digital health" OR TI="digital health") AND (AB="privacy" OR TI="privacy")
7272
```
73-
74-
## Versioned Parsers & Serializers
75-
76-
Parsers and serializers are versioned. The initial release starts with
77-
version `1.0.0` for every platform. You can explicitly pin a parser version
78-
when parsing a query:
79-
73+
The translated query can be saved as follows:
8074
```python
81-
from search_query.parser import parse
82-
83-
query = parse("TS=(quantum)", platform="wos", version="1.0.0")
84-
```
85-
86-
Queries stored on disk may also record their `version`.
87-
The `search-query upgrade` CLI command upgrades a search
88-
file to a target version via the intermediate representation:
89-
90-
```bash
91-
search-query upgrade query.json --to 2.0.0
75+
from search_query import SearchFile
76+
77+
search_file = SearchFile(
78+
filename="search-file.json",
79+
query_str=wos_query.to_string(platform="wos"),
80+
platform="wos",
81+
version="1.0.0",
82+
authors=[{"name": "Tom Brady"}],
83+
record_info={},
84+
date={}
85+
)
86+
87+
search_file.save()
9288
```
9389

9490
For a more detailed overview of the package’s functionality, see the [documentation](https://colrev-environment.github.io/search-query/).

docs/source/dev_docs/_autosummary/search_query.ebsco.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,3 +32,4 @@ search\_query.ebsco
3232
search_query.ebsco.parser
3333
search_query.ebsco.serializer
3434
search_query.ebsco.translator
35+
search_query.ebsco.v1_0_0

docs/source/dev_docs/_autosummary/search_query.ebsco.serializer.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,12 @@ search\_query.ebsco.serializer
99

1010

1111

12-
.. rubric:: Functions
12+
13+
14+
15+
16+
.. rubric:: Classes
1317

1418
.. autosummary::
1519

16-
to_string_ebsco
20+
EBSCOQuerySerializer
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
search\_query.ebsco.v1\_0\_0.parser
2+
===================================
3+
4+
.. automodule:: search_query.ebsco.v1_0_0.parser
5+
6+
7+
8+
9+
10+
11+
12+
13+
14+
15+
16+
.. rubric:: Classes
17+
18+
.. autosummary::
19+
20+
EBSCOListParser_v1_0_0
21+
EBSCOParser_v1_0_0
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
search\_query.ebsco.v1\_0\_0
2+
============================
3+
4+
.. automodule:: search_query.ebsco.v1_0_0
5+
6+
7+
8+
9+
10+
11+
12+
13+
14+
15+
16+
17+
18+
19+
20+
21+
22+
23+
24+
.. rubric:: Modules
25+
26+
.. autosummary::
27+
:toctree:
28+
:recursive:
29+
30+
search_query.ebsco.v1_0_0.parser
31+
search_query.ebsco.v1_0_0.serializer
32+
search_query.ebsco.v1_0_0.translator
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
search\_query.ebsco.v1\_0\_0.serializer
2+
=======================================
3+
4+
.. automodule:: search_query.ebsco.v1_0_0.serializer
5+
6+
7+
8+
9+
10+
11+
12+
13+
14+
15+
16+
.. rubric:: Classes
17+
18+
.. autosummary::
19+
20+
EBCOSerializer_v1_0_0
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
search\_query.ebsco.v1\_0\_0.translator
2+
=======================================
3+
4+
.. automodule:: search_query.ebsco.v1_0_0.translator
5+
6+
7+
8+
9+
10+
11+
12+
13+
14+
15+
16+
.. rubric:: Classes
17+
18+
.. autosummary::
19+
20+
EBSCOTranslator_v1_0_0

docs/source/dev_docs/_autosummary/search_query.generic.serializer.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,12 @@ search\_query.generic.serializer
99

1010

1111

12-
.. rubric:: Functions
12+
13+
14+
15+
16+
.. rubric:: Classes
1317

1418
.. autosummary::
1519

16-
to_string_generic
20+
GenericSerializer

docs/source/dev_docs/_autosummary/search_query.pubmed.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,3 +32,4 @@ search\_query.pubmed
3232
search_query.pubmed.parser
3333
search_query.pubmed.serializer
3434
search_query.pubmed.translator
35+
search_query.pubmed.v1_0_0

docs/source/dev_docs/_autosummary/search_query.pubmed.serializer.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,12 @@ search\_query.pubmed.serializer
99

1010

1111

12-
.. rubric:: Functions
12+
13+
14+
15+
16+
.. rubric:: Classes
1317

1418
.. autosummary::
1519

16-
to_string_pubmed
20+
PUBMEDQuerySerializer

0 commit comments

Comments
 (0)