App-Wax

 view release on metacpan or  search on metacpan

Changes  view on Meta::CPAN

2.2.0 - 2018-04-27

    - the version of the command (wax) is now separate from that
      of its library (App::Wax). this means breaking changes in the
      latter no longer trigger major SemVer bumps in the former
    - log messages now display the index of the URL they apply to

2.1.0 - 2018-03-15

    - update metadata to reflect updated dependencies in the build file
    - minor documentation tweaks/fixes

2.0.0 - 2018-03-15

    - breaking changes:
        - `resolve_temp` now returns a ($filename, $error) pair rather than
          just the filename
        - `render` has been renamed `dump_command`
        - `lwp_user_agent` has been removed
        - `keep` is now read-only

Changes  view on Meta::CPAN

    - fix documentation/code nits

1.0.0 - 2015-02-03

    - breaking changes:
        - the separator is now opt-in, i.e. `--` is no longer the default separator
            - as a result the -S/--no-separator option has been removed
        - -d/--debug is now -v/--verbose
        - -d is now short for --dir/--directory
    - new --cache option: remote resources are only fetched once
    - new --mirror option: remote resources are only fetched if they've been updated
    - parallelize downloads
    - improve tests

0.3.1 - 2011-06-17

    - fix documentation nits
    - rm README.md from CPAN

0.3.0 - 2011-06-17

README  view on Meta::CPAN

DESCRIPTION

wax is a command-line program which runs other command-line programs and
converts their URL arguments to local file paths. By default, the files are
removed after the command has exited.

As well as adding transparent support for remote resources to commands that
don't support them natively, wax can be used to:

- add support for HTTPS (and any other protocols supported by LWP [1]) to programs that only support HTTP [2]
- add a mirroring layer to network requests (remote resources are only fetched if they've been updated)
- add a caching layer to network requests (remote resources are only fetched once)

For more details, see the wax man page.

INSTALL

Install cpanminus [3] if it's not already installed, then:

    cpanm App::Wax

bin/wax  view on Meta::CPAN

=over

=item *

add support for HTTPS (and any other protocols supported by L<LWP>) to programs
that only support HTTP

=item *

add a mirroring layer to network requests (remote resources are only fetched if
they've been updated)

=item *

add a caching layer to network requests (remote resources are only fetched
once)

=back

=head1 OPTIONS

bin/wax  view on Meta::CPAN

Otherwise, an error is raised.

=head2 -h, -?, --help

Display this documentation.

=head2 -m, --mirror

Like the C<--cache> option, this keeps the downloaded file(s) after the command
exits. In addition, a HEAD request is issued for each resource to see if it has
been updated. If so, the latest version is downloaded; otherwise, the cached
version is used (if still available).

If a local file no longer exists, the resource is re-downloaded.

=head2 -s, --separator STRING

Override the default separator-token (C<-->) used to mark the end of waxable
options, e.g.:

    $ wax --cache --separator :: cmd https://example.com/foo :: --referrer https://example.com

lib/App/Wax.pod  view on Meta::CPAN

B<Type>: L<Mime::Types>, rw.

An instance of L<Mime::Types> used to help determine an extension for the file.

=head2 mirror

B<Type>: Bool, rw, default: false.

If set to true, the remote resource is saved to a persistent file. On
subsequent invocations, the resource is re-downloaded if it has been updated,
and its path is substituted for the resource's URL.

If L<"cache"> and L<"mirror"> are both set to true, an exception is thrown.

=head2 separator

B<Type>: Str, rw, default: "--".

A optional token used to mark the end of C<wax>'s options.