Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/briandfoy/business-isbn-data

Data pack for Business::ISBN
https://github.com/briandfoy/business-isbn-data

data-pack isbn perl perl-module

Last synced: about 1 month ago
JSON representation

Data pack for Business::ISBN

Host: GitHub
URL: https://github.com/briandfoy/business-isbn-data
Owner: briandfoy
License: other
Created: 2015-01-01T21:22:07.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2024-10-19T15:50:06.000Z (2 months ago)
Last Synced: 2024-10-20T01:50:47.182Z (2 months ago)
Topics: data-pack, isbn, perl, perl-module
Language: Perl
Homepage: https://metacpan.org/pod/Business::ISBN::Data
Size: 1.52 MB
Stars: 3
Watchers: 4
Forks: 5
Open Issues: 0
Metadata Files:
- Readme: README.pod
- Changelog: Changes
- License: LICENSE

Awesome Lists containing this project

README

=pod

=encoding utf8

=for HTML

=head1 The Business::ISBN::Data module

This is the I for the L Perl module. You're probably
looking at this because you don't know where else to find what you're
looking for. Read this once and you might never have to read one again
for any Perl module.

=head2 Documentation

To read about L, look at the embedded documentation
in the module itself. Inside the distribution, you can format it
with L:

% perldoc lib/Business/ISBN/Data.pm

If you have already installed the module, you can specify the module
name instead of the file location:

% perldoc Business::ISBN::Data

You can read the documentation and inspect the meta data on
L.

The standard module documentation has example uses in the SYNOPSIS
section, but you can also look in the I directory (if it's
there), or look at the test files in I.

=head2 Installation

Usually you don't need to install this module on its own because
L will do it for you. You should always try this
first:

% cpan Business::ISBN

However, this module might update with the latest data even though
L did not change. In that case, you can install this
directly:

% cpan Business::ISBN::Data
% cpanm Business::ISBN::Data

You can also install directly from the distribution directory, which
will also install the dependencies:

% cpan .
% cpanm .

You could install just this module manually:

% perl Makefile.PL
% make
% make test
% make install

You probably don't want to do that unless you're fiddling with the
module and only want to run the tests without installing anything.

=head2 Source location

The meta data, such as the source repository and bug tracker, is in
I or the I files it creates. You can find that on
those CPAN web interfaces, but you can also look at files directly in
the source repository: L

If you find a problem, file a ticket in the L.

Starting with v20240716.001, Business::ISBN::Data now uses
L,
which allow you to verify that the archive file you have was made from
the official repo.

You need a GitHub account and the L.

# download the distro file from GitHub, MetaCPAN, or a CPAN mirror
$ gh auth login
...follow instructions...
$ gh attestation verify Business-ISBN-Data-20240716.001.tar.gz --owner briandfoy

=head2 Getting help

Although I'm happy to hear from module users in private email,
that's the best way for me to forget to do something.

Besides the issue trackers, you can find help at
L or
L, both of which have many
competent Perlers who can answer your question, almost in real time.
They might not know the particulars of this module, but they can help
you diagnose your problem.