目录

1. 简介
2. 许可证
3. 先决条件
4. 安装
5. 状态 & 路线图

简介

Pinboard 是“内向人士的社交书签”– 一种类似于（现已关闭的）del.icio.us 的社交书签网络服务。 pin 是 Pinboard 的命令行客户端。它并不完整；它支持我在工作流程中发现的几个有用的操作。以下是一些示例

您可以将链接 http://foo.com/bar 发送到 Pinboard，标题为“splat”，标签为 a、b 和 c，如下所示

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

您可以设置重复使用的模板标签云，并通过名称引用它们

$> 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"

您还可以同时将链接发送到 Instapaper

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

我使用它来管理我的标签

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

或者，比如，当它们不再有用时，删除具有给定组合的标签的所有链接

ping delete old-company+jira

输入 pin --help 以获取所有标志和子命令的描述。

许可证

pin 是 GPL v3 软件。

先决条件

Rust 工具链（至少 Rust 版本 1.57）。

安装

此软件包可在 crates.io 上找到，但您也可以下载 Autotools tarball

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

状态 & 路线图

pin 仍然是早期代码；我选择版本号（0.2）以传达这是一个初步发布。 pinboard.py 对 Pinboard API 的覆盖面更广，但代价是强制用户使用 Python 的包管理器。不过，pin 提供了一个面向任务的接口，而不是面向 API 的接口。例如，删除具有给定标签组合的所有链接实际上是一个复杂的操作；您需要

• 从 API 获取具有该组合的标签的所有链接
• 逐个删除这些链接（因为这是 API 允许的）
• 同时遵守 API 的速率限制

换句话说，此包旨在提供一个围绕用户操作组织的接口，而不是围绕 API 端点的接口。

欢迎在 [email protected] 和 问题 中提交错误、评论、问题、PR、功能请求等。