Metadata-Version: 2.1
Name: refparse
Version: 0.5.0
Summary: A Python library to parse bibliographic references
Author-email: WangK2 <kw221225@gmail.com>
License: MIT
Project-URL: Repository, https://github.com/doublessay/refparse
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# A Python library for Rule-Based reference parsing

refparse is an effective tool designed to extract structured data from unformatted reference strings. It is capable of parsing reference strings from **Web of Science, Scopus and CSSCI**.

## Install
Ensure Python 3.9 or higher is installed on your device.

```console
$ pip install refparse
```

## Basic Usage
```python
>>> import refparse
>>> source = "scopus"
>>> ref = "LeCun Y., Bengio Y., Hinton G., Deep learning, Nature, 521, pp. 436-444, (2015)"
>>> print(refparse.parse(ref, source))

{'author': 'LeCun Y., Bengio Y., Hinton G.',
 'title': 'Deep learning',
 'source': 'Nature',
 'volume': '521',
 'issue': None,
 'page': '436-444',
 'year': '2015'}
```

## Return Fields

|        | Web of Science | Scopus  | CSSCI   |
| :---:  | :---:          | :---:   | :---:   |
| author | &check;        | &check; | &check; |
| title  |                | &check; | &check; |
| source | &check;        | &check; | &check; |
| volume | &check;        | &check; | &check; |
| issue  |                | &check; | &check; |
| page   | &check;        | &check; | &check; |
| year   | &check;        | &check; | &check; |
| doi    | &check;        |         |         |
