{"id":22196660,"url":"https://github.com/druids/xpusher","last_synced_at":"2025-03-24T22:40:15.008Z","repository":{"id":57714111,"uuid":"136613092","full_name":"druids/xpusher","owner":"druids","description":"A Pusher client for coin exchanges based on core.async","archived":false,"fork":false,"pushed_at":"2018-12-10T10:25:44.000Z","size":11,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-30T02:14:12.302Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/druids.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-08T11:58:14.000Z","updated_at":"2024-12-03T07:16:04.000Z","dependencies_parsed_at":"2022-09-26T21:31:12.598Z","dependency_job_id":null,"html_url":"https://github.com/druids/xpusher","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/druids%2Fxpusher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/druids%2Fxpusher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/druids%2Fxpusher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/druids%2Fxpusher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/druids","download_url":"https://codeload.github.com/druids/xpusher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245366207,"owners_count":20603438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-02T14:16:01.177Z","updated_at":"2025-03-24T22:40:14.978Z","avatar_url":"https://github.com/druids.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"xpusher\n=======\n\nA Pusher client for coin exchanges based on [core.async](https://github.com/clojure/core.async).\n\n[![CircleCI](https://circleci.com/gh/druids/xpusher.svg?style=svg)](https://circleci.com/gh/druids/xpusher)\n[![Dependencies Status](https://jarkeeper.com/druids/xpusher/status.png)](https://jarkeeper.com/druids/xpusher)\n[![License](https://img.shields.io/badge/MIT-Clause-blue.svg)](https://opensource.org/licenses/MIT)\n\n\nLeiningen/Boot\n--------------\n\n```clojure\n[xpusher \"0.2.0\"]\n```\n\nDocumentation\n-------------\n\nThis library is a thin wrapper around `com.pusher/pusher-java-client` within a simple usage. A function `new-pusher`\n opens a new connection with the Pusher server, subscribes a requested channel and returns a following tuple\n`[pusher pusher-channel status-ch data-ch]` where\n\n- `pusher` a Pusher instance\n- `pusher` a subscribed Channel instance\n- `status-ch` an async channel containing a pusher and channel messages as a tuple `[action data]`\n- `data-ch` an async channel containing data for the subscribed channel as a tuple `[channel-name event-name data]`\n\nThe function takes an option object:\n- `channel-name` a channel name to subscribe, required\n- `pusher-key` a Pusher key, default de504dc5763aeef9ff52, optional\n- `event-name` an event name to bind on the subscribed channel, optional\n- `status-buffer-or-n` a buffer-or-n for the status channel, optional\n- `data-buffer-or-n` a buffer-or-n for the data channel, optional\n- `str-big-decimals?` when `true` coerce a volume and price (in strings) as `BigDecimal`, default `true`\n\nData channel returns a tuple of channel-name, event-name (as `keyword`), and data.\n\nStatus channel returns a tuple of event-name (as `keyword`), and data. Expected events:\n\n- `:change`\n- `:connecting`\n- `:connected`\n- `:disconnecting`\n- `:disconnected`\n\n\n### Bitstamp\n\n```clojure\n(require '[clojure.core.async :as async])\n(require '[xpusher.async :as xpusher])\n\n(let [[pusher pusher-channel status-ch data-ch]\n      (xpusher/new-bitstamp-pusher {:channel-name \"order_book_btceur\" ;; required\n                                    :event-name \"data\" ;; required\n                                    :data-buffer-or-n (async/sliding-buffer 16) ;; optinal\n                                    :status-buffer-or-n 16})] ;; optional\n  (async/go-loop []\n                 (let [[channel-name event-name data] (async/\u003c! data-ch)]\n                   (println channel-name event-name data)) ;; \u003c-- put you logic here\n                 (recur))\n  (async/go-loop []\n                 (let [[event-name data] (async/\u003c! status-ch)]\n                   (println event-name data)) ;; \u003c-- put status handler here\n                 (recur)))\n```\n\nAn established connection can be disconnected by\n\n```clojure\n(xpusher/disconnect pusher)\n```\n\nand again connected within same `pusher` instance\n\n```clojure\n(xpusher/connect pusher)\n```\n\n\n### Coinmate\n\n```clojure\n(require '[clojure.core.async :as async])\n(require '[xpusher.async :as xpusher])\n\n(let [[pusher pusher-channel status-ch data-ch]\n      (xpusher/new-coinmate-pusher {:channel-name \"order_book-BTC_EUR\" ;; required\n                                    :event-name \"order_book\" ;; required\n                                    :data-buffer-or-n (async/sliding-buffer 16) ;; optinal\n                                    :status-buffer-or-n 16})] ;; optional\n  (async/go-loop []\n                 (let [[channel-name event-name data] (async/\u003c! data-ch)]\n                   (println channel-name event-name data)) ;; \u003c-- put you logic here\n                 (recur))\n  (async/go-loop []\n                 (let [[event-name data] (async/\u003c! status-ch)]\n                   (println event-name data)) ;; \u003c-- put status handler here\n                 (recur)))\n```\n\n\n#### Notes\n\n- floating-point numbers are parsed as `BigDecimal`s\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdruids%2Fxpusher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdruids%2Fxpusher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdruids%2Fxpusher/lists"}