The library passes most of the unit tests listed in the api documentation. see the documentation (http://code.google.com/apis/safebrowsing/developers_guide_v2.html) for more details about the failed tests.

the google safe browsing database must be stored and managed locally. net::google::safebrowsing2::sqlite uses sqlite as the storage back-end, net::google::safebrowsing2::mysql uses mysql. other storage mechanisms (databases, memory, etc.) can be added and used transparently with this module.

you may want to look at "google safe browsing v2: implementation notes" (http://www.zscaler.com/research/google%20safe%20browsing%20v2%20api.pdf), a collection of notes and real-world numbers about the api. this is intended for people who want to learn more about the api, whether as a user or to make their own implementation.

the source code is available on github at https://github.com/juliensobrier/net-google-safebrowsing2.

if you do not need to inspect more than 10,000 urls a day, you can use net::google::safebrowsing2::lookup with the google safe browsing v2 lookup api which does not require to store and maintain a local database.

important: if you start with an empty database, you will need to perform several updates to retrieve all the google safe browsing information. this may require up to 24 hours. this is a limitation of the google api, not of this module. see "google safe browsing v2: implementation notes" at http://www.zscaler.com/research/google%20safe%20browsing%20v2%20api.pdf.