Export all Pinboard.in bookmarks with a specific tag.

export_pinboard.py

#!/usr/bin/env python

"""
This script is designed to generate a simple HTML file with _all_ of your
Pinboard.in bookmarks.

You should edit the `username`, `password`, `bookmark_filename`, and `tag`
variables.

Requirements:

* requests
* dateutil
"""

import subprocess
import cgi
import time

import requests
from dateutil import parser as date_parser

# Your Pinboard username
username = ""

# The path where you'd like to store your HTML export
bookmark_filename = "/Users/dan/Dropbox/PinboardBookmarks.html"

# Your timezone
local_timezone = "America/Los_Angeles"

# (optional) A tag that you want to export by
tag = "programming"

# Your password
password = None

if not password:
    # Alternatively (if on OS X), use the Mac OS X keychain
    keychain_process = subprocess.Popen(["security", "find-internet-password", "-s", "pinboard.in", "-w"],
           stdout=subprocess.PIPE)
    trim_newlines = subprocess.Popen(["tr", "-d", "'\n'"],
           stdin=keychain_process.stdout,
           stdout=subprocess.PIPE)
    keychain_process.stdout.close()
    password, _ = trim_newlines.communicate()

BOOKMARK_FORMAT = u"""<DT><A HREF="{href}" ADD_DATE="{time}" PRIVATE="{private}" TOREAD="{toread}" TAGS="{tags}">{description}</a>\n"""
BOOKMARK_DESCRIPTION_FORMAT = u"""<DD>{extended}\n"""

def quote(text):
    return cgi.escape(text, quote=True).replace("\n", " ")

url = "https://api.pinboard.in/v1/user/api_token?format=json"
response = requests.get(url, auth=(username, password))
auth_token = "{}:{}".format(username, response.json()['result'])

if tag:
    url = "https://api.pinboard.in/v1/posts/all?format=json&tag={}&auth_token={}".format(tag, auth_token)
else:
    url = "https://api.pinboard.in/v1/posts/all?format=json&auth_token={}".format(auth_token)

response = requests.get(url)
with open(bookmark_filename, 'w') as bookmark_file:
    bookmark_file.write("""<!DOCTYPE NETSCAPE-Bookmark-file-1>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
<TITLE>Pinboard Bookmarks</TITLE>
<H1>Bookmarks</H1>
<DL><p>""")

    for bookmark in response.json():
        bookmark['description'] = quote(bookmark['description'])
        bookmark['time'] = int(time.mktime(date_parser.parse(bookmark['time']).timetuple()))
        bookmark['private'] = 0 if bookmark['shared'] == 'yes' else 1
        bookmark['toread'] = 1 if bookmark['toread'] == 'yes' else 0

        tags = bookmark['tags'].split()
        if bookmark['toread'] == 1:
            tags.append('toread')

        bookmark['tags'] = ','.join(tags)
        bookmark_file.write(BOOKMARK_FORMAT.format(**bookmark).encode("utf-8"))

        if len(bookmark['extended']) > 0:
            bookmark['extended'] = quote(bookmark['extended'])
            bookmark_file.write(BOOKMARK_DESCRIPTION_FORMAT.format(**bookmark).encode("utf-8"))

        bookmark_file.write("\n")

    bookmark_file.write("""</DL></p>""")