Metadata-Version: 2.1
Name: wostools
Version: 2.0.2
Summary: Translates isi web of knowledge files into python objects.
Home-page: https://github.com/coreofscience/python-wostools
Author: Core of Science
Author-email: dev@coreofscience.com
License: MIT license
Keywords: wostools
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: Click (>=7.0)

# 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 CachedCollection
>>> collection = CachedCollection.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
-   Just parses an ISI Web of Knowledge file and produces a native
    python object.
-   Through the `CollectionLazy` object it can do this using the minimum
    amount of memory it can possibly do.
-   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.


# History

## 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.


