The googleplus package

[Tags: bsd3, library]

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]

Properties

Versions0.1.0, 0.2.1, 0.2.2, 0.3.0, 0.3.1, 0.3.1.1
Change logCHANGELOG
Dependenciesaeson (>=0.3.1.1 && <0.4), attoparsec (>=0.9.1.2 && <0.10), base (==4.*), 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]
LicenseBSD3
AuthorMichael Xavier <michael@michaelxavier.net>
MaintainerMichael Xavier <michael@michaelxavier.net>
CategoryWeb
Home pagehttp://github.com/michaelxavier/GooglePlus
Source repositoryhead: git clone git://github.com/michaelxavier/GooglePlus.git
UploadedMon Oct 17 00:28:06 UTC 2011 by MichaelXavier
DistributionsNixOS:0.3.1.1
Downloads804 total (29 in last 30 days)
Votes
0 []
StatusDocs uploaded by user
Build status unknown [no reports yet]

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for googleplus-0.3.1.1

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.