Webservice and application providing social popularity statistics for your website.
Nothing fancy, just wanted to have simple and neat API to get all the statistics I want. I'm also kinda pedantic and wanted to style social buttons whatever I like in an easy way. I hope that this app will be also simple for you and you'll enjoy using it.
Btw, this application is proudly written in Go language. It turned out to be a translated version of similar webservice I wrote in Ruby. However, unlike the Ruby ones this is fully parallel and at the end aprox. 10 times faster than original one (benchmarks don't lie). Check out my blog post to get more details.
This is standard Go web application and can be build and tested using
go toolchain, however most of the tasks are simplified with
Because of that you must have Ruby 1.9 and Bundler installed.
$ git clone git://github.com/nu7hatch/egoistat.git $ cd egoistat $ go get . && bundle $ rake build $ rake test
Now run the server with:
$ rake server
http://localhost:5000 and enjoy.
Egoistat provides public API which can be queried in two ways. You can perform standard HTTP query to get social networks' points in JSON format:
$ curl -H 'Accept: application/json' http://egoistat.com/api/v1/stat.json?url=PAGE_URL&n=NETWORKS
PAGE_URL must be full URL with scheme specified, eg. http://egoistat.net/.
Note, that the most correct results for the domain comes when trailing
slash is in the address.
NETWORKS gets comma separated list of social networks to get points from.
Currently available networks are:
You can also request a script ready to use on your website, so that no backend calls will be required:
This script defines the egoistat global variable - it responds to
points(sn) function which
return points count for specified social network
It is also possible to specify
CALLBACK which is going to be executed after
script gets loaded.
This app is heroku ready, so if you want to deply it there it's uber simple. Just run:
$ rake deploy
This target makes sure that assets are compiled and pushes everything to heroku's remote.
Frontend of the application is written in HTML5 + Backbone.js. Source
assets can be found in
assets/ directory. Files in
generated by assets packaging script and should not be edited.
$ rake assets:precompile
DEV switch you can turn minifying on and off. For example
the following command will only merge scripts, without minifying.
$ rake assets:precompile DEV=1
To speed up development use
guard. This command will run watcher
$ rake assets:watch
Every time source file changes it will rebuild assets and reload your browser (if it has LiveReload addon enabled).
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
Copyright (c) 2012 by Chris Kowalik a.k.a. nu7hatch
Released under AGPLv3 license. Check LICENSE for details.