Tie-Handle-Offset-0.004/000755 000765 000024 00000000000 13267576470 015126 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/LICENSE000644 000765 000024 00000026354 13267576470 016145 0ustar00davidstaff000000 000000 This software is Copyright (c) 2012 by David Golden. This is free software, licensed under: The Apache License, Version 2.0, January 2004 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright [yyyy] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Tie-Handle-Offset-0.004/cpanfile000644 000765 000024 00000002236 13267576470 016635 0ustar00davidstaff000000 000000 requires "Tie::Handle" => "0"; requires "perl" => "5.006"; requires "strict" => "0"; on 'test' => sub { requires "ExtUtils::MakeMaker" => "0"; requires "File::Spec" => "0"; requires "Test::More" => "0"; requires "perl" => "5.006"; }; on 'test' => sub { recommends "CPAN::Meta" => "2.120900"; }; on 'configure' => sub { requires "ExtUtils::MakeMaker" => "6.17"; requires "perl" => "5.006"; }; on 'develop' => sub { requires "Dist::Zilla" => "5"; requires "Dist::Zilla::Plugin::RemovePrereqs" => "0"; requires "Dist::Zilla::PluginBundle::DAGOLDEN" => "0.072"; requires "File::Spec" => "0"; requires "File::Temp" => "0"; requires "IO::Handle" => "0"; requires "IPC::Open3" => "0"; requires "Pod::Coverage::TrustPod" => "0"; requires "Pod::Wordlist" => "0"; requires "Software::License::Apache_2_0" => "0"; requires "Test::CPAN::Meta" => "0"; requires "Test::More" => "0"; requires "Test::Perl::Critic" => "0"; requires "Test::Pod" => "1.41"; requires "Test::Pod::Coverage" => "1.08"; requires "Test::Portability::Files" => "0"; requires "Test::Spelling" => "0.12"; requires "Test::Version" => "1"; requires "perl" => "5.006"; }; Tie-Handle-Offset-0.004/Changes000644 000765 000024 00000001225 13267576470 016421 0ustar00davidstaff000000 000000 Revision history for Tie-Handle-Offset 0.004 2018-04-24 05:47:29-04:00 America/New_York [FIXED] - Remove t/00-compile.t 0.003 2012-04-05 11:05:59 America/New_York [BUGFIX] - Fix glob-slot object for older perls - Fix tests for older Test::More 0.002 2012-04-04 06:45:12 America/New_York [OTHER] - Switched from inside-out object pattern to glob HASH slot object pattern - Inlined methods from Tie::StdHandle to avoid dependency on Perl 5.8.9+ - Removed dependency on parent.pm and warnings.pm - Lowered Test::More dependency version 0.001 2012-03-31 08:17:37 Europe/Paris - Tie-Handle-Offset-0.004/MANIFEST000644 000765 000024 00000001031 13267576470 016252 0ustar00davidstaff000000 000000 # This file was automatically generated by Dist::Zilla::Plugin::Manifest v6.012. CONTRIBUTING.mkdn Changes LICENSE MANIFEST META.json META.yml Makefile.PL README cpanfile dist.ini lib/Tie/Handle/Offset.pm lib/Tie/Handle/SkipHeader.pm perlcritic.rc t/00-report-prereqs.dd t/00-report-prereqs.t t/data/header.txt t/data/test.txt t/offset.t t/skip-header.t xt/author/00-compile.t xt/author/critic.t xt/author/pod-coverage.t xt/author/pod-spell.t xt/author/pod-syntax.t xt/author/portability.t xt/author/test-version.t xt/release/distmeta.t Tie-Handle-Offset-0.004/perlcritic.rc000644 000765 000024 00000001166 13267576470 017620 0ustar00davidstaff000000 000000 severity = 5 verbose = 8 [Variables::ProhibitPunctuationVars] allow = $@ $! [TestingAndDebugging::ProhibitNoStrict] allow = refs [Variables::ProhibitEvilVariables] variables = $DB::single # Turn these off [-BuiltinFunctions::ProhibitStringyEval] [-ControlStructures::ProhibitPostfixControls] [-ControlStructures::ProhibitUnlessBlocks] [-Documentation::RequirePodSections] [-InputOutput::ProhibitInteractiveTest] [-References::ProhibitDoubleSigils] [-RegularExpressions::RequireExtendedFormatting] [-InputOutput::ProhibitTwoArgOpen] [-Modules::ProhibitEvilModules] # Turn this on [Lax::ProhibitStringyEval::ExceptForRequire] Tie-Handle-Offset-0.004/CONTRIBUTING.mkdn000644 000765 000024 00000006604 13267576470 017716 0ustar00davidstaff000000 000000 ## HOW TO CONTRIBUTE Thank you for considering contributing to this distribution. This file contains instructions that will help you work with the source code. The distribution is managed with Dist::Zilla. This means that many of the usual files you might expect are not in the repository, but are generated at release time, as is much of the documentation. Some generated files are kept in the repository as a convenience (e.g. Makefile.PL or cpanfile). Generally, **you do not need Dist::Zilla to contribute patches**. You do need Dist::Zilla to create a tarball. See below for guidance. ### Getting dependencies If you have App::cpanminus 1.6 or later installed, you can use `cpanm` to satisfy dependencies like this: $ cpanm --installdeps . Otherwise, look for either a `Makefile.PL` or `cpanfile` file for a list of dependencies to satisfy. ### Running tests You can run tests directly using the `prove` tool: $ prove -l $ prove -lv t/some_test_file.t For most of my distributions, `prove` is entirely sufficient for you to test any patches you have. I use `prove` for 99% of my testing during development. ### Code style and tidying Please try to match any existing coding style. If there is a `.perltidyrc` file, please install Perl::Tidy and use perltidy before submitting patches. If there is a `tidyall.ini` file, you can also install Code::TidyAll and run `tidyall` on a file or `tidyall -a` to tidy all files. ### Patching documentation Much of the documentation Pod is generated at release time. Some is generated boilerplate; other documentation is built from pseudo-POD directives in the source like C<=method> or C<=func>. If you would like to submit a documentation edit, please limit yourself to the documentation you see. If you see typos or documentation issues in the generated docs, please email or open a bug ticket instead of patching. ### Where to send patches and pull requests If you found this distribution on Github, sending a pull-request is the best way to contribute. If a pull-request isn't possible, a bug ticket with a patch file is the next best option. As a last resort, an email to the author(s) is acceptable. ## Installing and using Dist::Zilla Dist::Zilla is not required for contributing, but if you'd like to learn more, this section will get you up to speed. Dist::Zilla is a very powerful authoring tool, optimized for maintaining a large number of distributions with a high degree of automation, but it has a large dependency chain, a bit of a learning curve and requires a number of author-specific plugins. To install it from CPAN, I recommend one of the following approaches for the quickest installation: # using CPAN.pm, but bypassing non-functional pod tests $ cpan TAP::Harness::Restricted $ PERL_MM_USE_DEFAULT=1 HARNESS_CLASS=TAP::Harness::Restricted cpan Dist::Zilla # using cpanm, bypassing *all* tests $ cpanm -n Dist::Zilla In either case, it's probably going to take about 10 minutes. Go for a walk, go get a cup of your favorite beverage, take a bathroom break, or whatever. When you get back, Dist::Zilla should be ready for you. Then you need to install any plugins specific to this distribution: $ cpan `dzil authordeps` $ dzil authordeps | cpanm Once installed, here are some dzil commands you might try: $ dzil build $ dzil test $ dzil xtest You can learn more about Dist::Zilla at http://dzil.org/ Tie-Handle-Offset-0.004/t/000755 000765 000024 00000000000 13267576470 015371 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/xt/000755 000765 000024 00000000000 13267576470 015561 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/README000644 000765 000024 00000002573 13267576470 016015 0ustar00davidstaff000000 000000 NAME Tie::Handle::Offset - Tied handle that hides the beginning of a file VERSION version 0.004 SYNOPSIS use Tie::Handle::Offset; tie *FH, 'Tie::Handle::Offset', "<", $filename, { offset => 20 }; DESCRIPTION This modules provides a file handle that hides the beginning of a file. After opening, the file is positioned at the offset location. "seek()" and "tell()" calls are modified to preserve the offset. For example, "tell($fh)" will return 0, though the actual file position is at the offset. Likewise, "seek($fh,80,0)" will seek to 80 bytes from the offset instead of 80 bytes from the actual start of the file. SUPPORT Bugs / Feature Requests Please report any bugs or feature requests through the issue tracker at . You will be notified automatically of any progress on your issue. Source Code This is open source software. The code repository is available for public review and contribution under the terms of the license. git clone https://github.com/dagolden/tie-handle-offset.git AUTHOR David Golden COPYRIGHT AND LICENSE This software is Copyright (c) 2012 by David Golden. This is free software, licensed under: The Apache License, Version 2.0, January 2004 Tie-Handle-Offset-0.004/META.yml000644 000765 000024 00000002175 13267576470 016404 0ustar00davidstaff000000 000000 --- abstract: 'Tied handle that hides the beginning of a file' author: - 'David Golden ' build_requires: ExtUtils::MakeMaker: '0' File::Spec: '0' Test::More: '0' perl: '5.006' configure_requires: ExtUtils::MakeMaker: '6.17' perl: '5.006' dynamic_config: 0 generated_by: 'Dist::Zilla version 6.012, CPAN::Meta::Converter version 2.150010' license: apache meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: '1.4' name: Tie-Handle-Offset no_index: directory: - corpus - examples - t - xt package: - DB provides: Tie::Handle::Offset: file: lib/Tie/Handle/Offset.pm version: '0.004' Tie::Handle::SkipHeader: file: lib/Tie/Handle/SkipHeader.pm version: '0.004' requires: Tie::Handle: '0' perl: '5.006' strict: '0' resources: bugtracker: https://github.com/dagolden/tie-handle-offset/issues homepage: https://github.com/dagolden/tie-handle-offset repository: https://github.com/dagolden/tie-handle-offset.git version: '0.004' x_authority: cpan:DAGOLDEN x_generated_by_perl: v5.26.1 x_serialization_backend: 'YAML::Tiny version 1.70' Tie-Handle-Offset-0.004/lib/000755 000765 000024 00000000000 13267576470 015674 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/Makefile.PL000644 000765 000024 00000002277 13267576470 017110 0ustar00davidstaff000000 000000 # This file was automatically generated by Dist::Zilla::Plugin::MakeMaker v6.012. use strict; use warnings; use 5.006; use ExtUtils::MakeMaker 6.17; my %WriteMakefileArgs = ( "ABSTRACT" => "Tied handle that hides the beginning of a file", "AUTHOR" => "David Golden ", "CONFIGURE_REQUIRES" => { "ExtUtils::MakeMaker" => "6.17" }, "DISTNAME" => "Tie-Handle-Offset", "LICENSE" => "apache", "MIN_PERL_VERSION" => "5.006", "NAME" => "Tie::Handle::Offset", "PREREQ_PM" => { "Tie::Handle" => 0, "strict" => 0 }, "TEST_REQUIRES" => { "ExtUtils::MakeMaker" => 0, "File::Spec" => 0, "Test::More" => 0 }, "VERSION" => "0.004", "test" => { "TESTS" => "t/*.t" } ); my %FallbackPrereqs = ( "ExtUtils::MakeMaker" => 0, "File::Spec" => 0, "Test::More" => 0, "Tie::Handle" => 0, "strict" => 0 ); unless ( eval { ExtUtils::MakeMaker->VERSION(6.63_03) } ) { delete $WriteMakefileArgs{TEST_REQUIRES}; delete $WriteMakefileArgs{BUILD_REQUIRES}; $WriteMakefileArgs{PREREQ_PM} = \%FallbackPrereqs; } delete $WriteMakefileArgs{CONFIGURE_REQUIRES} unless eval { ExtUtils::MakeMaker->VERSION(6.52) }; WriteMakefile(%WriteMakefileArgs); Tie-Handle-Offset-0.004/META.json000644 000765 000024 00000005430 13267576470 016551 0ustar00davidstaff000000 000000 { "abstract" : "Tied handle that hides the beginning of a file", "author" : [ "David Golden " ], "dynamic_config" : 0, "generated_by" : "Dist::Zilla version 6.012, CPAN::Meta::Converter version 2.150010", "license" : [ "apache_2_0" ], "meta-spec" : { "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec", "version" : 2 }, "name" : "Tie-Handle-Offset", "no_index" : { "directory" : [ "corpus", "examples", "t", "xt" ], "package" : [ "DB" ] }, "prereqs" : { "configure" : { "requires" : { "ExtUtils::MakeMaker" : "6.17", "perl" : "5.006" } }, "develop" : { "requires" : { "Dist::Zilla" : "5", "Dist::Zilla::Plugin::RemovePrereqs" : "0", "Dist::Zilla::PluginBundle::DAGOLDEN" : "0.072", "File::Spec" : "0", "File::Temp" : "0", "IO::Handle" : "0", "IPC::Open3" : "0", "Pod::Coverage::TrustPod" : "0", "Pod::Wordlist" : "0", "Software::License::Apache_2_0" : "0", "Test::CPAN::Meta" : "0", "Test::More" : "0", "Test::Perl::Critic" : "0", "Test::Pod" : "1.41", "Test::Pod::Coverage" : "1.08", "Test::Portability::Files" : "0", "Test::Spelling" : "0.12", "Test::Version" : "1", "perl" : "5.006" } }, "runtime" : { "requires" : { "Tie::Handle" : "0", "perl" : "5.006", "strict" : "0" } }, "test" : { "recommends" : { "CPAN::Meta" : "2.120900" }, "requires" : { "ExtUtils::MakeMaker" : "0", "File::Spec" : "0", "Test::More" : "0", "perl" : "5.006" } } }, "provides" : { "Tie::Handle::Offset" : { "file" : "lib/Tie/Handle/Offset.pm", "version" : "0.004" }, "Tie::Handle::SkipHeader" : { "file" : "lib/Tie/Handle/SkipHeader.pm", "version" : "0.004" } }, "release_status" : "stable", "resources" : { "bugtracker" : { "web" : "https://github.com/dagolden/tie-handle-offset/issues" }, "homepage" : "https://github.com/dagolden/tie-handle-offset", "repository" : { "type" : "git", "url" : "https://github.com/dagolden/tie-handle-offset.git", "web" : "https://github.com/dagolden/tie-handle-offset" } }, "version" : "0.004", "x_authority" : "cpan:DAGOLDEN", "x_generated_by_perl" : "v5.26.1", "x_serialization_backend" : "Cpanel::JSON::XS version 3.0239" } Tie-Handle-Offset-0.004/dist.ini000644 000765 000024 00000000351 13267576470 016571 0ustar00davidstaff000000 000000 name = Tie-Handle-Offset author = David Golden license = Apache_2_0 copyright_holder = David Golden copyright_year = 2012 [@DAGOLDEN] :version = 0.072 no_minimum_perl = 1 [RemovePrereqs] remove = warnings Tie-Handle-Offset-0.004/lib/Tie/000755 000765 000024 00000000000 13267576470 016415 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/lib/Tie/Handle/000755 000765 000024 00000000000 13267576470 017610 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/lib/Tie/Handle/Offset.pm000644 000765 000024 00000007571 13267576470 021406 0ustar00davidstaff000000 000000 use strict; BEGIN{ if (not $] < 5.006) { require warnings; warnings->import } } package Tie::Handle::Offset; # ABSTRACT: Tied handle that hides the beginning of a file our $VERSION = '0.004'; use Tie::Handle; our @ISA = qw/Tie::Handle/; #--------------------------------------------------------------------------# # Glob slot accessor #--------------------------------------------------------------------------# sub offset { my $self = shift; if ( @_ ) { return ${*$self}{offset} = shift; } else { return ${*$self}{offset}; } } #--------------------------------------------------------------------------# # Tied handle methods #--------------------------------------------------------------------------# sub TIEHANDLE { my $class = shift; my $params; $params = pop if ref $_[-1] eq 'HASH'; my $self = \do { no warnings 'once'; local *HANDLE}; bless $self,$class; $self->OPEN(@_) if (@_); if ( $params->{offset} ) { seek( $self, $self->offset( $params->{offset} ), 0 ); } return $self; } sub TELL { my $cur = tell($_[0]) - $_[0]->offset; # XXX shouldn't ever be less than zero, but just in case... return $cur > 0 ? $cur : 0; } sub SEEK { my ($self, $pos, $whence) = @_; my $rc; if ( $whence == 0 || $whence == 1 ) { # pos from start, cur $rc = seek($self, $pos + $self->offset, $whence); } elsif ( _size($self) + $pos < $self->offset ) { # from end $rc = ''; } else { $rc = seek($self,$pos,$whence); } return $rc; } sub OPEN { $_[0]->offset(0); $_[0]->CLOSE if defined($_[0]->FILENO); @_ == 2 ? open($_[0], $_[1]) : open($_[0], $_[1], $_[2]); } sub _size { my ($self) = @_; my $cur = tell($self); seek($self,0,2); # end my $size = tell($self); seek($self,$cur,0); # reset return $size; } #--------------------------------------------------------------------------# # Methods copied from Tie::StdHandle to avoid dependency on Perl 5.8.9/5.10.0 #--------------------------------------------------------------------------# sub EOF { eof($_[0]) } sub FILENO { fileno($_[0]) } sub CLOSE { close($_[0]) } sub BINMODE { binmode($_[0]) } sub READ { read($_[0],$_[1],$_[2]) } sub READLINE { my $fh = $_[0]; <$fh> } sub GETC { getc($_[0]) } sub WRITE { my $fh = $_[0]; print $fh substr($_[1],0,$_[2]) } 1; # vim: ts=2 sts=2 sw=2 et: __END__ =pod =encoding UTF-8 =head1 NAME Tie::Handle::Offset - Tied handle that hides the beginning of a file =head1 VERSION version 0.004 =head1 SYNOPSIS use Tie::Handle::Offset; tie *FH, 'Tie::Handle::Offset', "<", $filename, { offset => 20 }; =head1 DESCRIPTION This modules provides a file handle that hides the beginning of a file. After opening, the file is positioned at the offset location. C and C calls are modified to preserve the offset. For example, C will return 0, though the actual file position is at the offset. Likewise, C will seek to 80 bytes from the offset instead of 80 bytes from the actual start of the file. =for Pod::Coverage method_names_here =for :stopwords cpan testmatrix url annocpan anno bugtracker rt cpants kwalitee diff irc mailto metadata placeholders metacpan =head1 SUPPORT =head2 Bugs / Feature Requests Please report any bugs or feature requests through the issue tracker at L. You will be notified automatically of any progress on your issue. =head2 Source Code This is open source software. The code repository is available for public review and contribution under the terms of the license. L git clone https://github.com/dagolden/tie-handle-offset.git =head1 AUTHOR David Golden =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2012 by David Golden. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut Tie-Handle-Offset-0.004/lib/Tie/Handle/SkipHeader.pm000644 000765 000024 00000002611 13267576470 022165 0ustar00davidstaff000000 000000 use strict; BEGIN{ if (not $] < 5.006) { require warnings; warnings->import } } package Tie::Handle::SkipHeader; # ABSTRACT: Tied handle that hides an RFC822-style header our $VERSION = '0.004'; use Tie::Handle::Offset; our @ISA = qw/Tie::Handle::Offset/; sub TIEHANDLE { my $class = shift; pop if ref $_[-1] eq 'HASH'; # we don't take any arguments return $class->SUPER::TIEHANDLE(@_); } # read to blank/whitespace line and set offset right after sub OPEN { my $self = shift; my $rc = $self->SUPER::OPEN(@_); while ( my $line = <$self> ) { last if $line =~ /\A\s*\Z/; } $self->offset( tell($self) ); return $rc; } 1; # vim: ts=2 sts=2 sw=2 et: __END__ =pod =encoding UTF-8 =head1 NAME Tie::Handle::SkipHeader - Tied handle that hides an RFC822-style header =head1 VERSION version 0.004 =head1 SYNOPSIS use Tie::Handle::SkipHeader; tie *FH, 'Tie::Handle::SkipHeader', "<", $filename; =head1 DESCRIPTION This subclass of L automatically hides an email-style message header. After opening the file, it reads up to a blank or white-space-only line and sets the offset to the next byte. =for Pod::Coverage method_names_here =head1 AUTHOR David Golden =head1 COPYRIGHT AND LICENSE This software is Copyright (c) 2012 by David Golden. This is free software, licensed under: The Apache License, Version 2.0, January 2004 =cut Tie-Handle-Offset-0.004/xt/author/000755 000765 000024 00000000000 13267576470 017063 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/xt/release/000755 000765 000024 00000000000 13267576470 017201 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/xt/release/distmeta.t000644 000765 000024 00000000172 13267576470 021200 0ustar00davidstaff000000 000000 #!perl # This file was automatically generated by Dist::Zilla::Plugin::MetaTests. use Test::CPAN::Meta; meta_yaml_ok(); Tie-Handle-Offset-0.004/xt/author/critic.t000644 000765 000024 00000000201 13267576470 020516 0ustar00davidstaff000000 000000 #!perl use strict; use warnings; use Test::Perl::Critic (-profile => "perlcritic.rc") x!! -e "perlcritic.rc"; all_critic_ok(); Tie-Handle-Offset-0.004/xt/author/test-version.t000644 000765 000024 00000000637 13267576470 021720 0ustar00davidstaff000000 000000 use strict; use warnings; use Test::More; # generated by Dist::Zilla::Plugin::Test::Version 1.09 use Test::Version; my @imports = qw( version_all_ok ); my $params = { is_strict => 0, has_version => 1, multiple => 0, }; push @imports, $params if version->parse( $Test::Version::VERSION ) >= version->parse('1.002'); Test::Version->import(@imports); version_all_ok; done_testing; Tie-Handle-Offset-0.004/xt/author/00-compile.t000644 000765 000024 00000002726 13267576470 021124 0ustar00davidstaff000000 000000 use 5.006; use strict; use warnings; # this test was generated with Dist::Zilla::Plugin::Test::Compile 2.058 use Test::More; plan tests => 3; my @module_files = ( 'Tie/Handle/Offset.pm', 'Tie/Handle/SkipHeader.pm' ); # fake home for cpan-testers use File::Temp; local $ENV{HOME} = File::Temp::tempdir( CLEANUP => 1 ); my @switches = ( -d 'blib' ? '-Mblib' : '-Ilib', ); use File::Spec; use IPC::Open3; use IO::Handle; open my $stdin, '<', File::Spec->devnull or die "can't open devnull: $!"; my @warnings; for my $lib (@module_files) { # see L my $stderr = IO::Handle->new; diag('Running: ', join(', ', map { my $str = $_; $str =~ s/'/\\'/g; q{'} . $str . q{'} } $^X, @switches, '-e', "require q[$lib]")) if $ENV{PERL_COMPILE_TEST_DEBUG}; my $pid = open3($stdin, '>&STDERR', $stderr, $^X, @switches, '-e', "require q[$lib]"); binmode $stderr, ':crlf' if $^O eq 'MSWin32'; my @_warnings = <$stderr>; waitpid($pid, 0); is($?, 0, "$lib loaded ok"); shift @_warnings if @_warnings and $_warnings[0] =~ /^Using .*\bblib/ and not eval { +require blib; blib->VERSION('1.01') }; if (@_warnings) { warn @_warnings; push @warnings, @_warnings; } } is(scalar(@warnings), 0, 'no warnings found') or diag 'got warnings: ', ( Test::More->can('explain') ? Test::More::explain(\@warnings) : join("\n", '', @warnings) ); Tie-Handle-Offset-0.004/xt/author/pod-syntax.t000644 000765 000024 00000000252 13267576470 021355 0ustar00davidstaff000000 000000 #!perl # This file was automatically generated by Dist::Zilla::Plugin::PodSyntaxTests. use strict; use warnings; use Test::More; use Test::Pod 1.41; all_pod_files_ok(); Tie-Handle-Offset-0.004/xt/author/portability.t000644 000765 000024 00000000322 13267576470 021607 0ustar00davidstaff000000 000000 use strict; use warnings; use Test::More; eval 'use Test::Portability::Files'; plan skip_all => 'Test::Portability::Files required for testing portability' if $@; options(test_one_dot => 0); run_tests(); Tie-Handle-Offset-0.004/xt/author/pod-spell.t000644 000765 000024 00000000433 13267576470 021147 0ustar00davidstaff000000 000000 use strict; use warnings; use Test::More; # generated by Dist::Zilla::Plugin::Test::PodSpelling 2.007005 use Test::Spelling 0.12; use Pod::Wordlist; add_stopwords(); all_pod_files_spelling_ok( qw( bin lib ) ); __DATA__ David Golden Handle Offset SkipHeader Tie dagolden lib Tie-Handle-Offset-0.004/xt/author/pod-coverage.t000644 000765 000024 00000000334 13267576470 021623 0ustar00davidstaff000000 000000 #!perl # This file was automatically generated by Dist::Zilla::Plugin::PodCoverageTests. use Test::Pod::Coverage 1.08; use Pod::Coverage::TrustPod; all_pod_coverage_ok({ coverage_class => 'Pod::Coverage::TrustPod' }); Tie-Handle-Offset-0.004/t/offset.t000644 000765 000024 00000003027 13267576470 017046 0ustar00davidstaff000000 000000 use strict; BEGIN{ if (not $] < 5.006) { require warnings; warnings->import } } use Test::More; plan tests => 18; use Tie::Handle::Offset; local *FH; tie *FH, 'Tie::Handle::Offset', "<", "t/data/test.txt", {offset => 1}; ok( tied(*FH), "handle is tied with offset 1" ); is( tell(*FH), 0, "tell() reports 0" ); is( scalar, "ine one\n", "readline correct" ); ok( seek(*FH,8,0), "seek() 8 from start" ); is( scalar, "Line two\n", "readline correct" ); my $cur = tell(*FH); is( seek(*FH,-100,2), '', "seek past start of file fails to seek" ); is( tell(*FH), $cur, "tell() reports seek() didn't move" ); seek(*FH,0,2); my $size = tell(*FH); seek(*FH,$cur,0); is( seek(*FH,-($size+1),2), '', "seek into offset fails to seek" ); is( tell(*FH), $cur, "tell() reports seek() didn't move" ) or diag ; is( seek(*FH,-10,2), 1, "seek back from end" ); is( scalar, "Line four\n", "readline correct" ); untie *FH; tie *FH, 'Tie::Handle::Offset', "<", "t/data/test.txt", {offset => 1000}; ok( tied(*FH), "handle is tied with offset 1000 (too big)" ); is( tell(*FH), 0, "tell() reports 0" ); is( scalar, undef, "readline correct (undef)" ); is( seek(*FH,0,0), 1, "seek to start" ); is( scalar, undef, "readline correct (undef)" ); is( seek(*FH,-$size,2), '', "seek into offset fails to seek" ); is( scalar, undef, "readline correct (undef)" ); # # This file is part of Tie-Handle-Offset # # This software is Copyright (c) 2012 by David Golden. # # This is free software, licensed under: # # The Apache License, Version 2.0, January 2004 # Tie-Handle-Offset-0.004/t/skip-header.t000644 000765 000024 00000001313 13267576470 017750 0ustar00davidstaff000000 000000 use strict; BEGIN{ if (not $] < 5.006) { require warnings; warnings->import } } use Test::More; plan tests => 5; use Tie::Handle::SkipHeader; local *FH; tie *FH, 'Tie::Handle::SkipHeader', "<", "t/data/header.txt"; ok( tied(*FH), "handle is tied" ); is( tell(*FH), 0, "tell() reports 0" ); is( scalar, "The quick brown fox jumped over the lazy dog.\n", "readline correct" ); ok( seek(*FH,0,0), "seek() 0 from start" ); is( scalar, "The quick brown fox jumped over the lazy dog.\n", "readline correct" ); # # This file is part of Tie-Handle-Offset # # This software is Copyright (c) 2012 by David Golden. # # This is free software, licensed under: # # The Apache License, Version 2.0, January 2004 # Tie-Handle-Offset-0.004/t/00-report-prereqs.t000644 000765 000024 00000013426 13267576470 020773 0ustar00davidstaff000000 000000 #!perl use strict; use warnings; # This test was generated by Dist::Zilla::Plugin::Test::ReportPrereqs 0.027 use Test::More tests => 1; use ExtUtils::MakeMaker; use File::Spec; # from $version::LAX my $lax_version_re = qr/(?: undef | (?: (?:[0-9]+) (?: \. | (?:\.[0-9]+) (?:_[0-9]+)? )? | (?:\.[0-9]+) (?:_[0-9]+)? ) | (?: v (?:[0-9]+) (?: (?:\.[0-9]+)+ (?:_[0-9]+)? )? | (?:[0-9]+)? (?:\.[0-9]+){2,} (?:_[0-9]+)? ) )/x; # hide optional CPAN::Meta modules from prereq scanner # and check if they are available my $cpan_meta = "CPAN::Meta"; my $cpan_meta_pre = "CPAN::Meta::Prereqs"; my $HAS_CPAN_META = eval "require $cpan_meta; $cpan_meta->VERSION('2.120900')" && eval "require $cpan_meta_pre"; ## no critic # Verify requirements? my $DO_VERIFY_PREREQS = 1; sub _max { my $max = shift; $max = ( $_ > $max ) ? $_ : $max for @_; return $max; } sub _merge_prereqs { my ($collector, $prereqs) = @_; # CPAN::Meta::Prereqs object if (ref $collector eq $cpan_meta_pre) { return $collector->with_merged_prereqs( CPAN::Meta::Prereqs->new( $prereqs ) ); } # Raw hashrefs for my $phase ( keys %$prereqs ) { for my $type ( keys %{ $prereqs->{$phase} } ) { for my $module ( keys %{ $prereqs->{$phase}{$type} } ) { $collector->{$phase}{$type}{$module} = $prereqs->{$phase}{$type}{$module}; } } } return $collector; } my @include = qw( ); my @exclude = qw( ); # Add static prereqs to the included modules list my $static_prereqs = do './t/00-report-prereqs.dd'; # Merge all prereqs (either with ::Prereqs or a hashref) my $full_prereqs = _merge_prereqs( ( $HAS_CPAN_META ? $cpan_meta_pre->new : {} ), $static_prereqs ); # Add dynamic prereqs to the included modules list (if we can) my ($source) = grep { -f } 'MYMETA.json', 'MYMETA.yml'; my $cpan_meta_error; if ( $source && $HAS_CPAN_META && (my $meta = eval { CPAN::Meta->load_file($source) } ) ) { $full_prereqs = _merge_prereqs($full_prereqs, $meta->prereqs); } else { $cpan_meta_error = $@; # capture error from CPAN::Meta->load_file($source) $source = 'static metadata'; } my @full_reports; my @dep_errors; my $req_hash = $HAS_CPAN_META ? $full_prereqs->as_string_hash : $full_prereqs; # Add static includes into a fake section for my $mod (@include) { $req_hash->{other}{modules}{$mod} = 0; } for my $phase ( qw(configure build test runtime develop other) ) { next unless $req_hash->{$phase}; next if ($phase eq 'develop' and not $ENV{AUTHOR_TESTING}); for my $type ( qw(requires recommends suggests conflicts modules) ) { next unless $req_hash->{$phase}{$type}; my $title = ucfirst($phase).' '.ucfirst($type); my @reports = [qw/Module Want Have/]; for my $mod ( sort keys %{ $req_hash->{$phase}{$type} } ) { next if $mod eq 'perl'; next if grep { $_ eq $mod } @exclude; my $file = $mod; $file =~ s{::}{/}g; $file .= ".pm"; my ($prefix) = grep { -e File::Spec->catfile($_, $file) } @INC; my $want = $req_hash->{$phase}{$type}{$mod}; $want = "undef" unless defined $want; $want = "any" if !$want && $want == 0; my $req_string = $want eq 'any' ? 'any version required' : "version '$want' required"; if ($prefix) { my $have = MM->parse_version( File::Spec->catfile($prefix, $file) ); $have = "undef" unless defined $have; push @reports, [$mod, $want, $have]; if ( $DO_VERIFY_PREREQS && $HAS_CPAN_META && $type eq 'requires' ) { if ( $have !~ /\A$lax_version_re\z/ ) { push @dep_errors, "$mod version '$have' cannot be parsed ($req_string)"; } elsif ( ! $full_prereqs->requirements_for( $phase, $type )->accepts_module( $mod => $have ) ) { push @dep_errors, "$mod version '$have' is not in required range '$want'"; } } } else { push @reports, [$mod, $want, "missing"]; if ( $DO_VERIFY_PREREQS && $type eq 'requires' ) { push @dep_errors, "$mod is not installed ($req_string)"; } } } if ( @reports ) { push @full_reports, "=== $title ===\n\n"; my $ml = _max( map { length $_->[0] } @reports ); my $wl = _max( map { length $_->[1] } @reports ); my $hl = _max( map { length $_->[2] } @reports ); if ($type eq 'modules') { splice @reports, 1, 0, ["-" x $ml, "", "-" x $hl]; push @full_reports, map { sprintf(" %*s %*s\n", -$ml, $_->[0], $hl, $_->[2]) } @reports; } else { splice @reports, 1, 0, ["-" x $ml, "-" x $wl, "-" x $hl]; push @full_reports, map { sprintf(" %*s %*s %*s\n", -$ml, $_->[0], $wl, $_->[1], $hl, $_->[2]) } @reports; } push @full_reports, "\n"; } } } if ( @full_reports ) { diag "\nVersions for all modules listed in $source (including optional ones):\n\n", @full_reports; } if ( $cpan_meta_error || @dep_errors ) { diag "\n*** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ***\n"; } if ( $cpan_meta_error ) { my ($orig_source) = grep { -f } 'MYMETA.json', 'MYMETA.yml'; diag "\nCPAN::Meta->load_file('$orig_source') failed with: $cpan_meta_error\n"; } if ( @dep_errors ) { diag join("\n", "\nThe following REQUIRED prerequisites were not satisfied:\n", @dep_errors, "\n" ); } pass; # vim: ts=4 sts=4 sw=4 et: Tie-Handle-Offset-0.004/t/00-report-prereqs.dd000644 000765 000024 00000004610 13267576470 021112 0ustar00davidstaff000000 000000 do { my $x = { 'configure' => { 'requires' => { 'ExtUtils::MakeMaker' => '6.17', 'perl' => '5.006' } }, 'develop' => { 'requires' => { 'Dist::Zilla' => '5', 'Dist::Zilla::Plugin::RemovePrereqs' => '0', 'Dist::Zilla::PluginBundle::DAGOLDEN' => '0.072', 'File::Spec' => '0', 'File::Temp' => '0', 'IO::Handle' => '0', 'IPC::Open3' => '0', 'Pod::Coverage::TrustPod' => '0', 'Pod::Wordlist' => '0', 'Software::License::Apache_2_0' => '0', 'Test::CPAN::Meta' => '0', 'Test::More' => '0', 'Test::Perl::Critic' => '0', 'Test::Pod' => '1.41', 'Test::Pod::Coverage' => '1.08', 'Test::Portability::Files' => '0', 'Test::Spelling' => '0.12', 'Test::Version' => '1', 'perl' => '5.006' } }, 'runtime' => { 'requires' => { 'Tie::Handle' => '0', 'perl' => '5.006', 'strict' => '0' } }, 'test' => { 'recommends' => { 'CPAN::Meta' => '2.120900' }, 'requires' => { 'ExtUtils::MakeMaker' => '0', 'File::Spec' => '0', 'Test::More' => '0', 'perl' => '5.006' } } }; $x; }Tie-Handle-Offset-0.004/t/data/000755 000765 000024 00000000000 13267576470 016302 5ustar00davidstaff000000 000000 Tie-Handle-Offset-0.004/t/data/test.txt000644 000765 000024 00000000047 13267576470 020023 0ustar00davidstaff000000 000000 Line one Line two Line three Line four Tie-Handle-Offset-0.004/t/data/header.txt000644 000765 000024 00000000300 13267576470 020264 0ustar00davidstaff000000 000000 To: Anyone From: Someone Subject: Whatever The quick brown fox jumped over the lazy dog. Several times, actually. Then the lazy dog decided not to be so lazy and went ahead and bit the fox.