pin 0.2.6

Pinboard (and Instapaper) client
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101


# Table of Contents

1.  [Introduction](#org9f85a5d)
2.  [License](#org5cbea16)
3.  [Prerequistes](#org6295f7d)
4.  [Installation](#orgea31b05)
5.  [Status & Roadmap](#org86544b6)



<a id="org9f85a5d"></a>

# Introduction

[Pinboard](https://pinboard.in/) is "social bookmarking for introverts"&#x2013; a social bookmarking web service along the lines of (the now defunct) [del.icio.us](https://en.wikipedia.org/wiki/Delicious_(website)). [pin](https://github.com/sp1ff/pin) is a command-line client for [Pinboard](https://pinboard.in). It is by no means complete; it supports a few operations which I have found useful in my workflow. Here are a few examples:

You can send a link `http://foo.com/bar` to [Pinboard](https://pinboard.in) with title "splat" & tags `a`, `b` & `c` like so:

    pin send -t a -t b -t c "http://foo.com/bar | splat"

You can setup canned tag clouds you use repeatedly & refer to them by name:

    $> cat ~/.pin
    token = "you:XXX"
    
    [targets]
    
    [targets.frobnitz]
    tags = ["@review", "frobinate"]
    read_later = true
    ...
    # This link will get tags @review & frobinate, and have the "read later" flag set:
    $> pin send -r frobnitz "http://foo.com/bar | splat"

You can send the link to [Instapaper](https://www.instapaper.com) at the same time:

    $> pin send -r frobnitz --with-instapaper "http://foo.com/bar | splat"

I use it for curating my tags:

    $> pin get-tags 
    | Tag                            | Use Count |
    +--------------------------------+-----------+
    | flapdoodl                      |         1 |
    | flapdoodle                     |     10000 |
    ...
    # Hmmm... likely a mis-spelling
    $> pin rename-tag flapdoodl flapdoodle

or, say, deleting all links with a given combination of tags when they're no longer useful:

    ping delete old-company+jira

Type `pin --help` for a description of all flags & sub-commands.


<a id="org5cbea16"></a>

# License

[pin](https://github.com/sp1ff/pin) is GPL v3 software.


<a id="org6295f7d"></a>

# Prerequistes

The Rust [toolchain](https://rustup.rs/) (Rust version 1.57 at minimum).


<a id="orgea31b05"></a>

# Installation

This crate is available on [crates.io](https://crates.io), but you can also download an Autotools tarball:

    cd /tmp
    curl -O https://www.unwoundstack.com/dist/pin-0.2.6.tar.xz
    tar xf pin-0.2.6.tar.xz
    cd pin-0.2.6
    ./configure
    make
    make check
    sudo make install


<a id="org86544b6"></a>

# Status & Roadmap

[pin](https://github.com/sp1ff/pin) is still early code; I have chosen the version number (0.2) in the hopes of conveying that this is a preliminary release. [pinboard.py](https://github.com/lionheart/pinboard.py) provides far more complete coverage of the Pinboard API, albeit at the cost of forcing users to navigate Python's package management. Still, [pin](https://github.com/sp1ff/pin) provides an interface that is task-oriented, not API-oriented. For instance, deleting all links with a given tag combination is actually a complex operation; one needs to:

-   ask the API for all links that have that combination of tags
-   delete those links one at a time (because that is what the API allows)
-   while respecting the API's rate limits

In other words, this package is intended to provide an interface organized around user operations, not API endpoints.

Bugs, comments, problems, PRs, feature requests &c welcome at [sp1ff@pobox.com](mailto:sp1ff@pobox.com) and in the [issues](https://github.com/sp1ff/pin/issues).