1
0
mirror of https://github.com/ilri/csv-metadata-quality.git synced 2024-12-22 12:12:18 +01:00

README.md: Improve

Reorganize functionality section and add installation section.
This commit is contained in:
Alan Orth 2019-07-29 11:15:51 +03:00
parent a8a41d60b6
commit aabb57321c
Signed by: alanorth
GPG Key ID: 0FB860CC9C45B1B9

View File

@ -3,19 +3,33 @@ A simple but opinionated metadata quality checker and fixer designed to work wit
Written and tested using Python 3.7. CSV and Excel support comes from the [Pandas](https://pandas.pydata.org/) library.
## Checks
Supports checking the validity of the following metadata elements:
## Functionality
- ISSN
- ISBN
- Multi-value separators ("||")
- Dates
- Read/write CSV files ✓
- Read Excel files ✓
- Validate dates, ISSNs, ISBNs, and multi-value separators ("||") ✓
- Fix leading, trailing, and excessive whitespace ✓
- Fix invalid multi-value separators ("|") using `--unsafe-fixes`
## Fixes
Supports fixing the following metadata issues:
## Installation
The easiest way to install CSV Metadata Quality is with [pipenv](https://github.com/pypa/pipenv):
- Leading, trailing, and excessive whitespace
- Invalid multi-value separators ("|") using `--unsafe-fixes`
```
$ git clone https://git.sr.ht/~alanorth/csv-metadata-quality
$ cd csv-metadata-quality
$ pipenv install
$ pipenv shell
```
Otherwise, if you don't have pipenv, you can use a vanilla Python virtual environment:
```
$ git clone https://git.sr.ht/~alanorth/csv-metadata-quality
$ cd csv-metadata-quality
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
```
## Todo