====== pockyt

A simple, yet powerful, commandline client for your Pocket <https://getpocket.com/>_ collection.

.. image:: http://img.shields.io/pypi/v/pockyt.svg?style=flat :target: https://pypi.python.org/pypi/pockyt

.. image:: http://img.shields.io/pypi/l/pockyt.svg?style=flat :target: https://pypi.python.org/pypi/pockyt

About

Pocket <https://getpocket.com/>_ is an application for managing a reading list of articles from the Internet.

pockyt is a commandline client that interfaces the pocket API and provides a way to interact with your Pocket collection. Using simple command sequences, routine tasks can be automated and reusable scripts can be created.

Privacy

pockyt does NOT track, store, or monitor your usage and/or data. Moreover, pockyt interacts with the pocket API using local credentials and does not attempt to communicate with any other services.

Installation

pockyt supports Python 2.7+ & 3.4+ on Windows, macOS, & GNU/Linux platforms.

Install pockyt: :code:pip install -U pockyt
Connect Pocket account: :code:pockyt reg
Refer the Examples & Documentation below.

Examples

Get the latest 5 items' links & excerpts and save them to a file.

.. code::
```
pockyt get -n 5 -f '{link} - {excerpt}' -o readlater.txt
```

Get the oldest 10 items and delete them from Pocket.

.. code::

pockyt get -n 10 -r oldest -f '{id}' | pockyt mod -d -i redirect

Get all the items about 'python' and open them in a browser.

.. code::
```
pockyt get -q 'python' -o browser
```
Get all the links from a 'links.txt' and add them to Pocket.

.. code::
```
pockyt put -i links.txt
```
Get all favorited items and archive them.

.. code::
```
pockyt get -v 1 | pockyt mod -a 1 -i redirect
```
Get all favorited items and save offline copies of them.

.. code::
```
pockyt get -v 1 -a ./pocket
```

Contribute

Feel free to contribute features, bugfixes, improvements, and usage ideas.

Fork <https://github.com/achembarpu/pockyt/fork>_ pockyt.

Work on the source code.

.. code::

git clone git@github.com:<username>/pockyt.git
cd pockyt

# runtime dependencies
pip install -e .
# devel dependencies
pip install -r requirements.txt

# do stuff
git checkout -b new-feature

# format files
yapf -i -r .

git add .
git commit -am 'commit msg'
git push origin new-feature

Submit a pull request <https://github.com/achembarpu/pockyt/compare>_.

License

This project uses the GNU GPLv3 License <https://github.com/achembarpu/pockyt/blob/master/LICENSE.txt>_.

Documentation

pockyt help/-h/--help :

help show pockyt usage help reg connect a pocket account get get pocket collection, with useful item info put add to pocket collection, using links mod modify pocket collection, using item ids

pockyt reg -h :

-h, --help show this help message and exit --no-browser use without browser i.e. print to console

pockyt get -h :

-h, --help show this help message and exit -c , --content content type : : {all, [article, video, image]} -s , --state collection state : : {all, [unread, archive]} -r , --sort item sorting : : {newest, [oldest, title, site]} -n , --count number of items : : {-1: all, [n: amount]} -q , --query search query : : {None} -t

pockyt put -h :

-h, --help show this help message and exit -f , --format unformat input : : {'{link}', [id, title, link, excerpt, tags]} -i

pockyt mod -h :

-h, --help show this help message and exit -f , --format unformat input : : {'{id}', [id, title, link, excerpt, tags]} -i

achembarpu / pockyt

readme