iugusdk 1.0.0.alpha.26 → 1.0.0.alpha.27

data/app/controllers/iugu/sessions_controller.rb

@@ -4,7 +4,6 @@ class Iugu::SessionsController < Devise::SessionsController
   layout IuguSDK.alternative_layout
 
   def after_sign_in_path_for(resource_or_scope)
-    puts params
     params[:user].try(:[], :user_invitation).blank? ? IuguSDK::app_main_url : invitation_url
   end
 

data/app/controllers/iugu/settings_controller.rb

@@ -1,6 +1,7 @@
 class Iugu::SettingsController < ApplicationController
 
   before_filter :authenticate_user!, :except => :add_social
+  before_filter :verify_token
 
   layout IuguSDK.default_layout
 
@@ -22,4 +23,12 @@ class Iugu::SettingsController < ApplicationController
     raise ActionController::RoutingError.new("Access Denied") if access == false
   end
 
+  private
+
+  def verify_token
+    if IuguSDK::enable_user_api and current_user
+      current_user.send(:init_token) unless current_user.token
+    end
+  end
+
 end

data/app/mailers/iugu_mailer.rb

@@ -17,6 +17,7 @@ class IuguMailer < Devise::Mailer
     user = User.find(user_invitation.invited_by)
     set_locale(user)
     @user_invitation = user_invitation
+    @account = @user_invitation.account
     mail(to: @user_invitation.email, :subject => I18n.t("emails.user_invitation", account_name: @user_invitation.account.try(:name))) do |format|
       format.html { render "iugu/mailer/invitation" }
     end

data/app/views/iugu/invitations/edit.html.haml

@@ -1,13 +1,14 @@
 %div
-  = I18n.t("iugu.invited_by")
-  = @inviter.name
-%div
-  = I18n.t("iugu.account")
-  = @user_invitation.account.id.to_s
+  %h3
+    = I18n.t("iugu.invite_to", account_name: @user_invitation.account.name)
+  %h4
+    = I18n.t("iugu.invited_by")
+    = @inviter.name
 %div
   - if current_user
-    = link_to I18n.t("iugu.accept"), update_invite_path(:invitation_token => @user_invitation.id.to_s + @user_invitation.token), :method => :post
+    = link_to I18n.t("iugu.accept"), update_invite_path(:invitation_token => @user_invitation.id.to_s + @user_invitation.token), :method => :post, class: "button"
   - else
-    Você não está logado!
-    = link_to "Já tenho conta", new_user_session_path(invitation_token: @user_invitation.id.to_s + @user_invitation.token)
-    = link_to "Criar conta", new_user_registration_path(invitation_token: @user_invitation.id.to_s + @user_invitation.token)
+    %p
+      Você não está logado!
+    = link_to "Já tenho conta", new_user_session_path(invitation_token: @user_invitation.id.to_s + @user_invitation.token), class: "button"
+    = link_to "Criar conta", new_user_registration_path(invitation_token: @user_invitation.id.to_s + @user_invitation.token), class: "button"

data/app/views/iugu/mailer/invitation.html.haml

@@ -1 +1,8 @@
-= link_to edit_invite_url(:invitation_token => @user_invitation.id.to_s + @user_invitation.token), edit_invite_url(:invitation_token => @user_invitation.id.to_s + @user_invitation.token)
+%p
+  = I18n.t("iugu.welcome") 
+  #{@user_invitation.email}!
+%p 
+  = I18n.t("emails.you_were_invited", account_name: @account.name, application_name: IuguSDK::application_title)
+
+%p 
+  = link_to I18n.t("emails.accept_invitation"), edit_invite_url(:invitation_token => @user_invitation.id.to_s + @user_invitation.token)

data/config/locales/iugu.en.yml

@@ -6,6 +6,8 @@ en:
   emails:
     user_invitation: "You have been invited to %{account_name}"
     user_welcome: "Welcome to %{application_title}"
+    you_were_invited: "You were invited to join %{account_name} on %{application_name}"
+    accept_invitation: "Accept Invitation"
   errors:
     messages:
       only_owners_can_destroy_accounts: "Only owners can destroy Accounts"
@@ -42,7 +44,8 @@ en:
     back: "Back"
     save: "Save"
     create: "Create"
-    invited_by: "Invited by"
+    invited_by: "You were invited by"
+    invite_to: "Invite to join %{account_name}"
     accept: "Accept"
     invite: "Invite"
     permissions: "Permissions"

data/config/locales/iugu.pt-BR.yml

@@ -6,6 +6,8 @@ pt-BR:
   emails:
     user_invitation: "Convite para %{account_name}"
     user_welcome: "Bem-vindo a %{application_title}"
+    you_were_invited: "Você foi convidado(a) para se juntar a %{account_name} em %{application_name}"
+    accept_invitation: "Aceitar convite"
   errors:
     messages:
       only_owners_can_destroy_accounts: "Apenas donos podem remover contas"
@@ -42,7 +44,8 @@ pt-BR:
     back: "Voltar"
     save: "Salvar"
     create: "Criar"
-    invited_by: "Convidado por"
+    invited_by: "Você foi convidado por"
+    invite_to: "Convite para se juntar a %{account_name}"
     accept: "Aceitar"
     invite: "Convidar"
     permissions: "Permissões"

data/lib/iugusdk/version.rb

@@ -1,3 +1,3 @@
 module IuguSDK
-  VERSION = "1.0.0.alpha.26"
+  VERSION = "1.0.0.alpha.27"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: iugusdk
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha.26
+  version: 1.0.0.alpha.27
   prerelease: 6
 platform: ruby
 authors:
@@ -11,11 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-07 00:00:00.000000000 Z
+date: 2013-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &70171541835800 !ruby/object:Gem::Requirement
+  requirement: &70261128550740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -23,10 +23,10 @@ dependencies:
         version: 3.1.5
   type: :runtime
   prerelease: false
-  version_requirements: *70171541835800
+  version_requirements: *70261128550740
 - !ruby/object:Gem::Dependency
   name: coffee-script
-  requirement: &70171541834600 !ruby/object:Gem::Requirement
+  requirement: &70261128550140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -34,10 +34,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541834600
+  version_requirements: *70261128550140
 - !ruby/object:Gem::Dependency
   name: sass
-  requirement: &70171541833400 !ruby/object:Gem::Requirement
+  requirement: &70261128549180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -45,10 +45,10 @@ dependencies:
         version: 3.2.9
   type: :runtime
   prerelease: false
-  version_requirements: *70171541833400
+  version_requirements: *70261128549180
 - !ruby/object:Gem::Dependency
   name: eco
-  requirement: &70171541832620 !ruby/object:Gem::Requirement
+  requirement: &70261128548500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -56,10 +56,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541832620
+  version_requirements: *70261128548500
 - !ruby/object:Gem::Dependency
   name: haml
-  requirement: &70171541831780 !ruby/object:Gem::Requirement
+  requirement: &70261128564320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -67,10 +67,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541831780
+  version_requirements: *70261128564320
 - !ruby/object:Gem::Dependency
   name: compass
-  requirement: &70171541830720 !ruby/object:Gem::Requirement
+  requirement: &70261128563660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -78,10 +78,10 @@ dependencies:
         version: 0.12.2
   type: :runtime
   prerelease: false
-  version_requirements: *70171541830720
+  version_requirements: *70261128563660
 - !ruby/object:Gem::Dependency
   name: haml-rails
-  requirement: &70171541856060 !ruby/object:Gem::Requirement
+  requirement: &70261128562600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -89,10 +89,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541856060
+  version_requirements: *70261128562600
 - !ruby/object:Gem::Dependency
   name: rails-i18n
-  requirement: &70171541854760 !ruby/object:Gem::Requirement
+  requirement: &70261128561040 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -100,10 +100,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541854760
+  version_requirements: *70261128561040
 - !ruby/object:Gem::Dependency
   name: simple_form
-  requirement: &70171541853960 !ruby/object:Gem::Requirement
+  requirement: &70261128559540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -111,10 +111,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541853960
+  version_requirements: *70261128559540
 - !ruby/object:Gem::Dependency
   name: sass-rails
-  requirement: &70171541853400 !ruby/object:Gem::Requirement
+  requirement: &70261128558820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -122,10 +122,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541853400
+  version_requirements: *70261128558820
 - !ruby/object:Gem::Dependency
   name: rabl
-  requirement: &70171541852980 !ruby/object:Gem::Requirement
+  requirement: &70261128558160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -133,10 +133,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541852980
+  version_requirements: *70261128558160
 - !ruby/object:Gem::Dependency
   name: fuubar
-  requirement: &70171541852460 !ruby/object:Gem::Requirement
+  requirement: &70261128557680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -144,10 +144,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541852460
+  version_requirements: *70261128557680
 - !ruby/object:Gem::Dependency
   name: default_value_for
-  requirement: &70171541851860 !ruby/object:Gem::Requirement
+  requirement: &70261128557080 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -155,10 +155,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541851860
+  version_requirements: *70261128557080
 - !ruby/object:Gem::Dependency
   name: paperclip
-  requirement: &70171541851120 !ruby/object:Gem::Requirement
+  requirement: &70261128556480 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -166,10 +166,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541851120
+  version_requirements: *70261128556480
 - !ruby/object:Gem::Dependency
   name: prawn
-  requirement: &70171541850040 !ruby/object:Gem::Requirement
+  requirement: &70261128572340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -177,10 +177,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171541850040
+  version_requirements: *70261128572340
 - !ruby/object:Gem::Dependency
   name: prawn_rails
-  requirement: &70171532833060 !ruby/object:Gem::Requirement
+  requirement: &70261128571620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -188,10 +188,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532833060
+  version_requirements: *70261128571620
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &70171532831760 !ruby/object:Gem::Requirement
+  requirement: &70261128570840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -199,10 +199,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532831760
+  version_requirements: *70261128570840
 - !ruby/object:Gem::Dependency
   name: less
-  requirement: &70171532831140 !ruby/object:Gem::Requirement
+  requirement: &70261128566220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -210,10 +210,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532831140
+  version_requirements: *70261128566220
 - !ruby/object:Gem::Dependency
   name: kaminari
-  requirement: &70171532830240 !ruby/object:Gem::Requirement
+  requirement: &70261128565300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -221,10 +221,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532830240
+  version_requirements: *70261128565300
 - !ruby/object:Gem::Dependency
   name: devise
-  requirement: &70171532829160 !ruby/object:Gem::Requirement
+  requirement: &70261128583500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -232,10 +232,10 @@ dependencies:
         version: 2.1.2
   type: :runtime
   prerelease: false
-  version_requirements: *70171532829160
+  version_requirements: *70261128583500
 - !ruby/object:Gem::Dependency
   name: omniauth
-  requirement: &70171532828220 !ruby/object:Gem::Requirement
+  requirement: &70261128582840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -243,10 +243,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532828220
+  version_requirements: *70261128582840
 - !ruby/object:Gem::Dependency
   name: omniauth-twitter
-  requirement: &70171532826720 !ruby/object:Gem::Requirement
+  requirement: &70261128582020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -254,10 +254,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532826720
+  version_requirements: *70261128582020
 - !ruby/object:Gem::Dependency
   name: omniauth-facebook
-  requirement: &70171533060480 !ruby/object:Gem::Requirement
+  requirement: &70261128581060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -265,10 +265,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533060480
+  version_requirements: *70261128581060
 - !ruby/object:Gem::Dependency
   name: delayed_job_active_record
-  requirement: &70171533056180 !ruby/object:Gem::Requirement
+  requirement: &70261128580360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -276,10 +276,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533056180
+  version_requirements: *70261128580360
 - !ruby/object:Gem::Dependency
   name: koala
-  requirement: &70171533055540 !ruby/object:Gem::Requirement
+  requirement: &70261128579760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -287,10 +287,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533055540
+  version_requirements: *70261128579760
 - !ruby/object:Gem::Dependency
   name: activeuuid
-  requirement: &70171533054660 !ruby/object:Gem::Requirement
+  requirement: &70261128579180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -298,10 +298,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533054660
+  version_requirements: *70261128579180
 - !ruby/object:Gem::Dependency
   name: iugu-api
-  requirement: &70171533053580 !ruby/object:Gem::Requirement
+  requirement: &70261128578460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -309,10 +309,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533053580
+  version_requirements: *70261128578460
 - !ruby/object:Gem::Dependency
   name: iugu-ux
-  requirement: &70171533052660 !ruby/object:Gem::Requirement
+  requirement: &70261128577960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -320,10 +320,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171533052660
+  version_requirements: *70261128577960
 - !ruby/object:Gem::Dependency
   name: database_cleaner
-  requirement: &70171532849020 !ruby/object:Gem::Requirement
+  requirement: &70261128577460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -331,10 +331,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532849020
+  version_requirements: *70261128577460
 - !ruby/object:Gem::Dependency
   name: compass-rails
-  requirement: &70171532847880 !ruby/object:Gem::Requirement
+  requirement: &70261128576880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -342,10 +342,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532847880
+  version_requirements: *70261128576880
 - !ruby/object:Gem::Dependency
   name: money
-  requirement: &70171532846100 !ruby/object:Gem::Requirement
+  requirement: &70261128575960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -353,10 +353,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70171532846100
+  version_requirements: *70261128575960
 - !ruby/object:Gem::Dependency
   name: mysql2
-  requirement: &70171532845120 !ruby/object:Gem::Requirement
+  requirement: &70261128602780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -364,10 +364,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171532845120
+  version_requirements: *70261128602780
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70171532844300 !ruby/object:Gem::Requirement
+  requirement: &70261128601740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -375,10 +375,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171532844300
+  version_requirements: *70261128601740
 - !ruby/object:Gem::Dependency
   name: rspec-rails
-  requirement: &70171532843480 !ruby/object:Gem::Requirement
+  requirement: &70261128601140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -386,10 +386,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171532843480
+  version_requirements: *70261128601140
 - !ruby/object:Gem::Dependency
   name: shoulda-matchers
-  requirement: &70171532842920 !ruby/object:Gem::Requirement
+  requirement: &70261128599940 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -397,10 +397,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171532842920
+  version_requirements: *70261128599940
 - !ruby/object:Gem::Dependency
   name: fabrication
-  requirement: &70171532842320 !ruby/object:Gem::Requirement
+  requirement: &70261128599200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -408,10 +408,10 @@ dependencies:
         version: 2.4.0
   type: :development
   prerelease: false
-  version_requirements: *70171532842320
+  version_requirements: *70261128599200
 - !ruby/object:Gem::Dependency
   name: capybara
-  requirement: &70171532841240 !ruby/object:Gem::Requirement
+  requirement: &70261128598280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -419,10 +419,10 @@ dependencies:
         version: 1.1.2
   type: :development
   prerelease: false
-  version_requirements: *70171532841240
+  version_requirements: *70261128598280
 - !ruby/object:Gem::Dependency
   name: faker
-  requirement: &70171533221700 !ruby/object:Gem::Requirement
+  requirement: &70261128596740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -430,10 +430,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533221700
+  version_requirements: *70261128596740
 - !ruby/object:Gem::Dependency
   name: populator
-  requirement: &70171533220780 !ruby/object:Gem::Requirement
+  requirement: &70261128595540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -441,10 +441,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533220780
+  version_requirements: *70261128595540
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70171533219920 !ruby/object:Gem::Requirement
+  requirement: &70261128611320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -452,10 +452,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533219920
+  version_requirements: *70261128611320
 - !ruby/object:Gem::Dependency
   name: rr
-  requirement: &70171533218800 !ruby/object:Gem::Requirement
+  requirement: &70261128610820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -463,10 +463,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533218800
+  version_requirements: *70261128610820
 - !ruby/object:Gem::Dependency
   name: brakeman
-  requirement: &70171533218120 !ruby/object:Gem::Requirement
+  requirement: &70261128610360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -474,10 +474,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533218120
+  version_requirements: *70261128610360
 - !ruby/object:Gem::Dependency
   name: launchy
-  requirement: &70171533217360 !ruby/object:Gem::Requirement
+  requirement: &70261128609900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -485,7 +485,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70171533217360
+  version_requirements: *70261128609900
 description: SDK for Iugu Platform Applications
 email:
 - contato@iugu.com.br
@@ -1113,7 +1113,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2332762508241473502
+      hash: -2887057281973432164
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: