asciidoctor-include-ext 0.3.1 → 0.4.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE +1 -1
- data/README.adoc +4 -1
- data/asciidoctor-include-ext.gemspec +11 -13
- data/lib/asciidoctor/include_ext/include_processor.rb +22 -11
- data/lib/asciidoctor/include_ext/version.rb +1 -1
- metadata +8 -22
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: e351222783e131005427ad519891508168603495508299c6d71c2fb55d71a19e
|
4
|
+
data.tar.gz: 209424da5377db4f71f273f32413f69d083faec1ee9da79cf127d7ed55a57c62
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: b93df9f785ad62e1b36a8a68207f06f57578f6ee54af248596c17aa0be38c58e15175ca1cbc02bbe1a73338306959d9a99b06181948fb5743461510cfa02fb4f
|
7
|
+
data.tar.gz: 6ec6deec461722db7a314fb21726af6d08572690e1785865d83a0b3668df43781e9015b87966556b9b2982f434d7eda597eaedd7dcbe56af241e09e1017b8a4b
|
data/LICENSE
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
The MIT License
|
2
2
|
|
3
|
-
Copyright 2017 Jakub Jirutka <jakub@jirutka.cz>.
|
3
|
+
Copyright 2017-present Jakub Jirutka <jakub@jirutka.cz>.
|
4
4
|
|
5
5
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
6
6
|
of this software and associated documentation files (the "Software"), to deal
|
data/README.adoc
CHANGED
@@ -7,7 +7,7 @@
|
|
7
7
|
:codacy-id: 45320444129044688ef6553821b083f1
|
8
8
|
|
9
9
|
ifdef::env-github[]
|
10
|
-
image:https://
|
10
|
+
image:https://github.com/{gh-name}/workflows/CI/badge.svg[CI Status, link=https://github.com/{gh-name}/actions?query=workflow%3A%22CI%22]
|
11
11
|
image:https://api.codacy.com/project/badge/Coverage/{codacy-id}["Test Coverage", link="https://www.codacy.com/app/{gh-name}"]
|
12
12
|
image:https://api.codacy.com/project/badge/Grade/{codacy-id}["Codacy Code quality", link="https://www.codacy.com/app/{gh-name}"]
|
13
13
|
image:https://img.shields.io/gem/v/{gem-name}.svg?style=flat[Gem Version, link="https://rubygems.org/gems/{gem-name}"]
|
@@ -49,6 +49,9 @@ or to install the latest development version:
|
|
49
49
|
gem install {gem-name} --pre
|
50
50
|
|
51
51
|
|
52
|
+
WARNING: Versions *prior 0.4.0* are vulnerable for Command Injection (see https://github.com/{gh-name}/commit/c7ea001a597c7033575342c51483dab7b87ae155[c7ea001] for more information). If you use an older version, update to 0.4.0 immediately!
|
53
|
+
|
54
|
+
|
52
55
|
== Usage
|
53
56
|
|
54
57
|
Just `require '{gem-name}'`.
|
@@ -1,4 +1,4 @@
|
|
1
|
-
require File.expand_path('
|
1
|
+
require File.expand_path('lib/asciidoctor/include_ext/version', __dir__)
|
2
2
|
|
3
3
|
Gem::Specification.new do |s|
|
4
4
|
s.name = 'asciidoctor-include-ext'
|
@@ -9,24 +9,22 @@ Gem::Specification.new do |s|
|
|
9
9
|
s.license = 'MIT'
|
10
10
|
|
11
11
|
s.summary = "Asciidoctor's standard include::[] processor reimplemented as an extension"
|
12
|
-
s.description =
|
13
|
-
This is a reimplementation of the Asciidoctor's built-in (pre)processor for the
|
14
|
-
include::[] directive in extensible and more clean way. It provides the same
|
15
|
-
features, but you can easily adjust it or extend for your needs. For example,
|
16
|
-
you can change how it loads included files or add another ways how to select
|
17
|
-
portions of the document to include.
|
18
|
-
EOF
|
12
|
+
s.description = <<~EOF
|
13
|
+
This is a reimplementation of the Asciidoctor's built-in (pre)processor for the
|
14
|
+
include::[] directive in extensible and more clean way. It provides the same
|
15
|
+
features, but you can easily adjust it or extend for your needs. For example,
|
16
|
+
you can change how it loads included files or add another ways how to select
|
17
|
+
portions of the document to include.
|
18
|
+
EOF
|
19
19
|
|
20
20
|
s.files = Dir['lib/**/*', '*.gemspec', 'LICENSE*', 'README*']
|
21
|
-
s.has_rdoc = 'yard'
|
22
21
|
|
23
|
-
s.required_ruby_version = '>= 2.
|
22
|
+
s.required_ruby_version = '>= 2.3'
|
24
23
|
|
25
24
|
s.add_runtime_dependency 'asciidoctor', '>= 1.5.6', '< 3.0.0'
|
26
25
|
|
27
|
-
s.add_development_dependency '
|
28
|
-
s.add_development_dependency '
|
29
|
-
s.add_development_dependency 'rake', '~> 12.0'
|
26
|
+
s.add_development_dependency 'kramdown', '~> 2.0'
|
27
|
+
s.add_development_dependency 'rake', '~> 13.0'
|
30
28
|
s.add_development_dependency 'rspec', '~> 3.7'
|
31
29
|
s.add_development_dependency 'rubocop', '~> 0.51.0'
|
32
30
|
s.add_development_dependency 'simplecov', '~> 0.15'
|
@@ -1,6 +1,7 @@
|
|
1
1
|
# frozen_string_literal: true
|
2
2
|
require 'logger'
|
3
3
|
require 'open-uri'
|
4
|
+
require 'uri'
|
4
5
|
|
5
6
|
require 'asciidoctor/include_ext/version'
|
6
7
|
require 'asciidoctor/include_ext/reader_ext'
|
@@ -86,7 +87,7 @@ module Asciidoctor::IncludeExt
|
|
86
87
|
|
87
88
|
return false if doc.safe >= ::Asciidoctor::SafeMode::SECURE
|
88
89
|
return false if doc.attributes.fetch('max-include-depth', 64).to_i < 1
|
89
|
-
return false if
|
90
|
+
return false if target_http?(target) && !doc.attributes.key?('allow-uri-read')
|
90
91
|
true
|
91
92
|
end
|
92
93
|
|
@@ -94,7 +95,7 @@ module Asciidoctor::IncludeExt
|
|
94
95
|
# @param reader (see #process)
|
95
96
|
# @return [String, nil] file path or URI of the *target*, or `nil` if not found.
|
96
97
|
def resolve_target_path(target, reader)
|
97
|
-
return target if
|
98
|
+
return target if target_http? target
|
98
99
|
|
99
100
|
# Include file is resolved relative to dir of the current include,
|
100
101
|
# or base_dir if within original docfile.
|
@@ -106,16 +107,22 @@ module Asciidoctor::IncludeExt
|
|
106
107
|
# Reads the specified file as individual lines, filters them using the
|
107
108
|
# *selector* (if provided) and returns those lines in an array.
|
108
109
|
#
|
109
|
-
# @param
|
110
|
+
# @param path [String] URL or path of the file to be read.
|
110
111
|
# @param selector [#to_proc, nil] predicate to filter lines that should be
|
111
112
|
# included in the output. It must accept two arguments: line and
|
112
113
|
# the line number. If `nil` is given, all lines are passed.
|
113
114
|
# @return [Array<String>] an array of read lines.
|
114
|
-
def read_lines(
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
115
|
+
def read_lines(path, selector)
|
116
|
+
# IO.open is deliberately not used directly to avoid potential security risks.
|
117
|
+
# TODO: Get rid of 'open-uri' (URI.open).
|
118
|
+
io = target_http?(path) ? URI : File
|
119
|
+
|
120
|
+
io.open(path) do |f|
|
121
|
+
if selector
|
122
|
+
f.each.select.with_index(1, &selector)
|
123
|
+
else
|
124
|
+
f.read
|
125
|
+
end
|
119
126
|
end
|
120
127
|
end
|
121
128
|
|
@@ -142,9 +149,13 @@ module Asciidoctor::IncludeExt
|
|
142
149
|
private
|
143
150
|
|
144
151
|
# @param target (see #process)
|
145
|
-
# @return [Boolean] `true` if the *target* is
|
146
|
-
def
|
147
|
-
|
152
|
+
# @return [Boolean] `true` if the *target* is a valid HTTP(S) URI, `false` otherwise.
|
153
|
+
def target_http?(target)
|
154
|
+
# First do a fast test, then try to parse it.
|
155
|
+
target.downcase.start_with?('http://', 'https://') \
|
156
|
+
&& URI.parse(target).is_a?(URI::HTTP)
|
157
|
+
rescue URI::InvalidURIError
|
158
|
+
false
|
148
159
|
end
|
149
160
|
end
|
150
161
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: asciidoctor-include-ext
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.4.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Jakub Jirutka
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2022-03-29 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: asciidoctor
|
@@ -30,48 +30,34 @@ dependencies:
|
|
30
30
|
- - "<"
|
31
31
|
- !ruby/object:Gem::Version
|
32
32
|
version: 3.0.0
|
33
|
-
- !ruby/object:Gem::Dependency
|
34
|
-
name: corefines
|
35
|
-
requirement: !ruby/object:Gem::Requirement
|
36
|
-
requirements:
|
37
|
-
- - "~>"
|
38
|
-
- !ruby/object:Gem::Version
|
39
|
-
version: '1.11'
|
40
|
-
type: :development
|
41
|
-
prerelease: false
|
42
|
-
version_requirements: !ruby/object:Gem::Requirement
|
43
|
-
requirements:
|
44
|
-
- - "~>"
|
45
|
-
- !ruby/object:Gem::Version
|
46
|
-
version: '1.11'
|
47
33
|
- !ruby/object:Gem::Dependency
|
48
34
|
name: kramdown
|
49
35
|
requirement: !ruby/object:Gem::Requirement
|
50
36
|
requirements:
|
51
37
|
- - "~>"
|
52
38
|
- !ruby/object:Gem::Version
|
53
|
-
version: '
|
39
|
+
version: '2.0'
|
54
40
|
type: :development
|
55
41
|
prerelease: false
|
56
42
|
version_requirements: !ruby/object:Gem::Requirement
|
57
43
|
requirements:
|
58
44
|
- - "~>"
|
59
45
|
- !ruby/object:Gem::Version
|
60
|
-
version: '
|
46
|
+
version: '2.0'
|
61
47
|
- !ruby/object:Gem::Dependency
|
62
48
|
name: rake
|
63
49
|
requirement: !ruby/object:Gem::Requirement
|
64
50
|
requirements:
|
65
51
|
- - "~>"
|
66
52
|
- !ruby/object:Gem::Version
|
67
|
-
version: '
|
53
|
+
version: '13.0'
|
68
54
|
type: :development
|
69
55
|
prerelease: false
|
70
56
|
version_requirements: !ruby/object:Gem::Requirement
|
71
57
|
requirements:
|
72
58
|
- - "~>"
|
73
59
|
- !ruby/object:Gem::Version
|
74
|
-
version: '
|
60
|
+
version: '13.0'
|
75
61
|
- !ruby/object:Gem::Dependency
|
76
62
|
name: rspec
|
77
63
|
requirement: !ruby/object:Gem::Requirement
|
@@ -162,14 +148,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
162
148
|
requirements:
|
163
149
|
- - ">="
|
164
150
|
- !ruby/object:Gem::Version
|
165
|
-
version: '2.
|
151
|
+
version: '2.3'
|
166
152
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
167
153
|
requirements:
|
168
154
|
- - ">="
|
169
155
|
- !ruby/object:Gem::Version
|
170
156
|
version: '0'
|
171
157
|
requirements: []
|
172
|
-
rubygems_version: 3.
|
158
|
+
rubygems_version: 3.3.7
|
173
159
|
signing_key:
|
174
160
|
specification_version: 4
|
175
161
|
summary: Asciidoctor's standard include::[] processor reimplemented as an extension
|