# gistpod > CLI helpers for hosting ad-hoc CocoaPods podspecs as GitHub gists during rapid development Latest version **0.2.2** (published 2015-01-26) · WTFPL license · 0 weekly downloads ## Install ```sh npm install gistpod pnpm add gistpod yarn add gistpod bun add gistpod ``` Provides the command `gistpod`. ## Health **Score 5/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support; pre 1.0. Negative: insecure dependencies; abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.2.2 | | Published | 2015-01-26 | | First published | 2015-01-09 | | Weekly downloads | 0 | | License | WTFPL | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 11 | | Known vulnerabilities | 0 (+4 in 2 direct dependencies) | | Install scripts | no | | Author | bryn austin bellomy | | Maintainers | brynb | | Keywords | hello, welcome, hi, cli, terminal | ## Links - npm: https://www.npmjs.com/package/gistpod - Repository: https://github.com/brynbellomy/gistpod - Issues: https://github.com/brynbellomy/gistpod/issues - npm.io page: https://npm.io/package/gistpod ## Dependencies (11) - [when](https://npm.io/package/when.md) 3.6.x - [async](https://npm.io/package/async.md) 0.9.x - [chalk](https://npm.io/package/chalk.md) 0.5.x - [cliff](https://npm.io/package/cliff.md) 0.1.x - [hoagie](https://npm.io/package/hoagie.md) 0.6.x - [request](https://npm.io/package/request.md) 2.51.x - [shelljs](https://npm.io/package/shelljs.md) 0.3.x - [fs-extra](https://npm.io/package/fs-extra.md) 0.14.x - [commander](https://npm.io/package/commander.md) 2.6.x - [cli-components](https://npm.io/package/cli-components.md) 0.2.5 - [command-router](https://npm.io/package/command-router.md) git://github.com/brynbellomy/command-router#master ## Alternatives - [@oh-my-pi/pi-natives](https://npm.io/package/@oh-my-pi/pi-natives.md) — 51.8K weekly downloads - [@capgo/capacitor-light-sensor](https://npm.io/package/@capgo/capacitor-light-sensor.md) — 3.0K weekly downloads - [@heyhuynhgiabuu/pi-diff](https://npm.io/package/@heyhuynhgiabuu/pi-diff.md) — 492 weekly downloads - [@lotsa/verdant-lang-asm](https://npm.io/package/@lotsa/verdant-lang-asm.md) — 38 weekly downloads - [new-era-syntax](https://npm.io/package/new-era-syntax.md) — 20 weekly downloads ## Recent versions - 0.2.2 (latest) — 2015-01-26 - 0.2.1 — 2015-01-26 - 0.2.0 — 2015-01-26 - 0.1.2 — 2015-01-25 - 0.1.0 — 2015-01-15 - 0.0.6 — 2015-01-15 - 0.0.5 — 2015-01-12 - 0.0.4 — 2015-01-12 - 0.0.3 — 2015-01-12 - 0.0.2 — 2015-01-09 - 0.0.1 — 2015-01-09 ## README # gistpod ``` Usage: gistpod [options] [command] Commands: username set the GitHub username from which to retrieve gists (config file: ~/.gistpod) url look up the latest gist URL for the specified CocoaPod pull pull the latest data from the GitHub API into your local cache (~/.gistpod-cache) update [pods...] updates the gist refs for the given Pods (or all Pods, if none are specified) in the specified Podfile to the latest revisions list list known podspec gists help [cmd] display help for [cmd] Options: -h, --help output usage information -V, --version output the version number ``` CLI tool (written in node.js) to facilitate using GitHub gists as temporary CocoaPods podspecs. **Works with Swift-enabled versions of CocoaPods** (`gem install cocoapods --pre`). In fact, that's pretty much the only reason I made this. Given how much of the Swift code out in the wild still has no official podspec (and, for that matter, given all of the one-page microclasses I've found myself writing in Swift), I've been using **gists** () pretty frequently to deal with temporary (and rapidly-changing) podspecs during fast development cycles. But the problem, as far as I can tell, is that any time you commit a change to a gist, the raw gist URL changes. (I'm not aware of any redirect URL to the actual raw source... is anyone else?). That means that every time you change a podspec, you'll be stuck copying its new gist URL around to all of your `Podfiles` manually. **Can NOT be trifling with that.** I'd much rather just `Cmd-Tab` into iTerm and run something... like... ```sh $ gistpod update Podfile updated. ``` # moar examples ``` $ gistpod list Pod Podspec gist URL ------------------- ------------------------------------------------------------------ ReactiveCocoaSwift https://gist.github.com/brynbellomy/.../ReactiveCocoaSwift.podspec JSTilemap https://gist.github.com/brynbellomy/.../JSTilemap.podspec Signals https://gist.github.com/brynbellomy/.../Signals.podspec Starscream https://gist.github.com/brynbellomy/.../Starscream.podspec Basis https://gist.github.com/brynbellomy/.../Basis.podspec # the update command is: # $ gistpod update [Podfile directory] [pods to update] $ gistpod update . Starscream ReactiveCocoa-Swift Podfile updated. ``` - `gistpod list`: 0. queries your GitHub account for all gists containing at least one `podspec` file — i.e., matching the pattern `*.podspec`... 0. ...and displays the direct, raw URL to the latest revision of each podspec's gist. *(Note: just to be totally clear, I added the dot-dot-dots. The command gives the full path.)* ------------- - `gistpod update`: 0. **backs up** `/Podfile` to `~/.gistpod-backup`, ... 0. **reads your Podfile template** from `/Podfile.gistpod`, and then ... 0. **writes an updated Podfile** to `/Podfile`. Each pod placeholder (`#{Starscream}`, etc.) is replaced by its respective URL (from the `gistpod list` command). Now you can `pod install` your heart out, confident that your jank-ass, ghetto-rigged ("dev") in-house podspecs are all at least referencing the latest commits in your gist account. ------------- # install Install with `npm` ```sh $ npm install -g gistpod ``` Set your GitHub username (one-time): ```sh $ gistpod username brynbellomy ``` Now you can list all of the podspecs that you have stored as gists: ```sh $ gistpod list ``` _**@@TODO:** display a diff if there were any changes_ # main usage/workflow ### 1. Make a copy of your `Podfile` called `Podfile.gistpod`. Put it in ``, alongside the original: ```sh $ cp Podfile Podfile.gistpod ``` ### 2. Open `Podfile.gistpod`. You will need to change the `:podspec => '...'` URLs for any of the podspecs that you want to keep automatically synced with your gists account. The entire podspec URL (including quotes) must be replaced with the placeholder `#{PodName}`. **In other words,** change this: ```ruby platform :osx, '10.10' pod 'Starscream', :podspec => 'https://raw.github.com/dfd19ac23..../Starscream.podspec' pod 'ReactiveCocoa-Swift', :podspec => 'https://raw.github.com/fdc2a3d19..../ReactiveCocoa-Swift.podspec' ``` ...to this: ```ruby platform :osx, '10.10' pod 'Starscream', :podspec => #{Starscream} pod 'ReactiveCocoa-Swift', :podspec => #{ReactiveCocoa-Swift} ``` ### 3. Update your local cache of podspec URLs with `gistpod pull`. ```sh $ gistpod pull ``` _**@@TODO:** display a diff if there were any changes_ ### 4. Run `gistpod update` to update the URLs in your `Podfile`. This does the inverse of **step 3**: it finds all of those `#{PodPlaceholders}` in your `Podfile.gistpod` and replaces each one with the latest commit URL for its respective podspec. ```sh $ gistpod update [optional path to Podfile] [optional list of pods to update] ``` Any time you run `gistpod update`, your `Podfile` is backed up (to `~/.gistpod-backup`) and then overwritten with a new `Podfile` built from its accompanying `Podfile.gistpod`. The `#{PodPlaceholders}` will be replaced by URLs pointing at the latest revision of each of your gist podspecs on GitHub. # other commands The `gistpod url` command returns *only* the gist URL for a given podspec (and not a byte more or less): ```sh $ gistpod url Starscream ``` This is useful if you're doing any kind of shell scripting, or if you want to (painlessly) copy the URL to the clipboard, or... ```sh $ gistpod url Starscream | pbcopy ``` # authors bryn austin bellomy < > --- _Source: https://npm.io/package/gistpod · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._