memtar 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.gitignore +14 -0
- data/.overcommit.yml +31 -0
- data/Gemfile +4 -0
- data/LICENSE.txt +22 -0
- data/README.md +44 -0
- data/Rakefile +10 -0
- data/lib/memtar.rb +57 -0
- data/lib/memtar/version.rb +4 -0
- data/memtar.gemspec +25 -0
- data/spec/memtar_spec.rb +34 -0
- data/spec/spec_helper.rb +49 -0
- metadata +113 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: d92f29c592d9d2ec4112e69e04f205a893dbc36b
|
4
|
+
data.tar.gz: f61512b2bf45450088ae1f58454319c32811bb4c
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 4b0fbe8d37f910acb0727c2eb86dffd62daad06f52d9c4085af4914e10d0e0749b2eab32c5fa4f90d7b3643d0fa3538acfd256a8a76b5a7e08b34f30d29e14dc
|
7
|
+
data.tar.gz: 2a6fe9b0a17d1e2dbaf9a5bdc708a9f0cb8ad5a7cc3384d78c092d62c8c58a726ec9c3b58736376f828c1ef5b2b65df648b9f208c1eeb0e54dc5521e73edc9b0
|
data/.gitignore
ADDED
data/.overcommit.yml
ADDED
@@ -0,0 +1,31 @@
|
|
1
|
+
# Use this file to configure the Overcommit hooks you wish to use. This will
|
2
|
+
# extend the default configuration defined in:
|
3
|
+
# https://github.com/causes/overcommit/blob/master/config/default.yml
|
4
|
+
#
|
5
|
+
# At the topmost level of this YAML file is a key representing type of hook
|
6
|
+
# being run (e.g. pre-commit, commit-msg, etc.). Within each type you can
|
7
|
+
# customize each hook, such as whether to only run it on certain files (via
|
8
|
+
# `include`), whether to only display output if it fails (via `quiet`), etc.
|
9
|
+
#
|
10
|
+
# For a complete list of hooks, see:
|
11
|
+
# https://github.com/causes/overcommit/tree/master/lib/overcommit/hook
|
12
|
+
#
|
13
|
+
# For a complete list of options that you can use to customize hooks, see:
|
14
|
+
# https://github.com/causes/overcommit#configuration
|
15
|
+
#
|
16
|
+
# Uncomment the following lines to make the configuration take effect.
|
17
|
+
|
18
|
+
#PreCommit:
|
19
|
+
# Rubocop:
|
20
|
+
# on_warn: fail # Treat all warnings as failures
|
21
|
+
#
|
22
|
+
# TrailingWhitespace:
|
23
|
+
# exclude:
|
24
|
+
# - '**/db/structure.sql' # Ignore trailing whitespace in generated files
|
25
|
+
#
|
26
|
+
#PostCheckout:
|
27
|
+
# ALL: # Special hook name that customizes all hooks of this type
|
28
|
+
# quiet: true # Change all post-checkout hooks to only display output on failure
|
29
|
+
#
|
30
|
+
# IndexTags:
|
31
|
+
# enabled: true # Generate a tags file with `ctags` each time HEAD changes
|
data/Gemfile
ADDED
data/LICENSE.txt
ADDED
@@ -0,0 +1,22 @@
|
|
1
|
+
Copyright (c) 2015 Rafał Rzepecki
|
2
|
+
|
3
|
+
MIT License
|
4
|
+
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
6
|
+
a copy of this software and associated documentation files (the
|
7
|
+
"Software"), to deal in the Software without restriction, including
|
8
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
9
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
10
|
+
permit persons to whom the Software is furnished to do so, subject to
|
11
|
+
the following conditions:
|
12
|
+
|
13
|
+
The above copyright notice and this permission notice shall be
|
14
|
+
included in all copies or substantial portions of the Software.
|
15
|
+
|
16
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
17
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
18
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
19
|
+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
20
|
+
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
21
|
+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
22
|
+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
data/README.md
ADDED
@@ -0,0 +1,44 @@
|
|
1
|
+
# MemTar
|
2
|
+
|
3
|
+
In-memory tar archive creation
|
4
|
+
|
5
|
+
## Installation
|
6
|
+
|
7
|
+
Add this line to your application's Gemfile:
|
8
|
+
|
9
|
+
```ruby
|
10
|
+
gem 'memtar'
|
11
|
+
```
|
12
|
+
|
13
|
+
And then execute:
|
14
|
+
|
15
|
+
$ bundle
|
16
|
+
|
17
|
+
Or install it yourself as:
|
18
|
+
|
19
|
+
$ gem install memtar
|
20
|
+
|
21
|
+
## Usage
|
22
|
+
|
23
|
+
```ruby
|
24
|
+
|
25
|
+
require 'memtar'
|
26
|
+
|
27
|
+
archive = MemTar.new
|
28
|
+
archive.default[:uname] = "nobody"
|
29
|
+
|
30
|
+
archive.add_file "foo", "content", mode: 0640
|
31
|
+
archive.add_file "bar/baz", "hi!"
|
32
|
+
archive.add_symlink "bar/xyzzy", "baz"
|
33
|
+
archive.add_file "this", File.new("/etc/passwd") # copies attributes and content
|
34
|
+
|
35
|
+
File.write "test.tar", archive.to_s
|
36
|
+
```
|
37
|
+
|
38
|
+
## Contributing
|
39
|
+
|
40
|
+
1. Fork it ( https://github.com/[my-github-username]/memtar/fork )
|
41
|
+
2. Create your feature branch (`git checkout -b my-new-feature`)
|
42
|
+
3. Commit your changes (`git commit -am 'Add some feature'`)
|
43
|
+
4. Push to the branch (`git push origin my-new-feature`)
|
44
|
+
5. Create a new Pull Request
|
data/Rakefile
ADDED
data/lib/memtar.rb
ADDED
@@ -0,0 +1,57 @@
|
|
1
|
+
require 'archive/tar/minitar'
|
2
|
+
require 'memtar/version'
|
3
|
+
|
4
|
+
# In-memory tar archive writer.
|
5
|
+
class MemTar
|
6
|
+
def initialize
|
7
|
+
@io = StringIO.new
|
8
|
+
end
|
9
|
+
|
10
|
+
def add_file path, content, opts = {}
|
11
|
+
return add_existing_file path, content if content.is_a?(File) && opts.empty?
|
12
|
+
fail ArgumentError, "handling of paths over 100 bytes long not implemented" if path.size > 100
|
13
|
+
|
14
|
+
size = content.size
|
15
|
+
@io.write header opts.merge size: size, name: path
|
16
|
+
@io.write content
|
17
|
+
@io.write "\0" * (512 - size % 512)
|
18
|
+
end
|
19
|
+
|
20
|
+
def add_symlink path, target
|
21
|
+
fail ArgumentError, "handling of paths over 100 bytes long not implemented" if path.size > 100
|
22
|
+
@io.write header typeflag: '2', size: 0, mode: 0777, name: path, linkname: target
|
23
|
+
end
|
24
|
+
|
25
|
+
def add_existing_file path, file
|
26
|
+
add_file path, file.read, MemTar.opts_of_stat(file.stat)
|
27
|
+
end
|
28
|
+
|
29
|
+
def self.opts_of_stat stat
|
30
|
+
uid, gid = [stat.uid, stat.gid]
|
31
|
+
{
|
32
|
+
mode: stat.mode & 0777,
|
33
|
+
uid: uid, gid: gid,
|
34
|
+
uname: Etc.getpwuid(uid).name,
|
35
|
+
gname: Etc.getgrgid(gid).name,
|
36
|
+
mtime: stat.mtime
|
37
|
+
}
|
38
|
+
end
|
39
|
+
|
40
|
+
def to_s
|
41
|
+
@io.string + "\0" * 1024
|
42
|
+
end
|
43
|
+
|
44
|
+
def header opts
|
45
|
+
Archive::Tar::PosixHeader.new(default.merge opts).to_s
|
46
|
+
end
|
47
|
+
|
48
|
+
def default
|
49
|
+
@default ||= {
|
50
|
+
mode: 0644,
|
51
|
+
uid: 0, gid: 0,
|
52
|
+
uname: 'wheel', gname: 'wheel',
|
53
|
+
mtime: Time.now,
|
54
|
+
prefix: ''
|
55
|
+
}
|
56
|
+
end
|
57
|
+
end
|
data/memtar.gemspec
ADDED
@@ -0,0 +1,25 @@
|
|
1
|
+
# coding: utf-8
|
2
|
+
lib = File.expand_path('../lib', __FILE__)
|
3
|
+
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
|
4
|
+
require 'memtar/version'
|
5
|
+
|
6
|
+
Gem::Specification.new do |spec|
|
7
|
+
spec.name = "memtar"
|
8
|
+
spec.version = MemTar::VERSION
|
9
|
+
spec.authors = ["Rafał Rzepecki"]
|
10
|
+
spec.email = ["rafal@conjur.net"]
|
11
|
+
spec.summary = %q{In-memory tar archive creation}
|
12
|
+
spec.homepage = "https://github.com/dividedmind/memtar"
|
13
|
+
spec.license = "MIT"
|
14
|
+
|
15
|
+
spec.files = `git ls-files -z`.split("\x0")
|
16
|
+
spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
|
17
|
+
spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
|
18
|
+
spec.require_paths = ["lib"]
|
19
|
+
|
20
|
+
spec.add_dependency "minitar", "~> 0.5"
|
21
|
+
|
22
|
+
spec.add_development_dependency "bundler", "~> 1.7"
|
23
|
+
spec.add_development_dependency "rake", "~> 10.0"
|
24
|
+
spec.add_development_dependency "rspec", "~> 3.2"
|
25
|
+
end
|
data/spec/memtar_spec.rb
ADDED
@@ -0,0 +1,34 @@
|
|
1
|
+
require 'spec_helper'
|
2
|
+
|
3
|
+
require 'tempfile'
|
4
|
+
|
5
|
+
require 'memtar'
|
6
|
+
|
7
|
+
describe MemTar do
|
8
|
+
include SpecHelpers
|
9
|
+
|
10
|
+
describe '#add_file' do
|
11
|
+
it 'adds a file to the archive' do
|
12
|
+
subject.add_file 'some-file', 'foo', mode: 0600, uname: 'nobody'
|
13
|
+
has_file 'some-file', content: 'foo', mode: 0600, uname: 'nobody'
|
14
|
+
end
|
15
|
+
|
16
|
+
it 'handles File arguments' do
|
17
|
+
file = Tempfile.new 'foo'
|
18
|
+
file.chmod 0750
|
19
|
+
file.write 'bar'
|
20
|
+
file.close
|
21
|
+
|
22
|
+
subject.add_file 'xyzzy', File.new(file.path)
|
23
|
+
has_file 'xyzzy', content: 'bar', mode: 0750, uname: Etc.getlogin
|
24
|
+
file.unlink
|
25
|
+
end
|
26
|
+
end
|
27
|
+
|
28
|
+
describe '#add_symlink' do
|
29
|
+
it 'creates a symlink in the archive' do
|
30
|
+
subject.add_symlink 'password-file', '/etc/passwd'
|
31
|
+
has_symlink 'password-file'
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
data/spec/spec_helper.rb
ADDED
@@ -0,0 +1,49 @@
|
|
1
|
+
module SpecHelpers
|
2
|
+
def reader
|
3
|
+
@reader ||= Archive::Tar::Minitar::Reader.new StringIO.new subject.to_s
|
4
|
+
end
|
5
|
+
|
6
|
+
module TarEntryWithContent
|
7
|
+
attr_reader :content
|
8
|
+
|
9
|
+
def self.extended entry
|
10
|
+
entry.read
|
11
|
+
end
|
12
|
+
|
13
|
+
def read
|
14
|
+
@content ||= super
|
15
|
+
end
|
16
|
+
end
|
17
|
+
|
18
|
+
# Disregard spurious :reek:ControlParameter
|
19
|
+
def seek path
|
20
|
+
reader.rewind
|
21
|
+
reader.each do |entry|
|
22
|
+
return entry.extend TarEntryWithContent if entry.full_name == path
|
23
|
+
end
|
24
|
+
end
|
25
|
+
|
26
|
+
def has_file path, opts
|
27
|
+
file = seek path
|
28
|
+
|
29
|
+
expect(file).to be
|
30
|
+
|
31
|
+
opts.each do |key, value|
|
32
|
+
expect(file.send key).to eq value
|
33
|
+
end
|
34
|
+
|
35
|
+
file
|
36
|
+
end
|
37
|
+
|
38
|
+
def has_symlink path
|
39
|
+
file = seek path
|
40
|
+
|
41
|
+
expect(file).to be
|
42
|
+
expect(file.typeflag).to eq '2'
|
43
|
+
|
44
|
+
# linkname reading is broken in minitar
|
45
|
+
# expect(file.linkname).to eq target
|
46
|
+
|
47
|
+
file
|
48
|
+
end
|
49
|
+
end
|
metadata
ADDED
@@ -0,0 +1,113 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: memtar
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 0.0.1
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- Rafał Rzepecki
|
8
|
+
autorequire:
|
9
|
+
bindir: bin
|
10
|
+
cert_chain: []
|
11
|
+
date: 2015-02-19 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
name: minitar
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
16
|
+
requirements:
|
17
|
+
- - "~>"
|
18
|
+
- !ruby/object:Gem::Version
|
19
|
+
version: '0.5'
|
20
|
+
type: :runtime
|
21
|
+
prerelease: false
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
23
|
+
requirements:
|
24
|
+
- - "~>"
|
25
|
+
- !ruby/object:Gem::Version
|
26
|
+
version: '0.5'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
name: bundler
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - "~>"
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: '1.7'
|
34
|
+
type: :development
|
35
|
+
prerelease: false
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - "~>"
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '1.7'
|
41
|
+
- !ruby/object:Gem::Dependency
|
42
|
+
name: rake
|
43
|
+
requirement: !ruby/object:Gem::Requirement
|
44
|
+
requirements:
|
45
|
+
- - "~>"
|
46
|
+
- !ruby/object:Gem::Version
|
47
|
+
version: '10.0'
|
48
|
+
type: :development
|
49
|
+
prerelease: false
|
50
|
+
version_requirements: !ruby/object:Gem::Requirement
|
51
|
+
requirements:
|
52
|
+
- - "~>"
|
53
|
+
- !ruby/object:Gem::Version
|
54
|
+
version: '10.0'
|
55
|
+
- !ruby/object:Gem::Dependency
|
56
|
+
name: rspec
|
57
|
+
requirement: !ruby/object:Gem::Requirement
|
58
|
+
requirements:
|
59
|
+
- - "~>"
|
60
|
+
- !ruby/object:Gem::Version
|
61
|
+
version: '3.2'
|
62
|
+
type: :development
|
63
|
+
prerelease: false
|
64
|
+
version_requirements: !ruby/object:Gem::Requirement
|
65
|
+
requirements:
|
66
|
+
- - "~>"
|
67
|
+
- !ruby/object:Gem::Version
|
68
|
+
version: '3.2'
|
69
|
+
description:
|
70
|
+
email:
|
71
|
+
- rafal@conjur.net
|
72
|
+
executables: []
|
73
|
+
extensions: []
|
74
|
+
extra_rdoc_files: []
|
75
|
+
files:
|
76
|
+
- ".gitignore"
|
77
|
+
- ".overcommit.yml"
|
78
|
+
- Gemfile
|
79
|
+
- LICENSE.txt
|
80
|
+
- README.md
|
81
|
+
- Rakefile
|
82
|
+
- lib/memtar.rb
|
83
|
+
- lib/memtar/version.rb
|
84
|
+
- memtar.gemspec
|
85
|
+
- spec/memtar_spec.rb
|
86
|
+
- spec/spec_helper.rb
|
87
|
+
homepage: https://github.com/dividedmind/memtar
|
88
|
+
licenses:
|
89
|
+
- MIT
|
90
|
+
metadata: {}
|
91
|
+
post_install_message:
|
92
|
+
rdoc_options: []
|
93
|
+
require_paths:
|
94
|
+
- lib
|
95
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
96
|
+
requirements:
|
97
|
+
- - ">="
|
98
|
+
- !ruby/object:Gem::Version
|
99
|
+
version: '0'
|
100
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
101
|
+
requirements:
|
102
|
+
- - ">="
|
103
|
+
- !ruby/object:Gem::Version
|
104
|
+
version: '0'
|
105
|
+
requirements: []
|
106
|
+
rubyforge_project:
|
107
|
+
rubygems_version: 2.4.4
|
108
|
+
signing_key:
|
109
|
+
specification_version: 4
|
110
|
+
summary: In-memory tar archive creation
|
111
|
+
test_files:
|
112
|
+
- spec/memtar_spec.rb
|
113
|
+
- spec/spec_helper.rb
|