rubyzip 1.3.0 → 2.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (115) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +2 -8
  3. data/Rakefile +3 -0
  4. data/lib/zip.rb +4 -3
  5. data/lib/zip/central_directory.rb +9 -5
  6. data/lib/zip/constants.rb +52 -0
  7. data/lib/zip/crypto/decrypted_io.rb +40 -0
  8. data/lib/zip/crypto/traditional_encryption.rb +9 -9
  9. data/lib/zip/decompressor.rb +19 -1
  10. data/lib/zip/dos_time.rb +12 -7
  11. data/lib/zip/entry.rb +57 -38
  12. data/lib/zip/entry_set.rb +2 -0
  13. data/lib/zip/errors.rb +1 -0
  14. data/lib/zip/extra_field.rb +11 -9
  15. data/lib/zip/extra_field/generic.rb +10 -9
  16. data/lib/zip/extra_field/ntfs.rb +4 -0
  17. data/lib/zip/extra_field/old_unix.rb +3 -1
  18. data/lib/zip/extra_field/universal_time.rb +42 -12
  19. data/lib/zip/extra_field/unix.rb +3 -1
  20. data/lib/zip/extra_field/zip64.rb +4 -2
  21. data/lib/zip/file.rb +79 -54
  22. data/lib/zip/filesystem.rb +193 -177
  23. data/lib/zip/inflater.rb +24 -36
  24. data/lib/zip/input_stream.rb +33 -26
  25. data/lib/zip/ioextras.rb +1 -1
  26. data/lib/zip/ioextras/abstract_input_stream.rb +19 -8
  27. data/lib/zip/ioextras/abstract_output_stream.rb +1 -1
  28. data/lib/zip/null_decompressor.rb +1 -9
  29. data/lib/zip/output_stream.rb +14 -5
  30. data/lib/zip/pass_thru_compressor.rb +2 -2
  31. data/lib/zip/pass_thru_decompressor.rb +13 -22
  32. data/lib/zip/streamable_directory.rb +3 -3
  33. data/lib/zip/streamable_stream.rb +6 -10
  34. data/lib/zip/version.rb +1 -1
  35. data/samples/example.rb +2 -2
  36. data/samples/example_filesystem.rb +1 -1
  37. data/samples/gtk_ruby_zip.rb +19 -19
  38. data/samples/qtzip.rb +6 -6
  39. data/samples/write_simple.rb +2 -4
  40. data/samples/zipfind.rb +23 -22
  41. metadata +28 -169
  42. data/test/basic_zip_file_test.rb +0 -60
  43. data/test/case_sensitivity_test.rb +0 -69
  44. data/test/central_directory_entry_test.rb +0 -69
  45. data/test/central_directory_test.rb +0 -100
  46. data/test/crypto/null_encryption_test.rb +0 -57
  47. data/test/crypto/traditional_encryption_test.rb +0 -80
  48. data/test/data/WarnInvalidDate.zip +0 -0
  49. data/test/data/file1.txt +0 -46
  50. data/test/data/file1.txt.deflatedData +0 -0
  51. data/test/data/file2.txt +0 -1504
  52. data/test/data/globTest.zip +0 -0
  53. data/test/data/globTest/foo.txt +0 -0
  54. data/test/data/globTest/foo/bar/baz/foo.txt +0 -0
  55. data/test/data/globTest/food.txt +0 -0
  56. data/test/data/gpbit3stored.zip +0 -0
  57. data/test/data/mimetype +0 -1
  58. data/test/data/notzippedruby.rb +0 -7
  59. data/test/data/ntfs.zip +0 -0
  60. data/test/data/oddExtraField.zip +0 -0
  61. data/test/data/path_traversal/Makefile +0 -10
  62. data/test/data/path_traversal/jwilk/README.md +0 -5
  63. data/test/data/path_traversal/jwilk/absolute1.zip +0 -0
  64. data/test/data/path_traversal/jwilk/absolute2.zip +0 -0
  65. data/test/data/path_traversal/jwilk/dirsymlink.zip +0 -0
  66. data/test/data/path_traversal/jwilk/dirsymlink2a.zip +0 -0
  67. data/test/data/path_traversal/jwilk/dirsymlink2b.zip +0 -0
  68. data/test/data/path_traversal/jwilk/relative0.zip +0 -0
  69. data/test/data/path_traversal/jwilk/relative2.zip +0 -0
  70. data/test/data/path_traversal/jwilk/symlink.zip +0 -0
  71. data/test/data/path_traversal/relative1.zip +0 -0
  72. data/test/data/path_traversal/tilde.zip +0 -0
  73. data/test/data/path_traversal/tuzovakaoff/README.md +0 -3
  74. data/test/data/path_traversal/tuzovakaoff/absolutepath.zip +0 -0
  75. data/test/data/path_traversal/tuzovakaoff/symlink.zip +0 -0
  76. data/test/data/rubycode.zip +0 -0
  77. data/test/data/rubycode2.zip +0 -0
  78. data/test/data/test.xls +0 -0
  79. data/test/data/testDirectory.bin +0 -0
  80. data/test/data/zip64-sample.zip +0 -0
  81. data/test/data/zipWithDirs.zip +0 -0
  82. data/test/data/zipWithEncryption.zip +0 -0
  83. data/test/deflater_test.rb +0 -65
  84. data/test/encryption_test.rb +0 -42
  85. data/test/entry_set_test.rb +0 -163
  86. data/test/entry_test.rb +0 -154
  87. data/test/errors_test.rb +0 -35
  88. data/test/extra_field_test.rb +0 -76
  89. data/test/file_extract_directory_test.rb +0 -54
  90. data/test/file_extract_test.rb +0 -145
  91. data/test/file_permissions_test.rb +0 -65
  92. data/test/file_split_test.rb +0 -57
  93. data/test/file_test.rb +0 -666
  94. data/test/filesystem/dir_iterator_test.rb +0 -58
  95. data/test/filesystem/directory_test.rb +0 -139
  96. data/test/filesystem/file_mutating_test.rb +0 -87
  97. data/test/filesystem/file_nonmutating_test.rb +0 -508
  98. data/test/filesystem/file_stat_test.rb +0 -64
  99. data/test/gentestfiles.rb +0 -126
  100. data/test/inflater_test.rb +0 -14
  101. data/test/input_stream_test.rb +0 -182
  102. data/test/ioextras/abstract_input_stream_test.rb +0 -102
  103. data/test/ioextras/abstract_output_stream_test.rb +0 -106
  104. data/test/ioextras/fake_io_test.rb +0 -18
  105. data/test/local_entry_test.rb +0 -154
  106. data/test/output_stream_test.rb +0 -128
  107. data/test/pass_thru_compressor_test.rb +0 -30
  108. data/test/pass_thru_decompressor_test.rb +0 -14
  109. data/test/path_traversal_test.rb +0 -141
  110. data/test/samples/example_recursive_test.rb +0 -37
  111. data/test/settings_test.rb +0 -95
  112. data/test/test_helper.rb +0 -234
  113. data/test/unicode_file_names_and_comments_test.rb +0 -62
  114. data/test/zip64_full_test.rb +0 -51
  115. data/test/zip64_support_test.rb +0 -14
@@ -1,141 +0,0 @@
1
- class PathTraversalTest < MiniTest::Test
2
- TEST_FILE_ROOT = File.absolute_path('test/data/path_traversal')
3
-
4
- def setup
5
- # With apologies to anyone using these files... but they are the files in
6
- # the sample zips, so we don't have much choice here.
7
- FileUtils.rm_f '/tmp/moo'
8
- FileUtils.rm_f '/tmp/file.txt'
9
- end
10
-
11
- def extract_path_traversal_zip(name)
12
- Zip::File.open(File.join(TEST_FILE_ROOT, name)) do |zip_file|
13
- zip_file.each do |entry|
14
- entry.extract
15
- end
16
- end
17
- end
18
-
19
- def in_tmpdir
20
- Dir.mktmpdir do |tmp|
21
- test_path = File.join(tmp, 'test')
22
- Dir.mkdir test_path
23
- Dir.chdir test_path do
24
- yield test_path
25
- end
26
- end
27
- end
28
-
29
- def test_leading_slash
30
- in_tmpdir do
31
- extract_path_traversal_zip 'jwilk/absolute1.zip'
32
- refute File.exist?('/tmp/moo')
33
- end
34
- end
35
-
36
- def test_multiple_leading_slashes
37
- in_tmpdir do
38
- extract_path_traversal_zip 'jwilk/absolute2.zip'
39
- refute File.exist?('/tmp/moo')
40
- end
41
- end
42
-
43
- def test_leading_dot_dot
44
- in_tmpdir do
45
- extract_path_traversal_zip 'jwilk/relative0.zip'
46
- refute File.exist?('../moo')
47
- end
48
- end
49
-
50
- def test_non_leading_dot_dot_with_existing_folder
51
- in_tmpdir do
52
- extract_path_traversal_zip 'relative1.zip'
53
- assert Dir.exist?('tmp')
54
- refute File.exist?('../moo')
55
- end
56
- end
57
-
58
- def test_non_leading_dot_dot_without_existing_folder
59
- in_tmpdir do
60
- extract_path_traversal_zip 'jwilk/relative2.zip'
61
- refute File.exist?('../moo')
62
- end
63
- end
64
-
65
- def test_file_symlink
66
- in_tmpdir do
67
- extract_path_traversal_zip 'jwilk/symlink.zip'
68
- assert File.exist?('moo')
69
- refute File.exist?('/tmp/moo')
70
- end
71
- end
72
-
73
- def test_directory_symlink
74
- in_tmpdir do
75
- # Can't create tmp/moo, because the tmp symlink is skipped.
76
- assert_raises Errno::ENOENT do
77
- extract_path_traversal_zip 'jwilk/dirsymlink.zip'
78
- end
79
- refute File.exist?('/tmp/moo')
80
- end
81
- end
82
-
83
- def test_two_directory_symlinks_a
84
- in_tmpdir do
85
- # Can't create par/moo because the symlinks are skipped.
86
- assert_raises Errno::ENOENT do
87
- extract_path_traversal_zip 'jwilk/dirsymlink2a.zip'
88
- end
89
- refute File.exist?('cur')
90
- refute File.exist?('par')
91
- refute File.exist?('par/moo')
92
- end
93
- end
94
-
95
- def test_two_directory_symlinks_b
96
- in_tmpdir do
97
- # Can't create par/moo, because the symlinks are skipped.
98
- assert_raises Errno::ENOENT do
99
- extract_path_traversal_zip 'jwilk/dirsymlink2b.zip'
100
- end
101
- refute File.exist?('cur')
102
- refute File.exist?('../moo')
103
- end
104
- end
105
-
106
- def test_entry_name_with_absolute_path_does_not_extract
107
- in_tmpdir do
108
- extract_path_traversal_zip 'tuzovakaoff/absolutepath.zip'
109
- refute File.exist?('/tmp/file.txt')
110
- end
111
- end
112
-
113
- def test_entry_name_with_absolute_path_extract_when_given_different_path
114
- in_tmpdir do |test_path|
115
- zip_path = File.join(TEST_FILE_ROOT, 'tuzovakaoff/absolutepath.zip')
116
- Zip::File.open(zip_path) do |zip_file|
117
- zip_file.each do |entry|
118
- entry.extract(File.join(test_path, entry.name))
119
- end
120
- end
121
- refute File.exist?('/tmp/file.txt')
122
- end
123
- end
124
-
125
- def test_entry_name_with_relative_symlink
126
- in_tmpdir do
127
- # Doesn't create the symlink path, so can't create path/file.txt.
128
- assert_raises Errno::ENOENT do
129
- extract_path_traversal_zip 'tuzovakaoff/symlink.zip'
130
- end
131
- refute File.exist?('/tmp/file.txt')
132
- end
133
- end
134
-
135
- def test_entry_name_with_tilde
136
- in_tmpdir do
137
- extract_path_traversal_zip 'tilde.zip'
138
- assert File.exist?('~tilde~')
139
- end
140
- end
141
- end
@@ -1,37 +0,0 @@
1
- require 'test_helper'
2
- require 'fileutils'
3
- require_relative '../../samples/example_recursive'
4
-
5
- class ExampleRecursiveTest < MiniTest::Test
6
- DIRECTORY_TO_ZIP = 'test/data/globTest'
7
- OUTPUT_DIRECTORY = 'test/data/example_recursive.zip'
8
- TEMP_DIRECTORY = 'test/data/tmp'
9
-
10
- def setup
11
- @generator = ::ZipFileGenerator.new(DIRECTORY_TO_ZIP, OUTPUT_DIRECTORY)
12
- end
13
-
14
- def teardown
15
- FileUtils.rm_rf TEMP_DIRECTORY
16
- FileUtils.rm_f OUTPUT_DIRECTORY
17
- end
18
-
19
- def test_write
20
- @generator.write
21
- unzip
22
- assert_equal Dir.entries(DIRECTORY_TO_ZIP).sort, Dir.entries(TEMP_DIRECTORY).sort
23
- end
24
-
25
- private
26
-
27
- def unzip(file = OUTPUT_DIRECTORY)
28
- Zip::File.open(file) do |zip_file|
29
- zip_file.each do |f|
30
- file_path = File.join(TEMP_DIRECTORY, f.name)
31
- FileUtils.mkdir_p(File.dirname(file_path))
32
-
33
- zip_file.extract(f, file_path) unless File.exist?(file_path)
34
- end
35
- end
36
- end
37
- end
@@ -1,95 +0,0 @@
1
- require 'test_helper'
2
-
3
- class ZipSettingsTest < MiniTest::Test
4
- # TODO: Refactor out into common test module
5
- include CommonZipFileFixture
6
-
7
- TEST_OUT_NAME = 'test/data/generated/emptyOutDir'
8
-
9
- def setup
10
- super
11
-
12
- Dir.rmdir(TEST_OUT_NAME) if File.directory? TEST_OUT_NAME
13
- File.delete(TEST_OUT_NAME) if File.exist? TEST_OUT_NAME
14
- end
15
-
16
- def teardown
17
- ::Zip.reset!
18
- end
19
-
20
- def open_zip(&aProc)
21
- assert(!aProc.nil?)
22
- ::Zip::File.open(TestZipFile::TEST_ZIP4.zip_name, &aProc)
23
- end
24
-
25
- def extract_test_dir(&aProc)
26
- open_zip do |zf|
27
- zf.extract(TestFiles::EMPTY_TEST_DIR, TEST_OUT_NAME, &aProc)
28
- end
29
- end
30
-
31
- def test_true_on_exists_proc
32
- Zip.on_exists_proc = true
33
- File.open(TEST_OUT_NAME, 'w') { |f| f.puts 'something' }
34
- extract_test_dir
35
- assert(File.directory?(TEST_OUT_NAME))
36
- end
37
-
38
- def test_false_on_exists_proc
39
- Zip.on_exists_proc = false
40
- File.open(TEST_OUT_NAME, 'w') { |f| f.puts 'something' }
41
- assert_raises(Zip::DestinationFileExistsError) { extract_test_dir }
42
- end
43
-
44
- def test_false_continue_on_exists_proc
45
- Zip.continue_on_exists_proc = false
46
-
47
- assert_raises(::Zip::EntryExistsError) do
48
- ::Zip::File.open(TEST_ZIP.zip_name) do |zf|
49
- zf.add(zf.entries.first.name, 'test/data/file2.txt')
50
- end
51
- end
52
- end
53
-
54
- def test_true_continue_on_exists_proc
55
- Zip.continue_on_exists_proc = true
56
-
57
- replacedEntry = nil
58
-
59
- ::Zip::File.open(TEST_ZIP.zip_name) do |zf|
60
- replacedEntry = zf.entries.first.name
61
- zf.add(replacedEntry, 'test/data/file2.txt')
62
- end
63
-
64
- ::Zip::File.open(TEST_ZIP.zip_name) do |zf|
65
- assert_contains(zf, replacedEntry, 'test/data/file2.txt')
66
- end
67
- end
68
-
69
- def test_false_warn_invalid_date
70
- test_file = File.join(File.dirname(__FILE__), 'data', 'WarnInvalidDate.zip')
71
- Zip.warn_invalid_date = false
72
-
73
- assert_output('', '') do
74
- ::Zip::File.open(test_file) do |_zf|
75
- end
76
- end
77
- end
78
-
79
- def test_true_warn_invalid_date
80
- test_file = File.join(File.dirname(__FILE__), 'data', 'WarnInvalidDate.zip')
81
- Zip.warn_invalid_date = true
82
-
83
- assert_output('', /Invalid date\/time in zip entry/) do
84
- ::Zip::File.open(test_file) do |_zf|
85
- end
86
- end
87
- end
88
-
89
- private
90
-
91
- def assert_contains(zf, entryName, filename = entryName)
92
- assert(zf.entries.detect { |e| e.name == entryName } != nil, "entry #{entryName} not in #{zf.entries.join(', ')} in zip file #{zf}")
93
- assert_entry_contents(zf, entryName, filename) if File.exist?(filename)
94
- end
95
- end
data/test/test_helper.rb DELETED
@@ -1,234 +0,0 @@
1
- require 'simplecov'
2
- require 'minitest/autorun'
3
- require 'minitest/unit'
4
- require 'fileutils'
5
- require 'digest/sha1'
6
- require 'zip'
7
- require 'gentestfiles'
8
-
9
- TestFiles.create_test_files
10
- TestZipFile.create_test_zips
11
-
12
- if defined? JRUBY_VERSION
13
- require 'jruby'
14
- JRuby.objectspace = true
15
- end
16
-
17
- ::MiniTest.after_run do
18
- FileUtils.rm_rf('test/data/generated')
19
- end
20
-
21
- module IOizeString
22
- attr_reader :tell
23
-
24
- def read(count = nil)
25
- @tell ||= 0
26
- count = size unless count
27
- retVal = slice(@tell, count)
28
- @tell += count
29
- retVal
30
- end
31
-
32
- def seek(index, offset)
33
- @tell ||= 0
34
- case offset
35
- when IO::SEEK_END
36
- newPos = size + index
37
- when IO::SEEK_SET
38
- newPos = index
39
- when IO::SEEK_CUR
40
- newPos = @tell + index
41
- else
42
- raise 'Error in test method IOizeString::seek'
43
- end
44
- if newPos < 0 || newPos >= size
45
- raise Errno::EINVAL
46
- else
47
- @tell = newPos
48
- end
49
- end
50
-
51
- def reset
52
- @tell = 0
53
- end
54
- end
55
-
56
- module DecompressorTests
57
- # expects @refText, @refLines and @decompressor
58
-
59
- TEST_FILE = 'test/data/file1.txt'
60
-
61
- def setup
62
- @refText = ''
63
- File.open(TEST_FILE) { |f| @refText = f.read }
64
- @refLines = @refText.split($/)
65
- end
66
-
67
- def test_read_everything
68
- assert_equal(@refText, @decompressor.sysread)
69
- end
70
-
71
- def test_read_in_chunks
72
- chunkSize = 5
73
- while (decompressedChunk = @decompressor.sysread(chunkSize))
74
- assert_equal(@refText.slice!(0, chunkSize), decompressedChunk)
75
- end
76
- assert_equal(0, @refText.size)
77
- end
78
-
79
- def test_mixing_reads_and_produce_input
80
- # Just some preconditions to make sure we have enough data for this test
81
- assert(@refText.length > 1000)
82
- assert(@refLines.length > 40)
83
-
84
- assert_equal(@refText[0...100], @decompressor.sysread(100))
85
-
86
- assert(!@decompressor.input_finished?)
87
- buf = @decompressor.produce_input
88
- assert_equal(@refText[100...(100 + buf.length)], buf)
89
- end
90
- end
91
-
92
- module AssertEntry
93
- def assert_next_entry(filename, zis)
94
- assert_entry(filename, zis, zis.get_next_entry.name)
95
- end
96
-
97
- def assert_entry(filename, zis, entryName)
98
- assert_equal(filename, entryName)
99
- assert_entry_contents_for_stream(filename, zis, entryName)
100
- end
101
-
102
- def assert_entry_contents_for_stream(filename, zis, entryName)
103
- File.open(filename, 'rb') do |file|
104
- expected = file.read
105
- actual = zis.read
106
- if expected != actual
107
- if (expected && actual) && (expected.length > 400 || actual.length > 400)
108
- zipEntryFilename = entryName + '.zipEntry'
109
- File.open(zipEntryFilename, 'wb') { |entryfile| entryfile << actual }
110
- fail("File '#{filename}' is different from '#{zipEntryFilename}'")
111
- else
112
- assert_equal(expected, actual)
113
- end
114
- end
115
- end
116
- end
117
-
118
- def self.assert_contents(filename, aString)
119
- fileContents = ''
120
- File.open(filename, 'rb') { |f| fileContents = f.read }
121
- if fileContents != aString
122
- if fileContents.length > 400 || aString.length > 400
123
- stringFile = filename + '.other'
124
- File.open(stringFile, 'wb') { |f| f << aString }
125
- fail("File '#{filename}' is different from contents of string stored in '#{stringFile}'")
126
- else
127
- assert_equal(fileContents, aString)
128
- end
129
- end
130
- end
131
-
132
- def assert_stream_contents(zis, testZipFile)
133
- assert(!zis.nil?)
134
- testZipFile.entry_names.each do |entryName|
135
- assert_next_entry(entryName, zis)
136
- end
137
- assert_nil(zis.get_next_entry)
138
- end
139
-
140
- def assert_test_zip_contents(testZipFile)
141
- ::Zip::InputStream.open(testZipFile.zip_name) do |zis|
142
- assert_stream_contents(zis, testZipFile)
143
- end
144
- end
145
-
146
- def assert_entry_contents(zipFile, entryName, filename = entryName.to_s)
147
- zis = zipFile.get_input_stream(entryName)
148
- assert_entry_contents_for_stream(filename, zis, entryName)
149
- ensure
150
- zis.close if zis
151
- end
152
- end
153
-
154
- module CrcTest
155
- class TestOutputStream
156
- include ::Zip::IOExtras::AbstractOutputStream
157
-
158
- attr_accessor :buffer
159
-
160
- def initialize
161
- @buffer = ''
162
- end
163
-
164
- def <<(data)
165
- @buffer << data
166
- self
167
- end
168
- end
169
-
170
- def run_crc_test(compressorClass)
171
- str = "Here's a nice little text to compute the crc for! Ho hum, it is nice nice nice nice indeed."
172
- fakeOut = TestOutputStream.new
173
-
174
- deflater = compressorClass.new(fakeOut)
175
- deflater << str
176
- assert_equal(0x919920fc, deflater.crc)
177
- end
178
- end
179
-
180
- module Enumerable
181
- def compare_enumerables(otherEnumerable)
182
- otherAsArray = otherEnumerable.to_a
183
- each_with_index do |element, index|
184
- return false unless yield(element, otherAsArray[index])
185
- end
186
- size == otherAsArray.size
187
- end
188
- end
189
-
190
- module CommonZipFileFixture
191
- include AssertEntry
192
-
193
- EMPTY_FILENAME = 'emptyZipFile.zip'
194
-
195
- TEST_ZIP = TestZipFile::TEST_ZIP2.clone
196
- TEST_ZIP.zip_name = 'test/data/generated/5entry_copy.zip'
197
-
198
- def setup
199
- File.delete(EMPTY_FILENAME) if File.exist?(EMPTY_FILENAME)
200
- FileUtils.cp(TestZipFile::TEST_ZIP2.zip_name, TEST_ZIP.zip_name)
201
- end
202
- end
203
-
204
- module ExtraAssertions
205
- def assert_forwarded(anObject, method, retVal, *expectedArgs)
206
- callArgs = nil
207
- setCallArgsProc = proc { |args| callArgs = args }
208
- anObject.instance_eval <<-"end_eval"
209
- alias #{method}_org #{method}
210
- def #{method}(*args)
211
- ObjectSpace._id2ref(#{setCallArgsProc.object_id}).call(args)
212
- ObjectSpace._id2ref(#{retVal.object_id})
213
- end
214
- end_eval
215
-
216
- assert_equal(retVal, yield) # Invoke test
217
- assert_equal(expectedArgs, callArgs)
218
- ensure
219
- anObject.instance_eval "undef #{method}; alias #{method} #{method}_org"
220
- end
221
- end
222
-
223
- module ZipEntryData
224
- TEST_ZIPFILE = 'someZipFile.zip'
225
- TEST_COMMENT = 'a comment'
226
- TEST_COMPRESSED_SIZE = 1234
227
- TEST_CRC = 325_324
228
- TEST_EXTRA = 'Some data here'
229
- TEST_COMPRESSIONMETHOD = ::Zip::Entry::DEFLATED
230
- TEST_NAME = 'entry name'
231
- TEST_SIZE = 8432
232
- TEST_ISDIRECTORY = false
233
- TEST_TIME = Time.now
234
- end