socialite 0.0.1.beta4 → 0.1.0.pre

data/spec/socialite_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+class User; end
+class Identity; end
+
+describe Socialite do
+  context "configuration" do
+    it 'is configurable through .setup' do
+      Socialite.setup do |c|
+        c.should be_kind_of(Module)
+      end
+    end
+
+    describe 'configuring classes' do
+      before do
+        Socialite.setup do |c|
+          c.user_class = 'User'
+          c.identity_class = 'Identity'
+        end
+      end
+
+      its(:user_class) { should eql(User) }
+      its(:identity_class) { should eql(Identity) }
+    end
+
+    describe 'accepting provider information' do
+      before do
+        Socialite.providers = nil
+        Socialite.setup do |c|
+          c.provider :facebook, 'xyz', '123'
+          c.provider :twitter, 'abc', '789'
+        end
+      end
+
+      subject { Socialite.providers }
+
+      its(:size) { should == 2 }
+
+      describe 'holds all the provider parameters for OmniAuth' do
+        it 'has facebook data' do
+          subject.first[0].should == :facebook
+          subject.first[1].should == ['xyz', '123']
+        end
+
+        it 'has twitter data' do
+          subject.last[0].should == :twitter
+          subject.last[1].should == ['abc', '789']
+        end
+      end
+
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -2,9 +2,12 @@
 ENV["RAILS_ENV"] = "test"
 
 require File.expand_path('../dummy/config/environment.rb',  __FILE__)
-require 'rails/test_help'
 require 'rspec/rails'
 
+# Testing Generators
+require 'ammeter/init'
+require 'factory_girl_rails'
+
 # Should matchers
 require 'shoulda/matchers'
 
@@ -13,17 +16,27 @@ Rails.backtrace_cleaner.remove_silencers!
 # Load support files
 Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }
 
-# Load factories
-require 'factory_girl'
-Dir["#{File.dirname(__FILE__)}/factories/**/*.rb"].each { |f| require f }
-
-# Run any available migration
-ActiveRecord::Migrator.migrate File.expand_path('../dummy/db/migrate/', __FILE__)
+# Run migrations if present
+ActiveRecord::Migrator.migrate File.expand_path("../dummy/db/migrate/", __FILE__)
 
 RSpec.configure do |config|
-  require 'rspec/expectations'
   config.include RSpec::Matchers
-  # config.include Socialite::Identity
-
   config.use_transactional_fixtures = true
+  config.infer_base_class_for_anonymous_controllers = false
+  config.order = "random"
+
+  config.expect_with :rspec do |c|
+    c.syntax = [:should, :expect]
+  end
+
+  # http://stackoverflow.com/a/12978795
+  config.include Capybara::DSL, type: :request
+end
+
+def identity_class
+  Socialite.identity_class
+end
+
+def user_class
+  Socialite.user_class
 end

data/spec/support/identity_shared_example.rb

@@ -2,15 +2,15 @@ module Socialite
   shared_examples 'identity' do
     it { should belong_to(:user) }
 
-    it { should have_db_column(:unique_id) }
+    it { should have_db_column(:uid) }
     it { should have_db_column(:provider) }
     it { should have_db_column(:auth_hash) }
 
-    it { should validate_presence_of(:unique_id) }
+    it { should validate_presence_of(:uid) }
     it { should validate_presence_of(:provider) }
 
-    it { should validate_uniqueness_of(:unique_id).scoped_to(:provider) }
-    it { should validate_uniqueness_of(:provider).scoped_to(:user_id).case_insensitive }
+    it { should validate_uniqueness_of(:uid).scoped_to(:provider) }
+    it { should validate_uniqueness_of(:provider).scoped_to("#{user_class.table_name.singularize}_id").case_insensitive }
 
     describe '.find_or_initialize_by_oauth' do
       let(:auth_hash) do
@@ -25,21 +25,25 @@ module Socialite
       end
 
       describe 'facebook' do
-        # let(:fb_identity) { }
-        subject { Identity.find_or_initialize_by_oauth(auth_hash) }
+        subject { identity_class.find_or_initialize_by_omniauth(auth_hash) }
 
-        it { should be_a(Identity) }
+        it { should be_a(identity_class) }
         its(:persisted?) { should be_false }
 
         context 'existing identity' do
           let(:user) { FactoryGirl.create(:linked_user) }
           let(:identity) { user.identities.first }
-          let(:auth_hash) { identity.auth_hash.merge('provider' => identity.provider, 'uid' => identity.unique_id) }
-          subject { Identity.find_or_initialize_by_oauth(auth_hash) }
-          before { user.identities.count.should > 0; identity.user.should be_present }
+          let(:auth_hash) { identity.auth_hash.merge('provider' => identity.provider, 'uid' => identity.uid) }
+
+          subject { identity_class.find_or_initialize_by_omniauth(auth_hash) }
+
+          before do
+            user.identities.count.should > 0
+            identity.user.should be_present
+          end
 
           its(:persisted?) { should be_true }
-          its(:user) { should be_a(User) }
+          its(:user) { should be_a(user_class) }
           its(:user) { should eql(user) }
         end
       end
@@ -55,13 +59,13 @@ module Socialite
     end
   end
 
-  shared_examples 'facebook api' do
-    it { should respond_to(:account_url) }
-    it { should respond_to(:api) }
-    it { should respond_to(:api_connection) }
-    it { should respond_to(:checkins) }
-    it { should respond_to(:friends) }
-    it { should respond_to(:picture) }
-    it { should respond_to(:info) }
-  end
+  # shared_examples 'facebook api' do
+    # it { should respond_to(:account_url) }
+    # it { should respond_to(:api) }
+    # it { should respond_to(:api_connection) }
+    # it { should respond_to(:checkins) }
+    # it { should respond_to(:friends) }
+    # it { should respond_to(:picture) }
+    # it { should respond_to(:info) }
+  # end
 end

metadata

@@ -1,251 +1,309 @@
 --- !ruby/object:Gem::Specification
 name: socialite
 version: !ruby/object:Gem::Version
-  version: 0.0.1.beta4
   prerelease: 6
+  version: 0.1.0.pre
 platform: ruby
 authors:
 - Justin Smestad
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-03 00:00:00.000000000Z
+date: 2013-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70258980161920 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.1.0
-  type: :runtime
-  prerelease: false
-  version_requirements: *70258980161920
-- !ruby/object:Gem::Dependency
-  name: sass-rails
-  requirement: &70258980161100 !ruby/object:Gem::Requirement
+        version: 3.2.11
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.1.0
-  type: :runtime
+        version: 3.2.11
   prerelease: false
-  version_requirements: *70258980161100
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: simple_form
-  requirement: &70258980160380 !ruby/object:Gem::Requirement
+  name: jquery-rails
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.5.2
-  type: :runtime
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980160380
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: haml
-  requirement: &70258980159800 !ruby/object:Gem::Requirement
+  name: sass-rails
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.1.2
-  type: :runtime
-  prerelease: false
-  version_requirements: *70258980159800
-- !ruby/object:Gem::Dependency
-  name: oa-core
-  requirement: &70258980159280 !ruby/object:Gem::Requirement
+        version: 3.2.0
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.3.0.rc3
-  type: :runtime
+        version: 3.2.0
   prerelease: false
-  version_requirements: *70258980159280
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: oa-oauth
-  requirement: &70258980158660 !ruby/object:Gem::Requirement
+  name: simple_form
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.3.0.rc3
-  type: :runtime
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980158660
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: koala
-  requirement: &70258980157880 !ruby/object:Gem::Requirement
+  name: haml
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.2.0beta4
-  type: :runtime
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980157880
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: grackle
-  requirement: &70258980157040 !ruby/object:Gem::Requirement
+  name: omniauth
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.1.10
-  type: :runtime
+        version: 1.1.0
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
   prerelease: false
-  version_requirements: *70258980157040
+  type: :runtime
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &70258980156460 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
   prerelease: false
-  version_requirements: *70258980156460
+  type: :development
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70258980155660 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: *70258980155660
-- !ruby/object:Gem::Dependency
-  name: rdiscount
-  requirement: &70258980154860 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
   prerelease: false
-  version_requirements: *70258980154860
+  type: :development
 - !ruby/object:Gem::Dependency
   name: rspec-rails
-  requirement: &70258980153900 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.6.1
-  type: :development
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980153900
+  type: :development
 - !ruby/object:Gem::Dependency
-  name: factory_girl
-  requirement: &70258980147880 !ruby/object:Gem::Requirement
+  name: factory_girl_rails
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.1.0
-  type: :development
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980147880
+  type: :development
 - !ruby/object:Gem::Dependency
   name: shoulda-matchers
-  requirement: &70258980147140 !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
   prerelease: false
-  version_requirements: *70258980147140
+  type: :development
 - !ruby/object:Gem::Dependency
-  name: cucumber-rails
-  requirement: &70258980145900 !ruby/object:Gem::Requirement
+  name: capybara
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 1.0.6
-  type: :development
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980145900
+  type: :development
 - !ruby/object:Gem::Dependency
-  name: database_cleaner
-  requirement: &70258980145100 !ruby/object:Gem::Requirement
+  name: ammeter
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.6.7
-  type: :development
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980145100
+  type: :development
 - !ruby/object:Gem::Dependency
-  name: selenium-webdriver
-  requirement: &70258980144080 !ruby/object:Gem::Requirement
+  name: omniauth-identity
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.4.0
-  type: :development
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980144080
+  type: :development
 - !ruby/object:Gem::Dependency
-  name: launchy
-  requirement: &70258980143240 !ruby/object:Gem::Requirement
+  name: omniauth-facebook
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ~>
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: '0'
+  prerelease: false
   type: :development
+- !ruby/object:Gem::Dependency
+  name: omniauth-twitter
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   prerelease: false
-  version_requirements: *70258980143240
+  type: :development
 description: Rails engine supporting multiple auth providers per user.
 email: justin.smestad@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .autotest
-- .gitignore
-- .rspec
-- .travis.yml
-- .yardopts
-- Gemfile
-- Gemfile.lock
-- LICENSE
-- README.md
-- Rakefile
-- app/assets/images/socialite/.gitkeep
-- app/assets/javascripts/socialite/.gitkeep
-- app/assets/stylesheets/socialite.css
 - app/assets/stylesheets/socialite/socialite.css
+- app/assets/stylesheets/socialite.css
+- app/controllers/socialite/application_controller.rb
 - app/controllers/socialite/identities_controller.rb
 - app/controllers/socialite/session_controller.rb
 - app/controllers/socialite/users_controller.rb
-- app/models/socialite/facebook_identity.rb
-- app/models/socialite/identity.rb
-- app/models/socialite/user.rb
+- app/views/layouts/socialite/application.html.haml
 - app/views/socialite/identities/_identities.html.haml
+- app/views/socialite/identities/new.html.haml
 - app/views/socialite/session/new.html.haml
 - app/views/socialite/user/_form.html.haml
 - app/views/socialite/user/edit.html.haml
 - app/views/socialite/user/show.html.haml
-- config/initializers/simple_form.rb
-- config/locales/simple_form.en.yml
 - config/routes.rb
-- db/migrate/20110914215410_create_users.rb
-- db/migrate/20110925224222_create_identities.rb
-- db/migrate/20110926005551_create_facebook_identities.rb
+- lib/generators/socialite/install_generator.rb
+- lib/generators/socialite/migrations_generator.rb
+- lib/generators/socialite/templates/identity.rb.erb
+- lib/generators/socialite/templates/socialite.rb
+- lib/generators/socialite/templates/users.rb.erb
+- lib/socialite/controllers/helpers.rb
+- lib/socialite/engine.rb
+- lib/socialite/helpers/authentication.rb
+- lib/socialite/models/facebook_identity.rb
+- lib/socialite/models/identity_concern.rb
+- lib/socialite/models/user_concern.rb
+- lib/socialite/version.rb
+- lib/socialite.rb
+- lib/tasks/socialite_tasks.rake
+- LICENSE
+- Rakefile
+- README.md
 - features/authentication/facebook_signin.feature
 - features/authentication/twitter_signin.feature
 - features/identities/facebook_management.feature
@@ -261,33 +319,16 @@ files:
 - features/support/omniauth.rb
 - features/support/paths.rb
 - features/support/selectors.rb
-- lib/generators/socialite/install_generator.rb
-- lib/generators/socialite/templates/socialite.rb
-- lib/socialite.rb
-- lib/socialite/api_wrappers/facebook.rb
-- lib/socialite/api_wrappers/twitter.rb
-- lib/socialite/controllers/helpers.rb
-- lib/socialite/engine.rb
-- lib/socialite/helpers/authentication.rb
-- lib/socialite/models/facebook_identity.rb
-- lib/socialite/models/identity.rb
-- lib/socialite/models/user.rb
-- lib/socialite/service_config.rb
-- lib/socialite/version.rb
-- lib/tasks/.gitkeep
-- lib/tasks/cucumber.rake
-- lib/tasks/socialite_tasks.rake
-- script/cucumber
-- script/rails
-- socialite.gemspec
+- spec/dummy/README.rdoc
 - spec/dummy/Rakefile
 - spec/dummy/app/assets/javascripts/application.js
 - spec/dummy/app/assets/stylesheets/application.css
 - spec/dummy/app/controllers/application_controller.rb
-- spec/dummy/app/controllers/home_controller.rb
 - spec/dummy/app/helpers/application_helper.rb
-- spec/dummy/app/views/home/index.html.haml
-- spec/dummy/app/views/home/show.html.haml
+- spec/dummy/app/mailers/.gitkeep
+- spec/dummy/app/models/.gitkeep
+- spec/dummy/app/models/identity.rb
+- spec/dummy/app/models/user.rb
 - spec/dummy/app/views/layouts/application.html.erb
 - spec/dummy/config.ru
 - spec/dummy/config/application.rb
@@ -306,7 +347,11 @@ files:
 - spec/dummy/config/initializers/wrap_parameters.rb
 - spec/dummy/config/locales/en.yml
 - spec/dummy/config/routes.rb
+- spec/dummy/db/migrate/20130206224516_create_socialite_users.rb
+- spec/dummy/db/migrate/20130206224517_create_socialite_identities.rb
 - spec/dummy/db/schema.rb
+- spec/dummy/lib/assets/.gitkeep
+- spec/dummy/log/.gitkeep
 - spec/dummy/public/404.html
 - spec/dummy/public/422.html
 - spec/dummy/public/500.html
@@ -316,9 +361,12 @@ files:
 - spec/factories/identity.rb
 - spec/factories/twitter.rb
 - spec/factories/user.rb
+- spec/generators/socialite/install_generator_spec.rb
+- spec/generators/socialite/migrations_generator_spec.rb
 - spec/models/facebook_spec.rb
 - spec/models/identity_spec.rb
 - spec/models/user_spec.rb
+- spec/socialite_spec.rb
 - spec/spec_helper.rb
 - spec/support/.gitkeep
 - spec/support/database_loader.rb
@@ -335,10 +383,10 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
       segments:
       - 0
-      hash: -2813799985366239650
+      hash: 2817215725849609740
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -347,7 +395,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Rails engine supporting multiple auth providers per user.
@@ -367,14 +415,16 @@ test_files:
 - features/support/omniauth.rb
 - features/support/paths.rb
 - features/support/selectors.rb
+- spec/dummy/README.rdoc
 - spec/dummy/Rakefile
 - spec/dummy/app/assets/javascripts/application.js
 - spec/dummy/app/assets/stylesheets/application.css
 - spec/dummy/app/controllers/application_controller.rb
-- spec/dummy/app/controllers/home_controller.rb
 - spec/dummy/app/helpers/application_helper.rb
-- spec/dummy/app/views/home/index.html.haml
-- spec/dummy/app/views/home/show.html.haml
+- spec/dummy/app/mailers/.gitkeep
+- spec/dummy/app/models/.gitkeep
+- spec/dummy/app/models/identity.rb
+- spec/dummy/app/models/user.rb
 - spec/dummy/app/views/layouts/application.html.erb
 - spec/dummy/config.ru
 - spec/dummy/config/application.rb
@@ -393,7 +443,11 @@ test_files:
 - spec/dummy/config/initializers/wrap_parameters.rb
 - spec/dummy/config/locales/en.yml
 - spec/dummy/config/routes.rb
+- spec/dummy/db/migrate/20130206224516_create_socialite_users.rb
+- spec/dummy/db/migrate/20130206224517_create_socialite_identities.rb
 - spec/dummy/db/schema.rb
+- spec/dummy/lib/assets/.gitkeep
+- spec/dummy/log/.gitkeep
 - spec/dummy/public/404.html
 - spec/dummy/public/422.html
 - spec/dummy/public/500.html
@@ -403,11 +457,15 @@ test_files:
 - spec/factories/identity.rb
 - spec/factories/twitter.rb
 - spec/factories/user.rb
+- spec/generators/socialite/install_generator_spec.rb
+- spec/generators/socialite/migrations_generator_spec.rb
 - spec/models/facebook_spec.rb
 - spec/models/identity_spec.rb
 - spec/models/user_spec.rb
+- spec/socialite_spec.rb
 - spec/spec_helper.rb
 - spec/support/.gitkeep
 - spec/support/database_loader.rb
 - spec/support/databases.yml
 - spec/support/identity_shared_example.rb
+has_rdoc: