googleplus: Haskell implementation of the Google+ API v1

[ bsd3, library, web ] [ Propose Tags ]

Will implement the Google+ REST API. Google+ is a social network made by Google. Found out more at http://plus.google.com. Implements the full API as of Oct 15, 2011. Only features read-only API access beacuse that is all that Google has published thus far. Both API and OAuth authentication is supported, but note that if you intend to use OAuth, this library does not currently provide the means to procure and renew OAuth tokens.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0, 0.2.1, 0.2.2, 0.3.0, 0.3.1, 0.3.1.1
Change log CHANGELOG
Dependencies aeson (>=0.3.1.1 && <0.4), attoparsec (>=0.9.1.2 && <0.10), base (>=4 && <5), bytestring (>=0.9.1.10 && <0.10), containers (>=0.4.0.0 && <0.5), enumerator (>=0.4.9 && <0.5), haskell98 (>=1.1.0.1 && <1.2), http-enumerator (>=0.7.0 && <0.8), http-types (>=0.6.0 && <0.7), mtl (>=2.0.1.0 && <2.1), text (>=0.11.0.5 && <0.12), time (>=1.2.0.3 && <1.5), timerep (>=1.0.0 && <1.1), transformers (>=0.2.2.0 && <0.3), url (>=2.1.2 && <2.3) [details]
License BSD-3-Clause
Author Michael Xavier <michael@michaelxavier.net>
Maintainer Michael Xavier <michael@michaelxavier.net>
Category Web
Home page http://github.com/michaelxavier/GooglePlus
Source repo head: git clone git://github.com/michaelxavier/GooglePlus.git
Uploaded by MichaelXavier at 2011-10-17T00:28:06Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Downloads 4387 total (11 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for googleplus-0.3.1.1

[back to package description]
Web.GooglePlus
------------

Haskell implementation of the GooglePlus api. For more info, see
http://developers.google.com/+/api/

Installation
------------
Requires that you have cabal installed. I've included a Makefile for convenience. To install run `make install`

Alternatively, you can install this from Hackage:
`cabal install googleplus`

Documentation
-------------
`make doc` will generate a doc directory. Point your browser at the index.html to see the Haddock documentation.


Brief Example
-------------
This example is included in the documentation of the Web.GooglePlus:

    {-# LANGUAGE OverloadedStrings #-}
    import Web.GooglePlus
    import Web.GooglePlus.Monad
    import Web.GooglePlus.Types
    import Control.Monad.Reader
    import Data.Text (unpack)

    doStuff :: GooglePlusM ()
    doStuff = do
      Right person <- getPerson Me
      Right feed   <- getActivityFeed Me PublicCollection
      -- ...
      return ()

    main :: IO ()
    main = do
      runReaderT (unGooglePlusM doStuff) env
      where env  = GooglePlusEnv { gpAuth = APIKey "MYKEY" }

Bugs
----
Use the issue tracker on github for bugs. I'll do my best to get them resolved
as soon as I can. One thing you may encounter is a parse error (resulting in a
Left value) in some of the API calls talking about a key missing. I've tried to
weed these out as much as possible but this is a result of Google not
explicitly specifying what fields will always be present. I've had to just feed
live data through the code to figure out what fields aren't always there. This,
consequently, is why there are so many Maybe fields in the datatypes. If you
spot one of these parse errors, please tell me right away so I can correct the
types.