1This is the Perl distribution Data-Object.
2
3Installing Data-Object is straightforward.
4
5## Installation with cpanm
6
7If you have cpanm, you only need one line:
8
9    % cpanm Data::Object
10
11If it does not have permission to install modules to the current perl, cpanm
12will automatically set up and install to a local::lib in your home directory.
13See the local::lib documentation (https://metacpan.org/pod/local::lib) for
14details on enabling it in your environment.
15
16## Installing with the CPAN shell
17
18Alternatively, if your CPAN shell is set up, you should just be able to do:
19
20    % cpan Data::Object
21
22## Manual installation
23
24As a last resort, you can manually install it. Download the tarball, untar it,
25install configure prerequisites (see below), then build it:
26
27    % perl Makefile.PL
28    % make && make test
29
30Then install it:
31
32    % make install
33
34On Windows platforms, you should use `dmake` or `nmake`, instead of `make`.
35
36If your perl is system-managed, you can create a local::lib in your home
37directory to install modules to. For details, see the local::lib documentation:
38https://metacpan.org/pod/local::lib
39
40The prerequisites of this distribution will also have to be installed manually. The
41prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated
42by running the manual build process described above.
43
44## Configure Prerequisites
45
46This distribution requires other modules to be installed before this
47distribution's installer can be run.  They can be found under the
48"configure_requires" key of META.yml or the
49"{prereqs}{configure}{requires}" key of META.json.
50
51## Other Prerequisites
52
53This distribution may require additional modules to be installed after running
54Makefile.PL.
55Look for prerequisites in the following phases:
56
57* to run make, PHASE = build
58* to use the module code itself, PHASE = runtime
59* to run tests, PHASE = test
60
61They can all be found in the "PHASE_requires" key of MYMETA.yml or the
62"{prereqs}{PHASE}{requires}" key of MYMETA.json.
63
64## Documentation
65
66Data-Object documentation is available as POD.
67You can run `perldoc` from a shell to read the documentation:
68
69    % perldoc Data::Object
70
71For more information on installing Perl modules via CPAN, please see:
72https://www.cpan.org/modules/INSTALL.html
73