wostools 3.0.2
Translates isi web of knowledge files into python objects.
License: MIT license
Keywords: wostools

# Python WoS tools

![Python package](https://github.com/coreofscience/python-wostools/workflows/Python%20package/badge.svg)
[![image](https://img.shields.io/pypi/v/wostools.svg)](https://pypi.python.org/pypi/wostools)
[![DOI: 10.5281/zenodo.1344261](https://zenodo.org/badge/94160457.svg)](https://zenodo.org/badge/latestdoi/94160457)

Translates ISI Web of Knowledge files into python objects.

## Quickstart

Install the library by:

```bash
$ pip install wostools
```

Say you want to grab the title of all the articles in an ISI file, you
can grab [this example file](docs/examples/bit-pattern-savedrecs.txt).

```python
>>> from wostools import Cached
>>> collection = Cached.from_filenames('docs/examples/bit-pattern-savedrecs.txt')
>>> for article in collection:
...     print(article.title)
In situ grazing incidence small-angle X-ray scattering study of solvent vapor annealing in lamellae-forming block copolymer thin films: Trade-off of defects in deswelling
Structural control of ultra-fine CoPt nanodot arrays via electrodeposition process
Porphyrin-based Pt/Pd-containing metallopolymers: Synthesis, characterization, optical property and potential application in bioimaging
Syntheses and Controllable Self-Assembly of Luminescence Platinum(II) Plane-Coil Diblock Copolymers
# ...
```

Never fear wostools cli is here. To help you do some common tasks right
from your terminal.

```bash
$ wostools --help
$ # To extract all the properties in a json file
$ wostools to-json docs/examples/bit-pattern-savedrecs.txt --output=document.json
```

## Features

- Free software: MIT license
- Parses an ISI Web of Knowledge file and produces a native python object.
- Parses RIS scopus files and produces a native python object.
- Merges ISI and RIS files into enriched collections.
- It has a cli to extract documents and citation pairs for you :smile:

## Credits

This package was created with
[Cookiecutter](https://github.com/audreyr/cookiecutter) and the
[audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)
project template.

Development of this package is supported by [Core of Science](https://coreofscience.com).

# History

## 3.0.2 (2020-10-15)

- Fix packaging accident to allow package to install correclty.

## 3.0.1 (2020-10-15)

- Clear logging error channel.

## 3.0.0 (2020-10-15)

- (!) Adds scopus RIS format support.
- Drops support for `LazyCollection`.
- Adds docummented support for Python 3.8 and 3.9
- Drops docummented support for Python 3.6.
- Improves article matching in collections.

## 2.0.7 (2020-08-23)

- Remove from the collection those documents whose label is unknow or conflictive.

## 2.0.6 (2020-08-21)

- Accomodate for unknown fields in ISI WOS files.

## 2.0.5 (2020-08-15)

- Fix and prevent distribution accidents.

## 2.0.4 (2020-08-15)

- Add issue to the articles plain dict output.
- Fix some bugs with issues.

## 2.0.3 (2020-08-15)

- Add issue to the articles top level.

## 2.0.2 (2020-08-09)

- Fix bug with first author merging articles.
- Remove instances where we inherit from `object`.

## 2.0.1 (2020-08-09)

- Fix error with wos files that have an invisible character before the field
  key.

## 2.0.0 (2020-08-08)

- Make the article class more concrete
- Make collections iterable
- Add cached and lazy collections for different use cases

## 0.2.0 (2018-08-12)

- Add support for all WOS fields.
- Add graph building support.
- Add a little cli for common tasks.

## 0.1.1 (2018-05-10)

- First release on PyPI.