Clippings
Python module to manipulate Amazon Kindle clippings files.
It allows you to:
- Parse your existing clippings file into a structured representation;
- Generate clippings file programmatically.
Installation
pip install clippings
Usage
Command-line Usage
# Parse a clippings file
clippings -o json ./clippings.txt
# or from stdin:
cat clippings.txt | clippings -
Programmatic Usage
from clippings import parse_clippings
my_clippings_file = ...
parse_clippings(my_clippings_file)
Want to parse non-English clippings?
Here's a highlight clipping taken from a Kindle that speaks Spanish::
El Principe de la Niebla (Carlos Ruiz Zafón)
- La subrayado en la página 4 | posición 60-60 | Añadido el miércoles, 6 de julio de 2022 06:54:57
asintiendo a una pregunta que Max no había llegado a formular.
parse_clippings won't parse this by default but you can write your own parser for
the second line and pass it to the parameter metadata_parser.
You can take a look at an example here.
Metadata
Release files for clippings 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| clippings-0.9.0.tar.gz | 5.9 kB | Without provenance | Details |
Release files / clippings-0.9.0.tar.gz
| Download URL | clippings-0.9.0.tar.gz |
|---|---|
| Size | 5.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c55649bc2ce72f6e4efb0dd350a1de4396e4909370d5b73f145a1adc4174bde
|
|
BLAKE2b-256 checksum How to use checksums |
5c1034ed529804ddae013123d2a37cc30e47abac86f9fb3c3ae0cdcddf784e2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.8
|
Security for clippings 0.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.