Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/oz/pinboard.cr

A crystal client for the Pinboard API
https://github.com/oz/pinboard.cr

api crystal pinboard

Last synced: 2 months ago
JSON representation

A crystal client for the Pinboard API

Lists

README

        

# pinboard

[![CI](https://github.com/oz/pinboard.cr/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/oz/pinboard.cr/actions/workflows/ci.yml)

A crystal client for the [Pinboard] API.

## Installation

Add this to your application's `shard.yml`:

```yaml
dependencies:
pinboard:
git: https://git.cypr.io/oz/pinboard.cr.git
```

## Usage

```crystal
require "pinboard"

pinboard = Pinboard::Client.new(token: "my secret token")
posts = pinboard.recent
if posts.is_a?(Pinboard::Error)
puts posts.to_s
else
posts.each do |post|
puts "#{post.title}\n url:#{post.url}\n tags: #{post.tags.join(",")}\n"
end
end
```

Pinboard returns either a `Pinboard::Error`, or something else. Check the tests
to be sure.

## Contributing

1. Clone `https://git.cypr.io/oz/pinboard.cr.git`,
2. Create your feature branch (`git checkout -b my-new-feature`),
3. Commit your changes (`git commit -am 'Add some feature'`),
4. Create a patch (`git format-patch origin`),
5. Send patch to `[email protected]`.

## Contributors

- [oz](https://github.com/oz) Arnaud Berthomier - creator, maintainer

[Pinboard]: https://pinboard.in/