Skip to main content

pincushion

Test

pincushion is a command line tool for creating archives for resources on Historypin. It reads data from the Historypin API and writes a static website to a given directory. The resulting file structure looks something like:

archive
├── collections
│   ├── my-collection
│   │   ├── image.jpg
│   │   └── index.html
│   ├── my-other-collection
│   │   ├── image.jpg
│   │   └── index.html
│   └── my-last-collection
│       ├── image.jpg
│       └── index.html
├── data.json
├── index.html
├── pins
│   ├── 123 
│   │   ├── image.jpg
│   │   └── index.html
│   ├── 456
│   │   ├── image.jpg
│   │   └── index.html
│   ├── 789 
│   │   ├── image.jpg
│   │   └── index.html
│   ├── 1001 
│   │   ├── index.html
│   │   └── media.mp3
│   └── 2112
│       ├── index.html
│       └── media.mp4
└── user.jpg

Each pin has its own directory, which contains the uploaded media (image, audio or video). The data.json file is an aggregation of JSON data collected from the Historypin API, which is used to create the static site.

Install

pip install pincushion

Use

Create an archive for user 11670:

pincushion user --user-id 11670 --archive-path my-archive

Open the my-archive/index.html file in your browser.

Similarly you can create an archive for a "collection" as long as the collection contains sub-collections:

pincushion collection --slug 2025-summer-institute --archive-path my-collection

Metadata

Release files for pincushion 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pincushion 0.5.1
File Size Uploaded Provenance Actions
pincushion-0.5.1.tar.gz 125.2 kB Without provenance Details for pincushion-0.5.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pincushion 0.5.1
File Interpreter ABI Platform Actions
pincushion-0.5.1-py3-none-any.whl Python 3 none any Details for pincushion-0.5.1-py3-none-any.whl

Total release size: 202.5 kB

Release files / pincushion-0.5.1.tar.gz

Download URL pincushion-0.5.1.tar.gz
Size 125.2 kB
Tags Source
SHA-256 checksum
How to use checksums
25e467af7956e97a13f004637ad439bee2c93bb69db4973493b01a7b10b347c1
BLAKE2b-256 checksum
How to use checksums
61ee3545a9fa9b7085e063a3f06b5019ccf0b16329eac4722999b9929e21872b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.8

Release files / pincushion-0.5.1-py3-none-any.whl

Download URL pincushion-0.5.1-py3-none-any.whl
Size 77.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c7740f445fd721d6d07e959956bf9f6c557a0cc266ebe99d3ce68f49e3e9fdfd
BLAKE2b-256 checksum
How to use checksums
040fe80d0630f1a0f4521a1b291493f1cb32316e3a03d65e9060c67f376a5592
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.8

Security for pincushion 0.5.1

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page