Skip to content

Oni-zerone/PunkAPI

Repository files navigation

PunkAPI

Version Build Status codebeat badge Coverage Status Language Platform License

This is a wrapper around PunkAPI v2 by @samjbmason you can find more informations about those APIs at https://punkapi.com/

Have you ever wanted to search through Brewdog's expansive back catalogue of beer in a programmatic way? Maybe build a tool that pairs beer with food, or search beers with an abv of more than 4%? Well now your prayers have been answered!

The Punk API takes Brewdog's DIY Dog and turns it into a searchable, filterable API that's completely free and open source.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Usage

let punkApi = PunkApi(configuration: .default)

punkApi.get(RandomBeerRequest(), queue: .main) { beersResult in  }
punkApi.get(BeerRequest(id: 1), queue: .main) { beersResult in  }
punkApi.get(RandomBeerRequest(), queue: .main) { beersResult in  }
punkApi.get(BeersRequest(filter: [.abv(condition: .more, value: 3),
                                  .beerName(value: "Punk")]), 
                         queue: .main) { beersResult in  }

API

RandomBeerRequest()

Get a random beer request

punkApi.get(RandomBeerRequest(), queue: .main) { beersResult in  }

BeerRequest(id: 1)

Get a beer from given id

punkApi.get(BeerRequest(id: 1), queue: .main) { beersResult in  }

BeersRequest(filter: [BeersRequest.Parameter.beerName(value: "Punk IPA")])

Get beers that match the passed in options, if no options are passed in it will return all beers in ascending order of id.

punkApi.get(RandomBeerRequest(), queue: .main) { beersResult in  }

Options

BeersRequest.Parameter.abv(condition: .more, value: 3)

Condition: Condition Value: Float Will return beers with an abv greater or lower than the passed in value.

BeersRequest.Parameter.ibu(condition: .more, value: 3)

Condition: Condition Value: Float Will return beers with an ibu greater or lower than the passed in value.

BeersRequest.Parameter.ebc(condition: .more, value: 3)

Condition: Condition Value: Float Will return beers with an ebc greater or lower than the passed in value.

BeersRequest.Parameter.beerName(value: "Punk")

Value: String Will return beers matching the string passed in (we use fuzzy matching to find the names).

BeersRequest.Parameter.yeast(value: "American Ale")

Value: String Will return beers which match the name of the yeast of the string passed in (we use fuzzy matching to find the yeast names).

BeersRequest.Parameter.brewed(condition: .more, value: 3)

Condition: Condition Value: Date Will return beers brewed before or after the passed in date.

BeersRequest.Parameter.hops(value: "Ahtanum")

Value: String Will return beers which match the name of the hops of the string passed in (we use fuzzy matching to find the hop names).

BeersRequest.Parameter.malt(value: "Extra Pale")

Value: String Will return beers which match the name of the malt of the string passed in (we use fuzzy matching to find the hop names).

BeersRequest.Parameter.food(value: "Cheesecake")

Value: String Will return beers which match food pairings of the string passed in (we use fuzzy matching to find the foods).

BeersRequest.Parameter.ids(value: [1, 2, 4, 6])

Value: Array<Int> Will return beers which match the given ids.

Installation

PunkAPI is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'PunkAPI'

Author

@Oni_zerone, [email protected]

License

PunkAPI is available under the MIT license. See the LICENSE file for more info.