Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mgan59/python-pinboard
A Python module to access Pinboard.in via its API. This is a fork/modification of mudge/python-delicious
https://github.com/mgan59/python-pinboard
Last synced: 15 days ago
JSON representation
A Python module to access Pinboard.in via its API. This is a fork/modification of mudge/python-delicious
- Host: GitHub
- URL: https://github.com/mgan59/python-pinboard
- Owner: mgan59
- License: other
- Fork: true (mudge/python-delicious)
- Created: 2010-11-10T16:58:23.000Z (about 14 years ago)
- Default Branch: master
- Last Pushed: 2014-12-23T03:38:08.000Z (almost 10 years ago)
- Last Synced: 2024-07-31T05:13:41.015Z (3 months ago)
- Language: Python
- Homepage:
- Size: 251 KB
- Stars: 168
- Watchers: 12
- Forks: 18
- Open Issues: 2
-
Metadata Files:
- Readme: README.markdown
- License: LICENSE
Awesome Lists containing this project
README
# Python-Pinboard
Python module to access Pinboard via its API. This project is a fork from the original work by Paul Mucur on the Python-Delicious API.
## Installation
To install using easy-install:
```bash
python setup.py install
```
Or (if you have pip installed)
```bash
pip install -e git://github.com/mgan59/[email protected]#egg=python-pinboard
```
## Usage
To get started you must first open a connection to pinboard.in, there are authentication methods
Standard method using `username/password`
```python
import pinboard
# create pinboard connection (using username/password)
pinboard_conn = pinboard.open('username', 'password')
```
A method using your `api token` from the pinboard.in settings
```python
# an alternative method using an api token
pinboard_conn = pinboard.open(token='username:23asdfjlkj')
```
Now how to actual `add` and `delete` bookmarks
```python
# Example of adding a bookmark
# .add('url', 'title', 'description', ('tags', 'as', 'a', 'tuple'))
p.add('https://github.com/mgan59/python-pinboard/',
'Python-Pinboard',
'A Python module to access the contents of a Pinboard account via the Pinboard API.',
('computing', 'python'))
# .add without a description but using a kwarg tags to specify the tuple
p.add('https://github.com/mgan59/python-pinboard',
'Python-Pinboard',
tags=('computing', 'python', 'projects'))
# .delete uses the bookmark url since they are unique
p.delete('https://github.com/mgan59/python-pinboard')
```
## Contributors
--
* Original Creator [Paul Mucur](https://github.com/mudge)
* [Morgan Craft](https://github.com/mgan59)
[](https://bitdeli.com/free "Bitdeli Badge")