platter 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a00adecb18e0e0327eb9196fc87caa678609443b
+  data.tar.gz: 4a84952b479d6b7d5488d56540e7784a93478d28
+SHA512:
+  metadata.gz: 463bd5003fd12f9c1923fb89845835471dc678935a56870eb06ba50aeade3865ceeb0eaf60752f5b769bc5942badfd545b2dc3968a1b1139405187512e850179
+  data.tar.gz: 724e20b727e2f1126e44ca89109690c1406d794278397fa9be7342fceddca6f3b68a33d747acf1e860ef55933290959b3b8903d4bf85542cfe413099ff4f9e8e

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.gem

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in platter.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Abraham Kuri
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1 @@
+# Work in progress...

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/platter

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+require 'pathname'
+
+source_path = (Pathname.new(__FILE__).dirname + '../lib').expand_path
+$LOAD_PATH << source_path
+
+require 'platter'
+
+templates_root = File.expand_path(File.join("..", "templates"), File.dirname(__FILE__))
+Platter::AppGenerator.source_root templates_root
+Platter::AppGenerator.source_paths << Rails::Generators::AppGenerator.source_root << templates_root
+
+Platter::AppGenerator.start

data/lib/platter.rb

@@ -0,0 +1,3 @@
+require "platter/version"
+require "platter/generators/app_generator"
+require "platter/app_builder"

data/lib/platter/app_builder.rb

@@ -0,0 +1,163 @@
+module Platter
+  class AppBuilder < Rails::AppBuilder
+    PORT = 3000
+
+    def readme
+      template "README.md.erb", "README.md"
+    end
+
+    def replace_gemfile
+      remove_file "Gemfile"
+      template "Gemfile.erb", "Gemfile"
+    end
+
+    #API builds
+    #
+    def add_api_support
+      inject_into_file "Gemfile", after: "ruby \"#{Platter::RUBY_VERSION}\"" do
+        %Q{
+
+gem "versionist"
+gem "active_model_serializers", github: "rails-api/active_model_serializers", branch: "0-8-stable"
+        }
+      end
+    end
+
+    def add_api_version_directories
+      empty_directory "app/controllers/api/v1/"
+    end
+
+    def add_api_version_base_controller
+      template "base_api_controller.erb", "app/controllers/api/v1/base_controller.rb"
+    end
+
+    def provide_api_routes
+      template "api_routes.erb", "config/routes.rb", force: true
+    end
+
+    #GIT builds
+    #
+    def setup_git
+      remove_file '.gitignore'
+      copy_file "platter_gitignore", ".gitignore"
+      git :init
+    end
+
+    def provide_first_commit
+      git add: "."
+      git commit: "-m 'Project initialization using Platter'"
+    end
+
+    #Server build
+    #
+    def setup_server
+      template "Procfile", "Procfile"
+    end
+
+    # Development builds
+    #
+    def provide_development_setup_bin
+      template "bin_development_setup.rb", "bin/setup", port: PORT, force: true
+      run "chmod a+x bin/setup"
+    end
+
+    def setup_development_mail_delivery_strategy
+      inject_into_file "config/environments/development.rb",
+        %Q{
+
+  # We use mailcatcher to preview emails
+  config.action_mailer.delivery_method = :smtp
+  config.action_mailer.smtp_settings = { :address => "localhost", :port => 1025 }
+  config.action_mailer.default_url_options = { host: "localhost:#{PORT}" }
+  config.action_mailer.asset_host = "http://localhost:#{PORT}"
+        },
+          after: "config.action_mailer.raise_delivery_errors = false"
+    end
+
+    def fix_i18n_deprecation_warning
+      inject_into_class 'config/application.rb', 'Application',
+        %Q{
+    config.i18n.enforce_available_locales = true\n}
+    end
+
+    def provide_generators_configuration
+      inject_into_file 'config/application.rb',
+        %q{
+    # don't generate RSpec tests for views and helpers
+    config.generators do |g|
+      g.test_framework :rspec, fixture: true
+      g.fixture_replacement :factory_girl, dir: 'spec/factories'
+      g.view_specs false
+      g.helper_specs false
+      g.stylesheets false
+      g.javascripts false
+      g.helper false
+    end
+    
+    config.autoload_paths += %W(#{config.root}/lib)
+        },
+          after: "config.active_record.raise_in_transactional_callbacks = true"
+    end
+
+    #TEST builds
+    #
+    def init_rspec
+      generate "rspec:install"
+    end
+
+    def add_support_rspec_files
+      empty_directory "spec/support/"
+      template "rspec_support_database_cleaner.erb", "spec/support/database_cleaner.rb"
+      template "rspec_support_factory_girl.erb", "spec/support/factory_girl.rb"
+      template "rspec_support_i18n.erb", "spec/support/i18n.rb"
+    end
+
+    #STAGING builds
+    #
+    def copy_production_env_to_staging
+      template "production_env.erb", "config/environments/staging.rb"
+    end
+
+    #ACTIVE JOB builds
+    #
+    def init_delayed_job
+      generate "delayed_job:active_record"
+      run `bundle exec rake db:migrate`
+    end
+
+    def add_delayed_job_active_job_configuration
+      inject_into_file 'config/application.rb',
+        %q{
+
+    # ActiveJob Configuration
+    config.active_job.queue_adapter = :delayed_job
+        },
+          after: "config.active_record.raise_in_transactional_callbacks = true"
+    end
+
+    #MAILER builds
+    #
+    def init_sendgrid_initialize_file
+      template "mailer_initializer_config.erb", "config/initializers/mailer_setup.rb"
+    end
+    
+
+    def add_exception_notification_mailer_configuration
+      %w{ production staging }.each do |env|
+        inject_into_file "config/environments/#{env}.rb",
+          %Q{
+
+  #Exception Notification configuration
+  config.middleware.use ExceptionNotification::Rack,
+  :email => {
+    :email_prefix => "[Printoo] ",
+    :sender_address => %{"Staging Exception" <exception@#{app_name.downcase}-#{env}.herokuapp.com>},
+    :exception_recipients => %w{}
+  }
+          },
+            after: "config.active_record.dump_schema_after_migration = false"
+      end
+    end
+
+  end
+end

data/lib/platter/generators/app_generator.rb

@@ -0,0 +1,102 @@
+require 'rails/generators'
+require 'rails/generators/rails/app/app_generator'
+
+module Platter
+  class AppGenerator < Rails::Generators::AppGenerator
+    class_option :database, type: :string, aliases: "-d", default: "postgresql",
+      desc: "Configure for selected database. PostgreSQL by default."
+
+    class_option :skip_test_unit, type: :boolean, aliases: "-T", default: true,
+      desc: "Skip Test::Unit files"
+
+    class_option :skip_turbolinks, type: :boolean, default: true,
+      desc: "Skips the turbolinks gem"
+
+    class_option :api, type: :boolean, default: false,
+      desc: "Adds API support gems"
+
+    class_option :skip_bundle, type: :boolean, aliases: "-B", default: true,
+      desc: "Don't run bundle install"
+
+    def finish_template
+      invoke :platter
+      super
+    end
+
+    def platter
+      invoke :custom_gemfile
+      invoke :setup_development_environment
+      invoke :setup_test_environment
+      invoke :setup_staging_environment
+      invoke :add_active_job_configuration
+      invoke :add_api_support
+      invoke :setup_mailer
+      invoke :setup_server
+      invoke :setup_git
+    end
+
+    def custom_gemfile
+      build :replace_gemfile
+
+      bundle_command 'install'
+    end
+
+    def add_api_support
+      if options[:api]
+        say "Adding API support"
+        build :add_api_support
+        build :add_api_version_directories
+        build :add_api_version_base_controller
+        build :provide_api_routes
+      end
+    end
+
+    def setup_git
+      say "Initializing git"
+      build :setup_git
+      build :provide_first_commit
+    end
+
+    def setup_server
+      say "Setting up the server"
+      build :setup_server
+    end
+
+    def setup_development_environment
+      say "Setting up the development environment"
+      build :provide_development_setup_bin
+      build :setup_development_mail_delivery_strategy
+      build :fix_i18n_deprecation_warning
+      build :provide_generators_configuration
+    end
+
+    def setup_test_environment
+      say "Setting up the test environment"
+      build :init_rspec
+      build :add_support_rspec_files
+    end
+
+    def setup_staging_environment
+      say "Setting up the staging environment"
+      build :copy_production_env_to_staging
+    end
+
+    def add_active_job_configuration
+      say "Setting up ActiveJob with DelayedJob"
+      build :init_delayed_job
+      build :add_delayed_job_active_job_configuration
+    end
+
+    def setup_mailer
+      say "Setting up Sendgrid configuration"
+      build :init_sendgrid_initialize_file
+      build :add_exception_notification_mailer_configuration
+    end
+
+    protected
+
+      def get_builder_class
+        Platter::AppBuilder
+      end
+  end
+end

data/lib/platter/version.rb

@@ -0,0 +1,5 @@
+module Platter
+  RAILS_VERSION = "4.2.1"
+  RUBY_VERSION = "2.2.1"
+  VERSION = "0.0.1"
+end

data/platter.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'platter/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = ">= #{Platter::RUBY_VERSION}"
+  spec.name          = "platter"
+  spec.version       = Platter::VERSION
+  spec.authors       = ["Icalia Labs"]
+  spec.email         = ["kurenn@icalialabs.com"]
+  spec.summary       = %q{A summary}
+  spec.description   = %q{A description}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = ['platter'] #spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+
+  spec.add_dependency 'rails', Platter::RAILS_VERSION
+  spec.add_dependency 'thor'
+end

data/templates/Gemfile.erb

@@ -0,0 +1,38 @@
+source "https://rubygems.org"
+
+ruby "<%= Platter::RUBY_VERSION %>"
+
+gem "rails", "<%= Platter::RAILS_VERSION %>"
+gem "delayed_job_active_record"
+gem "jquery-rails"
+gem "pg"
+gem "sass-rails", "~> 5.0"
+gem "coffee-rails", "~> 4.1.0"
+gem "uglifier", ">= 1.3.0"
+gem "puma"
+
+group :development do
+  gem "spring"
+  gem "spring-commands-rspec"
+  gem "web-console"
+end
+
+group :development, :test do
+  gem "awesome_print"
+  gem "factory_girl_rails"
+  gem "pry-rails"
+  gem "rspec-rails", "~> 3.1.0"
+  gem "ffaker"
+end
+
+# Test gems
+group :test do
+  gem "database_cleaner"
+  gem "shoulda-matchers"
+end
+
+# Production and staging gems
+group :production, :staging do
+  gem "rails_12factor"
+  gem "exception_notification"
+end

data/templates/Procfile

@@ -0,0 +1 @@
+web: bundle exec puma -t 5:5 -p ${PORT:-3000} -e ${RACK_ENV:-development}

data/templates/README.md.erb

@@ -0,0 +1,23 @@
+# <%= app_name.humanize %>
+
+# Getting started
+
+This application assumes you have at least Ruby, Postgres and other dependencies to run. 
+If that is not the case you can use [kaishi] to install everything you need.
+
+[kaishi]: https://github.com/IcaliaLabs/kaishi
+
+After setting up you can start using the application:
+
+  % rails server
+
+Or if you feel like using Foreman (comes with kaishi):
+
+  % foreman start
+
+## Icalia Guides
+
+Remember you can always rely on the Icalia Guides to a better development and
+internal progamming style:
+
+* [Rails Guides](https://github.com/IcaliaLabs/icalia_guides/tree/master/rails)

data/templates/api_routes.erb

@@ -0,0 +1,12 @@
+Rails.application.routes.draw do
+
+  # Change the line below to handle every request through a subdomain
+  #namespace :api, constraints: { subdomain: 'api' }, path: '/' do
+  namespace :api, path: '/api' do
+    api_version(:module => "V1", :header => {:name => "Accept",
+                                             :value => "application/vnd.<%= app_name.downcase %>.com+json; version=1"},
+                                             :defaults => {:format => :json}, :default => true) do
+    end
+  end
+
+end

data/templates/base_api_controller.erb

@@ -0,0 +1,4 @@
+class Api::V1::BaseController < ApplicationController
+  protect_from_forgery with: :null_session
+
+end

data/templates/bin_development_setup.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env sh
+
+# Credits to thoughtbot
+
+# Exit if any subcommand fails
+set -e
+
+# Set up Ruby dependencies via Bundler
+gem install bundler --conservative
+bundle check || bundle install
+
+# Set up database and add any development seed data
+bundle exec rake db:setup
+
+# Add binstubs to PATH via export PATH=".git/safe/../../bin:$PATH" in ~/.zshenv
+mkdir -p .git/safe
+
+# Pick a port for Foreman
+if ! grep --quiet --no-messages --fixed-strings 'port' .foreman; then
+  printf 'port: <%= config[:port_number] %>\n' >> .foreman
+fi
+
+if ! command -v foreman > /dev/null; then
+  printf 'Foreman is not installed.\n'
+  printf 'See https://github.com/ddollar/foreman for install instructions.\n'
+fi

data/templates/mailer_initializer_config.erb

@@ -0,0 +1,11 @@
+if Rails.env.staging? || Rails.env.production?
+  ActionMailer::Base.smtp_settings = {
+    :user_name => ENV['SENDGRID_USERNAME'],
+    :password => ENV['SENDGRID_PASSWORD'],
+    :domain => ENV['SENDGRID_DOMAIN'],
+    :address => "smtp.sendgrid.net",
+    :port => 587,
+    :authentication => :plain,
+    :enable_starttls_auto => true
+  }
+end

data/templates/platter_gitignore

@@ -0,0 +1,31 @@
+# See https://help.github.com/articles/ignoring-files for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile '~/.gitignore_global'
+
+# Ignore bundler config.
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+/db/*.sqlite3-journal
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+
+# Extra files to ignore
+doc/
+*.swp
+*.swo
+*~
+.DS_Store
+
+!.keep
+/.foreman
+/public/system
+/public/assets
+/public/uploads
+.sass-cache/*
+*.dump

data/templates/production_env.erb

@@ -0,0 +1,79 @@
+Rails.application.configure do
+  # Settings specified here will take precedence over those in config/application.rb.
+
+  # Code is not reloaded between requests.
+  config.cache_classes = true
+
+  # Eager load code on boot. This eager loads most of Rails and
+  # your application in memory, allowing both threaded web servers
+  # and those relying on copy on write to perform better.
+  # Rake tasks automatically ignore this option for performance.
+  config.eager_load = true
+
+  # Full error reports are disabled and caching is turned on.
+  config.consider_all_requests_local       = false
+  config.action_controller.perform_caching = true
+
+  # Enable Rack::Cache to put a simple HTTP cache in front of your application
+  # Add `rack-cache` to your Gemfile before enabling this.
+  # For large-scale production use, consider using a caching reverse proxy like
+  # NGINX, varnish or squid.
+  # config.action_dispatch.rack_cache = true
+
+  # Disable serving static files from the `/public` folder by default since
+  # Apache or NGINX already handles this.
+  config.serve_static_files = ENV['RAILS_SERVE_STATIC_FILES'].present?
+
+  # Compress JavaScripts and CSS.
+  config.assets.js_compressor = :uglifier
+  # config.assets.css_compressor = :sass
+
+  # Do not fallback to assets pipeline if a precompiled asset is missed.
+  config.assets.compile = false
+
+  # Asset digests allow you to set far-future HTTP expiration dates on all assets,
+  # yet still be able to expire them through the digest params.
+  config.assets.digest = true
+
+  # `config.assets.precompile` and `config.assets.version` have moved to config/initializers/assets.rb
+
+  # Specifies the header that your server uses for sending files.
+  # config.action_dispatch.x_sendfile_header = 'X-Sendfile' # for Apache
+  # config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for NGINX
+
+  # Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
+  # config.force_ssl = true
+
+  # Use the lowest log level to ensure availability of diagnostic information
+  # when problems arise.
+  config.log_level = :debug
+
+  # Prepend all log lines with the following tags.
+  # config.log_tags = [ :subdomain, :uuid ]
+
+  # Use a different logger for distributed setups.
+  # config.logger = ActiveSupport::TaggedLogging.new(SyslogLogger.new)
+
+  # Use a different cache store in production.
+  # config.cache_store = :mem_cache_store
+
+  # Enable serving of images, stylesheets, and JavaScripts from an asset server.
+  # config.action_controller.asset_host = 'http://assets.example.com'
+
+  # Ignore bad email addresses and do not raise email delivery errors.
+  # Set this to true and configure the email server for immediate delivery to raise delivery errors.
+  # config.action_mailer.raise_delivery_errors = false
+
+  # Enable locale fallbacks for I18n (makes lookups for any locale fall back to
+  # the I18n.default_locale when a translation cannot be found).
+  config.i18n.fallbacks = true
+
+  # Send deprecation notices to registered listeners.
+  config.active_support.deprecation = :notify
+
+  # Use default logging formatter so that PID and timestamp are not suppressed.
+  config.log_formatter = ::Logger::Formatter.new
+
+  # Do not dump schema after migrations.
+  config.active_record.dump_schema_after_migration = false
+end

data/templates/rspec_support_database_cleaner.erb

@@ -0,0 +1,13 @@
+require 'database_cleaner'
+RSpec.configure do |config|
+  config.before(:suite) do
+    DatabaseCleaner.strategy = :truncation
+    DatabaseCleaner.clean_with(:truncation)
+  end
+  config.before(:each) do
+    DatabaseCleaner.start
+  end
+  config.after(:each) do
+    DatabaseCleaner.clean
+  end
+end

data/templates/rspec_support_factory_girl.erb

@@ -0,0 +1,3 @@
+RSpec.configure do |config|
+  config.include FactoryGirl::Syntax::Methods
+end

data/templates/rspec_support_i18n.erb

@@ -0,0 +1,13 @@
+module I18nHelperMethods
+  include I18n
+
+  def t *args
+    I18n.t(*args)
+  end
+
+end
+
+RSpec.configure do |config|
+  config.include I18nHelperMethods 
+end
+

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: platter
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Icalia Labs
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.1
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A description
+email:
+- kurenn@icalialabs.com
+executables:
+- platter
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/platter
+- lib/platter.rb
+- lib/platter/app_builder.rb
+- lib/platter/generators/app_generator.rb
+- lib/platter/version.rb
+- platter.gemspec
+- templates/Gemfile.erb
+- templates/Procfile
+- templates/README.md.erb
+- templates/api_routes.erb
+- templates/base_api_controller.erb
+- templates/bin_development_setup.rb
+- templates/mailer_initializer_config.erb
+- templates/platter_gitignore
+- templates/production_env.erb
+- templates/rspec_support_database_cleaner.erb
+- templates/rspec_support_factory_girl.erb
+- templates/rspec_support_i18n.erb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: A summary
+test_files: []
+has_rdoc: