Anjing Webshells

Website : rimsha.abasa.com
: / var / canvas / lib /
Filename : address_book.rb
back
# frozen_string_literal: true

#
# Copyright (C) 2016 - present Instructure, Inc.
#
# This file is part of Canvas.
#
# Canvas is free software: you can redistribute it and/or modify it under
# the terms of the GNU Affero General Public License as published by the Free
# Software Foundation, version 3 of the License.
#
# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
# details.
#
# You should have received a copy of the GNU Affero General Public License along
# with this program. If not, see <http://www.gnu.org/licenses/>.

# manually require since ::MessageableUser satisfies
# AddressBook::MessageableUser and prevents the autoload
require_relative "address_book/messageable_user"

# see AddressBook::Base for primary documentation of the interface
module AddressBook
  STRATEGIES = {
    "messageable_user" => { implementation: AddressBook::MessageableUser, label: -> { I18n.t("MessageableUser library") } }.freeze,
  }.freeze
  DEFAULT_STRATEGY = "messageable_user"

  def self.registry
    RequestStore.store[:address_books] ||= {}
  end

  # choose the implementation of address book according to the plugin setting
  def self.strategy
    DEFAULT_STRATEGY
  end

  def self.implementation
    STRATEGIES[strategy][:implementation]
  end

  # instantiates an address book for the sender
  def self.for(sender)
    registry[sender] ||= implementation.new(sender)
  end

  # partitions the list of recipients into user ids and context asset strings
  def self.partition_recipients(recipients)
    users = ::MessageableUser.individual_recipients(recipients)
    contexts = ::MessageableUser.context_recipients(recipients)
    [users, contexts]
  end

  # filters the list of users to only those that are "available" (but not
  # necessarily known to any particular sender)
  def self.available(users)
    GuardRail.activate(:secondary) do
      ::MessageableUser.available.where(id: users).to_a
    end
  end

  def self.decompose_context(context_code)
    context_code &&
      context_code =~ ::MessageableUser::Calculator::CONTEXT_RECIPIENT &&
      Regexp.last_match.to_a[1..]
  end

  def self.valid_context?(context_code)
    decompose_context(context_code).present?
  end

  def self.load_context(context_code)
    context_type, context_id = decompose_context(context_code)
    return nil unless context_id

    context_class =
      case context_type
      when "course" then Course
      when "section" then CourseSection
      when "group" then Group
      when "discussion_topic" then DiscussionTopic
      end
    context_class.find(context_id)
  end
end