summaryrefslogtreecommitdiff
path: root/spec/haml_lint/linter/documentation_links_spec.rb
blob: 68de8317b82c3f528374cf6bed191a95e32d428f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# frozen_string_literal: true

require 'spec_helper'
require 'haml_lint'
require 'haml_lint/spec'
require Rails.root.join('haml_lint/linter/documentation_links')

RSpec.describe HamlLint::Linter::DocumentationLinks do
  include_context 'linter'

  context 'when link_to points to the existing file path' do
    let(:haml) { "= link_to 'Description', help_page_path('README.md')" }

    it { is_expected.not_to report_lint }
  end

  context 'when link_to points to the existing file with valid anchor' do
    let(:haml) { "= link_to 'Description', help_page_path('README.md', anchor: 'overview'), target: '_blank'" }

    it { is_expected.not_to report_lint }
  end

  context 'when link_to points to the existing file path without .md extension' do
    let(:haml) { "= link_to 'Description', help_page_path('README')" }

    it { is_expected.not_to report_lint }
  end

  context 'when anchor is not correct' do
    let(:haml) { "= link_to 'Description', help_page_path('README.md', anchor: 'wrong')" }

    it { is_expected.to report_lint }

    context 'when help_page_path has multiple options' do
      let(:haml) { "= link_to 'Description', help_page_path('README.md', key: :value, anchor: 'wrong')" }

      it { is_expected.to report_lint }
    end
  end

  context 'when file path is wrong' do
    let(:haml) { "= link_to 'Description', help_page_path('wrong.md'), target: '_blank'" }

    it { is_expected.to report_lint }
  end

  context 'when link with wrong file path is assigned to a variable' do
    let(:haml) { "- my_link = link_to 'Description', help_page_path('wrong.md')" }

    it { is_expected.to report_lint }
  end

  context 'when it is a broken code' do
    let(:haml) { "= I am broken! ]]]]" }

    it { is_expected.not_to report_lint }
  end

  context 'when anchor belongs to a different element' do
    let(:haml) { "= link_to 'Description', help_page_path('README.md'), target: (anchor: 'blank')" }

    it { is_expected.not_to report_lint }
  end

  context 'when a simple help_page_path' do
    let(:haml) { "- url = help_page_path('wrong.md')" }

    it { is_expected.to report_lint }
  end

  context 'when link is not a string' do
    let(:haml) { "- url = help_page_path(help_url)" }

    it { is_expected.not_to report_lint }
  end

  context 'when link is a part of the tag' do
    let(:haml) { ".data-form{ data: { url: help_page_path('wrong.md') } }" }

    it { is_expected.to report_lint }
  end
end