isbntools

https://github.com/xlcnd/isbntools
Admin
A Python library and command-line tool for validating, transforming, and retrieving metadata for...
Tokens:6,865
Snippets:160
Trust Score:6.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### REPL meta command example

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Example of using the 'meta' command in the REPL to get book metadata.

```console
$ isbn> meta 9780156001311 tex
```

--------------------------------

### Development Requirements

Source: https://github.com/xlcnd/isbntools/blob/dev/CONTRIBUTING.md

Installs development dependencies required for contributing to the project.

```bash
pip install -r requirements-dev.txt
```

--------------------------------

### REPL Usage Examples

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Examples of using the isbntools REPL for various operations like getting metadata, listing files, and displaying cover information.

```console
$ isbn> meta 9780156001311 tex >>myreferences.bib
$ isbn> !ls
myreferences.bib
$ isbn> desc #
    It is the year 1327. Franciscans in an Italian abbey are suspected of
    heresy, but Brother William of Baskerville's investigation is suddenly
    overshadowed by seven bizarre deaths. Translated by William Weaver. A Helen
    and Kurt Wolff Book
$ isbn> cover #
         thumbnail:  http://books.google.com/books/content?id=PVVyuD1UY1wC&printsec=frontcover&img=1&zoom=1
    smallThumbnail:  http://books.google.com/books/content?id=PVVyuD1UY1wC&printsec=frontcover&img=1&zoom=5
$ isbn> PROVIDERS
    bnf  dnb  goob  kb  loc  mcues  openl  porbase  wiki
$ isbn> exit
    bye
```

--------------------------------

### Configuration File Example

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Example content for the isbntools.conf configuration file, showing settings for renaming formats, system timeouts, and service defaults.

```ini
... 

    [MISC]
    REN_FORMAT={firstAuthorLastName}{year}_{title}_{isbn}
    DEBUG=False

    [SYS]
    URLOPEN_TIMEOUT=10
    THREADS_TIMEOUT=12
    LOAD_METADATA_PLUGINS=True
    LOAD_FORMATTER_PLUGINS=True

    [SERVICES]
    DEFAULT_SERVICE=goob
    VIAS_MERGE=parallel

    ...
```

--------------------------------

### Installation using pip

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Command to install the isbntools package using pip.

```console
$ pip install isbntools
```

--------------------------------

### REPL session

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Starts a REPL with history, autocompletion, fuzzy options, redirection and access to the shell.

```console
$ isbn_repl
```

--------------------------------

### Get OCLC classifiers

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Returns the OCLC classifiers of a given ISBN.

```console
$ isbn_classify ISBN
```

--------------------------------

### Get EAN13 code

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Returns the EAN13 code of a given ISBN.

```console
$ isbn_ean13 ISBN
```

--------------------------------

### Get ISBN-A DOI code

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Returns the doi's ISBN-A code of a given ISBN.

```console
$ isbn_doi ISBN
```

--------------------------------

### Get multiple references from Google Books

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

A script that returns multiple references from Google Books based on words from title and author name.

```console
$ isbn_goom "words from title and author name" [bibtex|csl|msword|endnote|refworks|json]
```

--------------------------------

### Get ISBN editions

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Gives the collection of ISBNs that represent a given book using Wikipedia and LibraryThing.

```console
$ isbn_editions ISBN
```

--------------------------------

### Get ISBN group identifier

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Gives you the group identifier of the ISBN.

```console
$ isbn_info ISBN
```

--------------------------------

### Get ISBN metadata

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Gives you the main metadata associated with the ISBN. Supports Google Books, OpenLibrary.org, and Wikipedia APIs. Output can be formatted as bibtex, csl, msword, endnote, refworks, opf, or json.

```console
$ isbn_meta ISBN [goob|openl|merge] [bibtex|csl|msword|endnote|refworks|opf|json] [YOUR_APIKEY_TO_SERVICE]
```

--------------------------------

### Testing and Coverage

Source: https://github.com/xlcnd/isbntools/blob/dev/CONTRIBUTING.md

Command to run tests and check code coverage locally.

```bash
pytest -v --cov-config=setup.cfg isbntools
```

--------------------------------

### Code Style Checkers

Source: https://github.com/xlcnd/isbntools/blob/dev/CONTRIBUTING.md

Commands to check code style using yapf, flake8, and pylint.

```bash
yapf
```

```bash
flake8
```

```bash
pylint
```

--------------------------------

### REPL help command

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Shows available commands in the REPL.

```console
$ isbn> ?
```

--------------------------------

### Show Current Configuration

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Command to display the current contents of the isbntools configuration file.

```console
$ isbn_conf show
```

--------------------------------

### isbntools command

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Writes version and copyright notice and checks if there are updates.

```console
$ isbntools
```

--------------------------------

### Validate ISBN

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Validates ISBN10 and ISBN13.

```console
$ isbn_validate ISBN
```

--------------------------------

### Validate ISBN using pipes

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Validates ISBNs from posix pipes.

```console
$ ... | isbn_validate
```

--------------------------------

### Fuzzy ISBN search

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

A fuzzy script that returns the most probable ISBN from a set of words.

```console
$ isbn_from_words "words from title and author name"
```

--------------------------------

### Rename files using ISBN metadata

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Renames files in the current directory that have ISBNs in their filename using metadata.

```console
$ isbn_ren FILENAME
```

```console
$ isbn_ren "*.pdf"
```

--------------------------------

### Transform ISBN13 to ISBN10

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Transforms an ISBN13 number to ISBN10.

```console
$ to_isbn10 ISBN13
```

--------------------------------

### Transform ISBN10 to ISBN13

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Transforms an ISBN10 number to ISBN13.

```console
$ to_isbn13 ISBN10
```

--------------------------------

### Mask (hyphenate) an ISBN

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Masks (hyphenate) an ISBN by splitting it by identifiers.

```console
$ isbn_mask ISBN
```

--------------------------------

### Validate ISBN from PDF

Source: https://github.com/xlcnd/isbntools/blob/dev/README.rst

Validates ISBNs extracted from a PDF using pdfminer.

```console
$ pdf2txt.py -m 5 MYEBOOK.pdf | isbn_validate
```
Tokens:
Raw