google-directory 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d9417c85363cbdc8ced42e39d32e8e49f3845e03
-  data.tar.gz: 8b56b71c57f1d9a93d5399012ee70297e8135fd2
+  metadata.gz: 31dd3d1b04d40d4b86f41f51811ff1b04b5ce090
+  data.tar.gz: a96170d567eb79df73a110431dc92a9cd490b341
 SHA512:
-  metadata.gz: b419f61c90f0c1ea03e6629eeeedcf9b04ba0d43a3142dc86a3115670cc3d5e74194d030aa474fea82ffdd0bb7e684e9a2aea1d2809491efeec7b16df0e626ba
-  data.tar.gz: 1293a889bf8c3fc5ef28acea9d66f8f7403bf6729d0f9b021561dacf8716f8fef133a7e5dd32ca134ec5d0a1848e91be567e85f12254858540494c5b7a994b5b
+  metadata.gz: 0e40b022c65cfd68efe99c77539eeb74e1a8a6a9228de041628884154a2dd6e5c02f25d0995cd604f1d322967f6cd93f618b49aacaadb10770dc1cea2349f446
+  data.tar.gz: 4cd5d284c3cf4eb2065a1a02c60ca900c2a2e9c83353c78297e8ae941e630cf84054739d5097a9d1f58fe80957ec6c458b4e8dbcfc330f64928078216b5dc1a9

data/.gitignore

@@ -0,0 +1,10 @@
+._*
+.DS_Store
+.bundle
+.rvmrc
+*.log
+
+test/*
+pkg/*
+
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Declare your gem's dependencies in google_directory.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+# To use a debugger
+# gem 'byebug', group: [:development, :test]

data/README.md

@@ -0,0 +1,101 @@
+# Google Directory API
+
+## Description
+
+Simple Google Directory API wrapper for Ruby on Rails. 
+This relies on the [Google API Ruby Client](https://github.com/Omac/google-directory.git).
+
+## Install
+
+Add the gem to the Gemfile
+
+```ruby
+gem 'google-directory'
+```
+
+## Configuration
+
+First configure your API in `initializers/google_directory.rb`
+
+``` ruby
+GoogleDirectory.configure do
+
+	use_yaml Rails.root.join('config', 'google_directory.yaml')
+
+	admin_email 'admin@domain.com'
+
+	key_file Rails.root.join('config', 'keys', 'private_key.p12')
+
+	key_passphrase 'notasecret'
+
+	issuer 'xxxxxxx@developer.gserviceaccount.com'
+
+end
+```
+
+Using YAML as the Token Store will create a file with the access tokens. The gem will refresh the token automatically when after they expire and it will rewrite the new access token to the YAML file. Producing something like this:
+
+``` yaml
+development: 
+  scope:
+    token_type: Bearer
+    issued_at: ISSUED_DATE
+    access_token: ACCESS_TOKEN
+    expires_in: 3600
+```
+
+### Multiple Google API access tokens using scopes
+
+Specify a scope in the configuration `initializers/google_directory.rb`. 
+
+``` ruby
+GoogleDirectory.configure do
+
+	use_yaml Rails.root.join('config', 'google_directory.yaml')
+
+	scope :domain_one do
+		admin_email 'admin@domain_one.com'
+		# [...]
+	end
+
+	scope :domain_two do
+		admin_email 'admin@domain_two.com'
+		# [...]
+	end
+
+end
+```
+Keep in mind that the Token Store will be the same for all the scopes configured.
+
+## Usage
+``` ruby
+google = GoogleDirectory::Client.new
+
+google.find_users
+
+google.create_user(email, "given_name", "family_name", "password")
+
+google.update_user(email, update_data)
+
+google.delete_user(email)
+
+google.update_user_password(email, new_password)
+
+```
+
+### Multiple Scopes
+
+``` ruby
+domain_one = GoogleDirectory::Client.new(:domain_one)
+domain_one.find_users
+
+domain_two = GoogleDirectory::Client.new(:domain_two)
+domain_two.find_users
+```
+
+## TO DO
+
+* `use_active_model` for database token store.
+* Build the configuration generator.
+* Implement more parameters from the Google API.
+* Testing.

data/google-directory.gemspec

@@ -0,0 +1,25 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require "google-directory/version"
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+	s.name        = "google-directory"
+	s.version     = GoogleDirectory::VERSION
+	s.authors     = ["Omar Osorio"]
+	s.email       = ["omar@kioru.com"]
+	s.homepage    = "https://github.com/Omac/google-directory"
+	s.summary     = "Simple Google Directory API client wrapper for Rails"
+	s.description = "Relying on the Google Ruby API gem you are able to set up a Rails project for consuming the Directory API (or the Admin SDK). Even multiple domain access is allowed using scopes."
+	s.license     = "MIT"
+
+	s.files         = `git ls-files`.split("\n") # Dir["{app,lib}/**/*", "MIT-LICENSE", "Rakefile", "README.rdoc"]
+	s.test_files    = Dir["test/**/*"]
+	s.require_paths = ['lib']
+
+	s.add_dependency 'google-api-client', '~> 0.8'
+
+	s.add_development_dependency 'rails', '~> 4.2'
+	s.add_development_dependency "sqlite3"
+end

data/lib/{google_directory.rb → google-directory.rb}

@@ -26,7 +26,7 @@ module GoogleDirectory
 
             if token = @config.load_token
 
-                token[:issued_at] = DateTime.parse( token[:issued_at] )
+                token['issued_at'] = DateTime.parse( token['issued_at'] )
                 @client.authorization.update_token!(token)
 
             else

data/lib/google-directory/config.rb

@@ -43,7 +43,7 @@ module GoogleDirectory
 		# access_token:
 		# expires_in:
 		def save_token(token_hash)
-			token_hash = token_hash.slice(:token_type, :issued_at, :access_token, :expires_in)
+			token_hash = token_hash.slice('token_type', 'issued_at', 'access_token', 'expires_in')
 			@token_store and @token_store.save(@scope_name, token_hash)
 		end
 
@@ -118,12 +118,12 @@ module GoogleDirectory
 
 		def save( scope_name, token_hash )
 			data = (@yaml_data[Rails.env.to_s] ||= {})
-			data[scope_name.to_s] = token_hash.stringify_keys
+			data[scope_name.to_s] = token_hash
 			File.open(@yaml_file, 'w') { |file| file.write( YAML::dump(@yaml_data) ) }
 		end
 
 		def load( scope_name )
-			data = @yaml_data[Rails.env.to_s] and data = data[scope_name.to_s] and data.symbolize_keys.slice(:token_type, :issued_at, :access_token, :expires_in)
+			data = @yaml_data[Rails.env.to_s] and data = data[scope_name.to_s] and data.slice('token_type', 'issued_at', 'access_token', 'expires_in')
 		end
 
 	end

data/lib/google-directory/version.rb

@@ -1,3 +1,3 @@
 module GoogleDirectory
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-directory
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Omar Osorio
@@ -61,11 +61,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
+- Gemfile
 - MIT-LICENSE
+- README.md
 - Rakefile
+- google-directory.gemspec
+- lib/google-directory.rb
 - lib/google-directory/config.rb
 - lib/google-directory/version.rb
-- lib/google_directory.rb
 - lib/tasks/google-directory_tasks.rake
 - test/dummy/README.rdoc
 - test/dummy/Rakefile