openproject/spec/lib/api/v3/utilities/path_helper_spec.rb

#-- copyright
# OpenProject is an open source project management software.
# Copyright (C) 2012-2021 the OpenProject GmbH
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License version 3.
#
# OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
# Copyright (C) 2006-2013 Jean-Philippe Lang
# Copyright (C) 2010-2013 the ChiliProject Team
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program 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 General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
# See docs/COPYRIGHT.rdoc for more details.
#++

require 'spec_helper'

describe ::API::V3::Utilities::PathHelper do
  let(:helper) { Class.new.tap { |c| c.extend(::API::V3::Utilities::PathHelper) }.api_v3_paths }

  shared_examples_for 'path' do |url|
    it 'provides the path' do
      is_expected.to match(url)
    end

    it 'prepends the sub uri if configured' do
      allow(OpenProject::Configuration).to receive(:rails_relative_url_root)
        .and_return('/open_project')

      is_expected.to match("/open_project#{url}")
    end
  end

  before(:each) do
    RequestStore.store[:cached_root_path] = nil
  end

  after(:each) do
    RequestStore.clear!
  end

  shared_examples_for 'api v3 path' do |url|
    it_behaves_like 'path', "/api/v3#{url}"
  end

  shared_examples_for 'index' do |name|
    plural_name = name.to_s.pluralize

    describe "##{plural_name}" do
      subject { helper.send(plural_name) }

      it_behaves_like 'api v3 path', "/#{plural_name}"
    end
  end

  shared_examples_for 'show' do |name|
    describe "##{name}" do
      subject { helper.send(:"#{name}", 42) }

      it_behaves_like 'api v3 path', "/#{name.to_s.pluralize}/42"
    end
  end

  shared_examples_for 'create form' do |name|
    describe "#create_#{name}_form" do
      subject { helper.send(:"create_#{name}_form") }

      it_behaves_like 'api v3 path', "/#{name.to_s.pluralize}/form"
    end
  end

  shared_examples_for 'update form' do |name|
    describe "##{name}_form" do
      subject { helper.send(:"#{name}_form", 42) }

      it_behaves_like 'api v3 path', "/#{name.to_s.pluralize}/42/form"
    end
  end

  shared_examples_for 'schema' do |name|
    describe "##{name}_schema" do
      subject { helper.send(:"#{name}_schema") }

      it_behaves_like 'api v3 path', "/#{name.to_s.pluralize}/schema"
    end
  end

  shared_examples_for 'resource' do |name, except: []|
    it_behaves_like('index', name) unless except.include?(:index)
    it_behaves_like('show', name) unless except.include?(:show)
    it_behaves_like('update form', name) unless except.include?(:update_form)
    it_behaves_like('create form', name) unless except.include?(:create_form)
    it_behaves_like('schema', name) unless except.include?(:schema)
  end

  describe '#root' do
    subject { helper.root }

    it_behaves_like 'api v3 path'
  end

  context 'activities paths' do
    it_behaves_like 'show', :activity
  end

  context 'attachments paths' do
    it_behaves_like 'index', :attachment
    it_behaves_like 'show', :attachment

    describe '#attachment_content' do
      subject { helper.attachment_content 1 }

      it_behaves_like 'api v3 path', '/attachments/1/content'
    end

    describe '#attachments_by_post' do
      subject { helper.attachments_by_post 1 }

      it_behaves_like 'api v3 path', '/posts/1/attachments'
    end

    describe '#attachments_by_work_package' do
      subject { helper.attachments_by_work_package 1 }

      it_behaves_like 'api v3 path', '/work_packages/1/attachments'
    end

    describe '#attachments_by_wiki_page' do
      subject { helper.attachments_by_wiki_page 1 }

      it_behaves_like 'api v3 path', '/wiki_pages/1/attachments'
    end
  end

  context 'category paths' do
    it_behaves_like 'index', :category
    it_behaves_like 'show', :category

    describe '#categories_by_project' do
      subject { helper.categories_by_project 42 }

      it_behaves_like 'api v3 path', '/projects/42/categories'
    end
  end

  context 'configuration paths' do
    describe '#configuration' do
      subject { helper.configuration }

      it_behaves_like 'api v3 path', '/configuration'
    end
  end

  context 'custom action paths' do
    it_behaves_like 'show', :custom_action

    describe '#custom_action_execute' do
      subject { helper.custom_action_execute 42 }

      it_behaves_like 'api v3 path', '/custom_actions/42/execute'
    end

    it_behaves_like 'show', :custom_option
  end

  describe 'memberships paths' do
    it_behaves_like 'resource', :membership

    describe '#memberships_available_projects' do
      subject { helper.memberships_available_projects }

      it_behaves_like 'api v3 path', '/memberships/available_projects'
    end
  end

  describe 'messages paths' do
    it_behaves_like 'index', :message
    it_behaves_like 'show', :message
  end

  describe 'my paths' do
    describe '#my_preferences' do
      subject { helper.my_preferences }

      it_behaves_like 'api v3 path', '/my_preferences'
    end
  end

  describe 'news paths' do
    describe '#newses' do
      subject { helper.newses }

      it_behaves_like 'api v3 path', '/news'
    end

    it_behaves_like 'show', :news
  end

  describe 'markup paths' do
    describe '#render_markup' do
      subject { helper.render_markup(link: 'link-ish') }

      it_behaves_like 'api v3 path', '/render/markdown?context=link-ish'

      context 'no link given' do
        subject { helper.render_markup }

        it { is_expected.to eql('/api/v3/render/markdown') }
      end
    end
  end

  describe 'placeholder_users path' do
    it_behaves_like 'index', :placeholder_user
    it_behaves_like 'show', :placeholder_user
  end

  describe 'posts paths' do
    it_behaves_like 'index', :post
    it_behaves_like 'show', :post
  end

  describe 'principals paths' do
    it_behaves_like 'index', :principals
  end

  describe 'priorities paths' do
    it_behaves_like 'index', :priority
    it_behaves_like 'show', :priority
  end

  describe 'projects paths' do
    it_behaves_like 'resource', :project

    describe '#projects_available_parents' do
      subject { helper.projects_available_parents }

      it_behaves_like 'api v3 path', '/projects/available_parent_projects'
    end
  end

  describe 'query paths' do
    it_behaves_like 'resource', :query

    describe '#query_default' do
      subject { helper.query_default }

      it_behaves_like 'api v3 path', '/queries/default'
    end

    describe '#query_project_default' do
      subject { helper.query_project_default(42) }

      it_behaves_like 'api v3 path', '/projects/42/queries/default'
    end

    describe '#query_star' do
      subject { helper.query_star 1 }

      it_behaves_like 'api v3 path', '/queries/1/star'
    end

    describe '#query_unstar' do
      subject { helper.query_unstar 1 }

      it_behaves_like 'api v3 path', '/queries/1/unstar'
    end

    describe '#query_column' do
      subject { helper.query_column 'updated_at' }

      it_behaves_like 'api v3 path', '/queries/columns/updated_at'
    end

    describe '#query_group_by' do
      subject { helper.query_group_by 'status' }

      it_behaves_like 'api v3 path', '/queries/group_bys/status'
    end

    describe '#query_sort_by' do
      subject { helper.query_sort_by 'status', 'desc' }

      it_behaves_like 'api v3 path', '/queries/sort_bys/status-desc'
    end

    describe '#query_filter' do
      subject { helper.query_filter 'status' }

      it_behaves_like 'api v3 path', '/queries/filters/status'
    end

    describe '#query_filter_instance_schemas' do
      subject { helper.query_filter_instance_schemas }

      it_behaves_like 'api v3 path', '/queries/filter_instance_schemas'
    end

    describe '#query_filter_instance_schema' do
      subject { helper.query_filter_instance_schema('bogus') }

      it_behaves_like 'api v3 path', '/queries/filter_instance_schemas/bogus'
    end

    describe '#query_project_form' do
      subject { helper.query_project_form(42) }

      it_behaves_like 'api v3 path', '/projects/42/queries/form'
    end

    describe '#query_project_filter_instance_schemas' do
      subject { helper.query_project_filter_instance_schemas(42) }

      it_behaves_like 'api v3 path', '/projects/42/queries/filter_instance_schemas'
    end

    describe '#query_operator' do
      subject { helper.query_operator '=' }

      it_behaves_like 'api v3 path', '/queries/operators/='
    end

    describe '#query_project_schema' do
      subject { helper.query_project_schema('42') }

      it_behaves_like 'api v3 path', '/projects/42/queries/schema'
    end

    describe '#query_available_projects' do
      subject { helper.query_available_projects }

      it_behaves_like 'api v3 path', '/queries/available_projects'
    end
  end

  describe 'relations paths' do
    it_behaves_like 'index', :relation
    it_behaves_like 'show', :relation
  end

  describe 'revisions paths' do
    it_behaves_like 'show', :revision

    describe '#show_revision' do
      subject { helper.show_revision 'foo', 1234 }

      it_behaves_like 'path', '/projects/foo/repository/revision/1234'
    end
  end

  describe 'roles paths' do
    it_behaves_like 'index', :role
    it_behaves_like 'show', :role
  end

  describe 'statuses paths' do
    it_behaves_like 'index', :status
    it_behaves_like 'show', :status
  end

  describe 'grids paths' do
    it_behaves_like 'resource', :grid
  end

  describe 'string object paths' do
    describe '#string_object' do
      subject { helper.string_object 'foo' }

      it_behaves_like 'api v3 path', '/string_objects?value=foo'

      it 'escapes correctly' do
        value = 'foo/bar baz'
        expect(helper.string_object(value)).to eql('/api/v3/string_objects?value=foo%2Fbar%20baz')
      end
    end
  end

  context 'status paths' do
    it_behaves_like 'show', :status
  end

  context 'time_entry paths' do
    it_behaves_like 'resource', :time_entry

    describe '#time_entries_activity' do
      subject { helper.time_entries_activity 42 }

      it_behaves_like 'api v3 path', '/time_entries/activities/42'
    end

    describe '#time_entries_available_projects' do
      subject { helper.time_entries_available_projects }

      it_behaves_like 'api v3 path', '/time_entries/available_projects'
    end
  end

  describe 'types paths' do
    it_behaves_like 'index', :type
    it_behaves_like 'show', :type

    describe '#types_by_project' do
      subject { helper.types_by_project 12 }

      it_behaves_like 'api v3 path', '/projects/12/types'
    end
  end

  describe 'users paths' do
    it_behaves_like 'index', :user
    it_behaves_like 'show', :user
  end

  describe 'group paths' do
    describe '#group' do
      subject { helper.group 1 }

      it_behaves_like 'api v3 path', '/groups/1'
    end
  end

  describe 'version paths' do
    it_behaves_like 'resource', :version

    describe '#versions_available_projects' do
      subject { helper.versions_available_projects }

      it_behaves_like 'api v3 path', '/versions/available_projects'
    end

    describe '#versions_by_project' do
      subject { helper.versions_by_project 42 }

      it_behaves_like 'api v3 path', '/projects/42/versions'
    end

    describe '#projects_by_version' do
      subject { helper.projects_by_version 42 }

      it_behaves_like 'api v3 path', '/versions/42/projects'
    end
  end

  describe 'wiki pages paths' do
    it_behaves_like 'show', :wiki_page
  end

  describe 'work packages paths' do
    it_behaves_like 'resource', :work_package, except: [:schema]

    describe '#work_package_activities' do
      subject { helper.work_package_activities 42 }

      it_behaves_like 'api v3 path', '/work_packages/42/activities'
    end

    describe '#work_package_relations' do
      subject { helper.work_package_relations 42 }

      it_behaves_like 'api v3 path', '/work_packages/42/relations'
    end

    describe '#work_package_relation' do
      subject { helper.work_package_relation 1, 42 }

      it_behaves_like 'api v3 path', '/work_packages/42/relations/1'
    end

    describe '#work_package_revisions' do
      subject { helper.work_package_revisions 42 }

      it_behaves_like 'api v3 path', '/work_packages/42/revisions'
    end

    describe '#work_package_watchers' do
      subject { helper.work_package_watchers 1 }

      it_behaves_like 'api v3 path', '/work_packages/1/watchers'
    end

    describe '#work_packages_by_project' do
      subject { helper.work_packages_by_project 42 }

      it_behaves_like 'api v3 path', '/projects/42/work_packages'
    end

    describe '#create_project_work_package_form' do
      subject { helper.create_project_work_package_form 42 }

      it_behaves_like 'api v3 path', '/projects/42/work_packages/form'
    end

    describe '#watcher' do
      subject { helper.watcher 1, 42 }

      it_behaves_like 'api v3 path', '/work_packages/42/watchers/1'
    end

    describe 'available ... paths' do
      describe '#available_assignees' do
        subject { helper.available_assignees 42 }

        it_behaves_like 'api v3 path', '/projects/42/available_assignees'
      end

      describe '#available_responsibles' do
        subject { helper.available_responsibles 42 }

        it_behaves_like 'api v3 path', '/projects/42/available_responsibles'
      end

      describe '#available_watchers' do
        subject { helper.available_watchers 42 }

        it_behaves_like 'api v3 path', '/work_packages/42/available_watchers'
      end

      describe '#available_projects_on_edit' do
        subject { helper.available_projects_on_edit 42 }

        it_behaves_like 'api v3 path', '/work_packages/42/available_projects'
      end

      describe '#available_projects_on_create' do
        subject { helper.available_projects_on_create(nil) }

        it_behaves_like 'api v3 path', '/work_packages/available_projects'
      end

      describe '#available_projects_on_create with type' do
        subject { helper.available_projects_on_create(1) }

        it_behaves_like 'api v3 path', '/work_packages/available_projects?for_type=1'
      end
    end

    describe 'schemas paths' do
      describe '#work_package_schema' do
        subject { helper.work_package_schema 1, 2 }

        it_behaves_like 'api v3 path', '/work_packages/schemas/1-2'
      end

      describe '#work_package_schemas' do
        subject { helper.work_package_schemas }

        it_behaves_like 'api v3 path', '/work_packages/schemas'
      end

      describe '#work_package_schemas with filters' do
        subject { helper.work_package_schemas [1, 2], [3, 4] }

        def self.filter
          CGI.escape([{ id: { operator: '=', values: ['1-2', '3-4'] } }].to_s)
        end

        it_behaves_like 'api v3 path',
                        "/work_packages/schemas?filters=#{filter}"
      end

      describe '#work_package_sums_schema' do
        subject { helper.work_package_sums_schema }

        it_behaves_like 'api v3 path', '/work_packages/schemas/sums'
      end
    end
  end
end