Compare commits
1 Commits
Author | SHA1 | Date | |
---|---|---|---|
29534bc091 |
9
.gitignore
vendored
9
.gitignore
vendored
@ -1,9 +0,0 @@
|
|||||||
.test_info.*
|
|
||||||
lastlog.jsonl
|
|
||||||
*.bak
|
|
||||||
lab
|
|
||||||
.envrc
|
|
||||||
*.orig
|
|
||||||
*.tdy
|
|
||||||
*.ERR
|
|
||||||
Dancer2-Plugin-JsonApi-*
|
|
17
.travis.yml
17
.travis.yml
@ -1,17 +0,0 @@
|
|||||||
---
|
|
||||||
before_install:
|
|
||||||
- export HARNESS_OPTIONS=j10:c HARNESS_TIMER=1
|
|
||||||
- git config --global user.name "Dist Zilla Plugin TravisCI"
|
|
||||||
- git config --global user.email $HOSTNAME":not-for-mail@travis-ci.com"
|
|
||||||
install:
|
|
||||||
- cpanm --with-recommends --installdeps -n .
|
|
||||||
language: perl
|
|
||||||
matrix:
|
|
||||||
include:
|
|
||||||
- perl: '5.22'
|
|
||||||
- perl: '5.24'
|
|
||||||
- perl: '5.26'
|
|
||||||
- perl: '5.28'
|
|
||||||
- perl: '5.30'
|
|
||||||
script:
|
|
||||||
- prove -l t
|
|
13
Changes
13
Changes
@ -1,17 +1,4 @@
|
|||||||
Revision history for Dancer2-Plugin-JsonApi
|
Revision history for Dancer2-Plugin-JsonApi
|
||||||
|
|
||||||
{{$NEXT}}
|
|
||||||
[API CHANGES]
|
|
||||||
|
|
||||||
[BUG FIXES]
|
|
||||||
|
|
||||||
[DOCUMENTATION]
|
|
||||||
|
|
||||||
[ENHANCEMENTS]
|
|
||||||
|
|
||||||
[NEW FEATURES]
|
|
||||||
|
|
||||||
[STATISTICS]
|
|
||||||
|
|
||||||
0.0.1 2023-11-15
|
0.0.1 2023-11-15
|
||||||
- First release.
|
- First release.
|
75
INSTALL
Normal file
75
INSTALL
Normal file
@ -0,0 +1,75 @@
|
|||||||
|
This is the Perl distribution Dancer2-Plugin-JsonApi.
|
||||||
|
|
||||||
|
Installing Dancer2-Plugin-JsonApi is straightforward.
|
||||||
|
|
||||||
|
## Installation with cpanm
|
||||||
|
|
||||||
|
If you have cpanm, you only need one line:
|
||||||
|
|
||||||
|
% cpanm Dancer2::Plugin::JsonApi
|
||||||
|
|
||||||
|
If it does not have permission to install modules to the current perl, cpanm
|
||||||
|
will automatically set up and install to a local::lib in your home directory.
|
||||||
|
See the local::lib documentation (https://metacpan.org/pod/local::lib) for
|
||||||
|
details on enabling it in your environment.
|
||||||
|
|
||||||
|
## Installing with the CPAN shell
|
||||||
|
|
||||||
|
Alternatively, if your CPAN shell is set up, you should just be able to do:
|
||||||
|
|
||||||
|
% cpan Dancer2::Plugin::JsonApi
|
||||||
|
|
||||||
|
## Manual installation
|
||||||
|
|
||||||
|
As a last resort, you can manually install it. If you have not already
|
||||||
|
downloaded the release tarball, you can find the download link on the module's
|
||||||
|
MetaCPAN page: https://metacpan.org/pod/Dancer2::Plugin::JsonApi
|
||||||
|
|
||||||
|
Untar the tarball, install configure prerequisites (see below), then build it:
|
||||||
|
|
||||||
|
% perl Makefile.PL
|
||||||
|
% make && make test
|
||||||
|
|
||||||
|
Then install it:
|
||||||
|
|
||||||
|
% make install
|
||||||
|
|
||||||
|
On Windows platforms, you should use `dmake` or `nmake`, instead of `make`.
|
||||||
|
|
||||||
|
If your perl is system-managed, you can create a local::lib in your home
|
||||||
|
directory to install modules to. For details, see the local::lib documentation:
|
||||||
|
https://metacpan.org/pod/local::lib
|
||||||
|
|
||||||
|
The prerequisites of this distribution will also have to be installed manually. The
|
||||||
|
prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated
|
||||||
|
by running the manual build process described above.
|
||||||
|
|
||||||
|
## Configure Prerequisites
|
||||||
|
|
||||||
|
This distribution requires other modules to be installed before this
|
||||||
|
distribution's installer can be run. They can be found under the
|
||||||
|
"configure_requires" key of META.yml or the
|
||||||
|
"{prereqs}{configure}{requires}" key of META.json.
|
||||||
|
|
||||||
|
## Other Prerequisites
|
||||||
|
|
||||||
|
This distribution may require additional modules to be installed after running
|
||||||
|
Makefile.PL.
|
||||||
|
Look for prerequisites in the following phases:
|
||||||
|
|
||||||
|
* to run make, PHASE = build
|
||||||
|
* to use the module code itself, PHASE = runtime
|
||||||
|
* to run tests, PHASE = test
|
||||||
|
|
||||||
|
They can all be found in the "PHASE_requires" key of MYMETA.yml or the
|
||||||
|
"{prereqs}{PHASE}{requires}" key of MYMETA.json.
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
Dancer2-Plugin-JsonApi documentation is available as POD.
|
||||||
|
You can run `perldoc` from a shell to read the documentation:
|
||||||
|
|
||||||
|
% perldoc Dancer2::Plugin::JsonApi
|
||||||
|
|
||||||
|
For more information on installing Perl modules via CPAN, please see:
|
||||||
|
https://www.cpan.org/modules/INSTALL.html
|
412
LICENSE
Normal file
412
LICENSE
Normal file
@ -0,0 +1,412 @@
|
|||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
||||||
|
|
||||||
|
Terms of the Perl programming language system itself
|
||||||
|
|
||||||
|
a) the GNU General Public License as published by the Free
|
||||||
|
Software Foundation; either version 1, or (at your option) any
|
||||||
|
later version, or
|
||||||
|
b) the "Artistic License"
|
||||||
|
|
||||||
|
--- The GNU General Public License, Version 1, February 1989 ---
|
||||||
|
|
||||||
|
This software is Copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software, licensed under:
|
||||||
|
|
||||||
|
The GNU General Public License, Version 1, February 1989
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 1, February 1989
|
||||||
|
|
||||||
|
Copyright (C) 1989 Free Software Foundation, Inc.
|
||||||
|
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||||
|
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The license agreements of most software companies try to keep users
|
||||||
|
at the mercy of those companies. By contrast, our General Public
|
||||||
|
License is intended to guarantee your freedom to share and change free
|
||||||
|
software--to make sure the software is free for all its users. The
|
||||||
|
General Public License applies to the Free Software Foundation's
|
||||||
|
software and to any other program whose authors commit to using it.
|
||||||
|
You can use it for your programs, too.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom, not
|
||||||
|
price. Specifically, the General Public License is designed to make
|
||||||
|
sure that you have the freedom to give away or sell copies of free
|
||||||
|
software, that you receive source code or can get it if you want it,
|
||||||
|
that you can change the software or use pieces of it in new free
|
||||||
|
programs; and that you know you can do these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to make restrictions that forbid
|
||||||
|
anyone to deny you these rights or to ask you to surrender the rights.
|
||||||
|
These restrictions translate to certain responsibilities for you if you
|
||||||
|
distribute copies of the software, or if you modify it.
|
||||||
|
|
||||||
|
For example, if you distribute copies of a such a program, whether
|
||||||
|
gratis or for a fee, you must give the recipients all the rights that
|
||||||
|
you have. You must make sure that they, too, receive or can get the
|
||||||
|
source code. And you must tell them their rights.
|
||||||
|
|
||||||
|
We protect your rights with two steps: (1) copyright the software, and
|
||||||
|
(2) offer you this license which gives you legal permission to copy,
|
||||||
|
distribute and/or modify the software.
|
||||||
|
|
||||||
|
Also, for each author's protection and ours, we want to make certain
|
||||||
|
that everyone understands that there is no warranty for this free
|
||||||
|
software. If the software is modified by someone else and passed on, we
|
||||||
|
want its recipients to know that what they have is not the original, so
|
||||||
|
that any problems introduced by others will not reflect on the original
|
||||||
|
authors' reputations.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||||
|
|
||||||
|
0. This License Agreement applies to any program or other work which
|
||||||
|
contains a notice placed by the copyright holder saying it may be
|
||||||
|
distributed under the terms of this General Public License. The
|
||||||
|
"Program", below, refers to any such program or work, and a "work based
|
||||||
|
on the Program" means either the Program or any work containing the
|
||||||
|
Program or a portion of it, either verbatim or with modifications. Each
|
||||||
|
licensee is addressed as "you".
|
||||||
|
|
||||||
|
1. You may copy and distribute verbatim copies of the Program's source
|
||||||
|
code as you receive it, in any medium, provided that you conspicuously and
|
||||||
|
appropriately publish on each copy an appropriate copyright notice and
|
||||||
|
disclaimer of warranty; keep intact all the notices that refer to this
|
||||||
|
General Public License and to the absence of any warranty; and give any
|
||||||
|
other recipients of the Program a copy of this General Public License
|
||||||
|
along with the Program. You may charge a fee for the physical act of
|
||||||
|
transferring a copy.
|
||||||
|
|
||||||
|
2. You may modify your copy or copies of the Program or any portion of
|
||||||
|
it, and copy and distribute such modifications under the terms of Paragraph
|
||||||
|
1 above, provided that you also do the following:
|
||||||
|
|
||||||
|
a) cause the modified files to carry prominent notices stating that
|
||||||
|
you changed the files and the date of any change; and
|
||||||
|
|
||||||
|
b) cause the whole of any work that you distribute or publish, that
|
||||||
|
in whole or in part contains the Program or any part thereof, either
|
||||||
|
with or without modifications, to be licensed at no charge to all
|
||||||
|
third parties under the terms of this General Public License (except
|
||||||
|
that you may choose to grant warranty protection to some or all
|
||||||
|
third parties, at your option).
|
||||||
|
|
||||||
|
c) If the modified program normally reads commands interactively when
|
||||||
|
run, you must cause it, when started running for such interactive use
|
||||||
|
in the simplest and most usual way, to print or display an
|
||||||
|
announcement including an appropriate copyright notice and a notice
|
||||||
|
that there is no warranty (or else, saying that you provide a
|
||||||
|
warranty) and that users may redistribute the program under these
|
||||||
|
conditions, and telling the user how to view a copy of this General
|
||||||
|
Public License.
|
||||||
|
|
||||||
|
d) You may charge a fee for the physical act of transferring a
|
||||||
|
copy, and you may at your option offer warranty protection in
|
||||||
|
exchange for a fee.
|
||||||
|
|
||||||
|
Mere aggregation of another independent work with the Program (or its
|
||||||
|
derivative) on a volume of a storage or distribution medium does not bring
|
||||||
|
the other work under the scope of these terms.
|
||||||
|
|
||||||
|
3. You may copy and distribute the Program (or a portion or derivative of
|
||||||
|
it, under Paragraph 2) in object code or executable form under the terms of
|
||||||
|
Paragraphs 1 and 2 above provided that you also do one of the following:
|
||||||
|
|
||||||
|
a) accompany it with the complete corresponding machine-readable
|
||||||
|
source code, which must be distributed under the terms of
|
||||||
|
Paragraphs 1 and 2 above; or,
|
||||||
|
|
||||||
|
b) accompany it with a written offer, valid for at least three
|
||||||
|
years, to give any third party free (except for a nominal charge
|
||||||
|
for the cost of distribution) a complete machine-readable copy of the
|
||||||
|
corresponding source code, to be distributed under the terms of
|
||||||
|
Paragraphs 1 and 2 above; or,
|
||||||
|
|
||||||
|
c) accompany it with the information you received as to where the
|
||||||
|
corresponding source code may be obtained. (This alternative is
|
||||||
|
allowed only for noncommercial distribution and only if you
|
||||||
|
received the program in object code or executable form alone.)
|
||||||
|
|
||||||
|
Source code for a work means the preferred form of the work for making
|
||||||
|
modifications to it. For an executable file, complete source code means
|
||||||
|
all the source code for all modules it contains; but, as a special
|
||||||
|
exception, it need not include source code for modules which are standard
|
||||||
|
libraries that accompany the operating system on which the executable
|
||||||
|
file runs, or for standard header files or definitions files that
|
||||||
|
accompany that operating system.
|
||||||
|
|
||||||
|
4. You may not copy, modify, sublicense, distribute or transfer the
|
||||||
|
Program except as expressly provided under this General Public License.
|
||||||
|
Any attempt otherwise to copy, modify, sublicense, distribute or transfer
|
||||||
|
the Program is void, and will automatically terminate your rights to use
|
||||||
|
the Program under this License. However, parties who have received
|
||||||
|
copies, or rights to use copies, from you under this General Public
|
||||||
|
License will not have their licenses terminated so long as such parties
|
||||||
|
remain in full compliance.
|
||||||
|
|
||||||
|
5. By copying, distributing or modifying the Program (or any work based
|
||||||
|
on the Program) you indicate your acceptance of this license to do so,
|
||||||
|
and all its terms and conditions.
|
||||||
|
|
||||||
|
6. Each time you redistribute the Program (or any work based on the
|
||||||
|
Program), the recipient automatically receives a license from the original
|
||||||
|
licensor to copy, distribute or modify the Program subject to these
|
||||||
|
terms and conditions. You may not impose any further restrictions on the
|
||||||
|
recipients' exercise of the rights granted herein.
|
||||||
|
|
||||||
|
7. The Free Software Foundation may publish revised and/or new versions
|
||||||
|
of the General Public License from time to time. Such new versions will
|
||||||
|
be similar in spirit to the present version, but may differ in detail to
|
||||||
|
address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the Program
|
||||||
|
specifies a version number of the license which applies to it and "any
|
||||||
|
later version", you have the option of following the terms and conditions
|
||||||
|
either of that version or of any later version published by the Free
|
||||||
|
Software Foundation. If the Program does not specify a version number of
|
||||||
|
the license, you may choose any version ever published by the Free Software
|
||||||
|
Foundation.
|
||||||
|
|
||||||
|
8. If you wish to incorporate parts of the Program into other free
|
||||||
|
programs whose distribution conditions are different, write to the author
|
||||||
|
to ask for permission. For software which is copyrighted by the Free
|
||||||
|
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||||
|
make exceptions for this. Our decision will be guided by the two goals
|
||||||
|
of preserving the free status of all derivatives of our free software and
|
||||||
|
of promoting the sharing and reuse of software generally.
|
||||||
|
|
||||||
|
NO WARRANTY
|
||||||
|
|
||||||
|
9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||||
|
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||||
|
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||||
|
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||||
|
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||||
|
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||||
|
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||||
|
REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||||
|
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||||
|
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||||
|
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||||
|
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||||
|
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||||
|
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||||
|
POSSIBILITY OF SUCH DAMAGES.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
Appendix: How to Apply These Terms to Your New Programs
|
||||||
|
|
||||||
|
If you develop a new program, and you want it to be of the greatest
|
||||||
|
possible use to humanity, the best way to achieve this is to make it
|
||||||
|
free software which everyone can redistribute and change under these
|
||||||
|
terms.
|
||||||
|
|
||||||
|
To do so, attach the following notices to the program. It is safest to
|
||||||
|
attach them to the start of each source file to most effectively convey
|
||||||
|
the exclusion of warranty; and each file should have at least the
|
||||||
|
"copyright" line and a pointer to where the full notice is found.
|
||||||
|
|
||||||
|
<one line to give the program's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) 19yy <name of author>
|
||||||
|
|
||||||
|
This program is free software; you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation; either version 1, or (at your option)
|
||||||
|
any later version.
|
||||||
|
|
||||||
|
This program is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU General Public License
|
||||||
|
along with this program; if not, write to the Free Software
|
||||||
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301 USA
|
||||||
|
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
If the program is interactive, make it output a short notice like this
|
||||||
|
when it starts in an interactive mode:
|
||||||
|
|
||||||
|
Gnomovision version 69, Copyright (C) 19xx name of author
|
||||||
|
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||||
|
This is free software, and you are welcome to redistribute it
|
||||||
|
under certain conditions; type `show c' for details.
|
||||||
|
|
||||||
|
The hypothetical commands `show w' and `show c' should show the
|
||||||
|
appropriate parts of the General Public License. Of course, the
|
||||||
|
commands you use may be called something other than `show w' and `show
|
||||||
|
c'; they could even be mouse-clicks or menu items--whatever suits your
|
||||||
|
program.
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or your
|
||||||
|
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||||
|
necessary. Here a sample; alter the names:
|
||||||
|
|
||||||
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the
|
||||||
|
program `Gnomovision' (a program to direct compilers to make passes
|
||||||
|
at assemblers) written by James Hacker.
|
||||||
|
|
||||||
|
<signature of Ty Coon>, 1 April 1989
|
||||||
|
Ty Coon, President of Vice
|
||||||
|
|
||||||
|
That's all there is to it!
|
||||||
|
|
||||||
|
|
||||||
|
--- The Perl Artistic License 1.0 ---
|
||||||
|
|
||||||
|
This software is Copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software, licensed under:
|
||||||
|
|
||||||
|
The Perl Artistic License 1.0
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
The "Artistic License"
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The intent of this document is to state the conditions under which a
|
||||||
|
Package may be copied, such that the Copyright Holder maintains some
|
||||||
|
semblance of artistic control over the development of the package,
|
||||||
|
while giving the users of the package the right to use and distribute
|
||||||
|
the Package in a more-or-less customary fashion, plus the right to make
|
||||||
|
reasonable modifications.
|
||||||
|
|
||||||
|
Definitions:
|
||||||
|
|
||||||
|
"Package" refers to the collection of files distributed by the
|
||||||
|
Copyright Holder, and derivatives of that collection of files
|
||||||
|
created through textual modification.
|
||||||
|
|
||||||
|
"Standard Version" refers to such a Package if it has not been
|
||||||
|
modified, or has been modified in accordance with the wishes
|
||||||
|
of the Copyright Holder as specified below.
|
||||||
|
|
||||||
|
"Copyright Holder" is whoever is named in the copyright or
|
||||||
|
copyrights for the package.
|
||||||
|
|
||||||
|
"You" is you, if you're thinking about copying or distributing
|
||||||
|
this Package.
|
||||||
|
|
||||||
|
"Reasonable copying fee" is whatever you can justify on the
|
||||||
|
basis of media cost, duplication charges, time of people involved,
|
||||||
|
and so on. (You will not be required to justify it to the
|
||||||
|
Copyright Holder, but only to the computing community at large
|
||||||
|
as a market that must bear the fee.)
|
||||||
|
|
||||||
|
"Freely Available" means that no fee is charged for the item
|
||||||
|
itself, though there may be fees involved in handling the item.
|
||||||
|
It also means that recipients of the item may redistribute it
|
||||||
|
under the same conditions they received it.
|
||||||
|
|
||||||
|
1. You may make and give away verbatim copies of the source form of the
|
||||||
|
Standard Version of this Package without restriction, provided that you
|
||||||
|
duplicate all of the original copyright notices and associated disclaimers.
|
||||||
|
|
||||||
|
2. You may apply bug fixes, portability fixes and other modifications
|
||||||
|
derived from the Public Domain or from the Copyright Holder. A Package
|
||||||
|
modified in such a way shall still be considered the Standard Version.
|
||||||
|
|
||||||
|
3. You may otherwise modify your copy of this Package in any way, provided
|
||||||
|
that you insert a prominent notice in each changed file stating how and
|
||||||
|
when you changed that file, and provided that you do at least ONE of the
|
||||||
|
following:
|
||||||
|
|
||||||
|
a) place your modifications in the Public Domain or otherwise make them
|
||||||
|
Freely Available, such as by posting said modifications to Usenet or
|
||||||
|
an equivalent medium, or placing the modifications on a major archive
|
||||||
|
site such as uunet.uu.net, or by allowing the Copyright Holder to include
|
||||||
|
your modifications in the Standard Version of the Package.
|
||||||
|
|
||||||
|
b) use the modified Package only within your corporation or organization.
|
||||||
|
|
||||||
|
c) rename any non-standard executables so the names do not conflict
|
||||||
|
with standard executables, which must also be provided, and provide
|
||||||
|
a separate manual page for each non-standard executable that clearly
|
||||||
|
documents how it differs from the Standard Version.
|
||||||
|
|
||||||
|
d) make other distribution arrangements with the Copyright Holder.
|
||||||
|
|
||||||
|
4. You may distribute the programs of this Package in object code or
|
||||||
|
executable form, provided that you do at least ONE of the following:
|
||||||
|
|
||||||
|
a) distribute a Standard Version of the executables and library files,
|
||||||
|
together with instructions (in the manual page or equivalent) on where
|
||||||
|
to get the Standard Version.
|
||||||
|
|
||||||
|
b) accompany the distribution with the machine-readable source of
|
||||||
|
the Package with your modifications.
|
||||||
|
|
||||||
|
c) give non-standard executables non-standard names, and clearly
|
||||||
|
document the differences in manual pages (or equivalent), together
|
||||||
|
with instructions on where to get the Standard Version.
|
||||||
|
|
||||||
|
d) make other distribution arrangements with the Copyright Holder.
|
||||||
|
|
||||||
|
5. You may charge a reasonable copying fee for any distribution of this
|
||||||
|
Package. You may charge any fee you choose for support of this
|
||||||
|
Package. You may not charge a fee for this Package itself. However,
|
||||||
|
you may distribute this Package in aggregate with other (possibly
|
||||||
|
commercial) programs as part of a larger (possibly commercial) software
|
||||||
|
distribution provided that you do not advertise this Package as a
|
||||||
|
product of your own. You may embed this Package's interpreter within
|
||||||
|
an executable of yours (by linking); this shall be construed as a mere
|
||||||
|
form of aggregation, provided that the complete Standard Version of the
|
||||||
|
interpreter is so embedded.
|
||||||
|
|
||||||
|
6. The scripts and library files supplied as input to or produced as
|
||||||
|
output from the programs of this Package do not automatically fall
|
||||||
|
under the copyright of this Package, but belong to whoever generated
|
||||||
|
them, and may be sold commercially, and may be aggregated with this
|
||||||
|
Package. If such scripts or library files are aggregated with this
|
||||||
|
Package via the so-called "undump" or "unexec" methods of producing a
|
||||||
|
binary executable image, then distribution of such an image shall
|
||||||
|
neither be construed as a distribution of this Package nor shall it
|
||||||
|
fall under the restrictions of Paragraphs 3 and 4, provided that you do
|
||||||
|
not represent such an executable image as a Standard Version of this
|
||||||
|
Package.
|
||||||
|
|
||||||
|
7. C subroutines (or comparably compiled subroutines in other
|
||||||
|
languages) supplied by you and linked into this Package in order to
|
||||||
|
emulate subroutines and variables of the language defined by this
|
||||||
|
Package shall not be considered part of this Package, but are the
|
||||||
|
equivalent of input as in Paragraph 6, provided these subroutines do
|
||||||
|
not change the language in any way that would cause it to fail the
|
||||||
|
regression tests for the language.
|
||||||
|
|
||||||
|
8. Aggregation of this Package with a commercial distribution is always
|
||||||
|
permitted provided that the use of this Package is embedded; that is,
|
||||||
|
when no overt attempt is made to make this Package's interfaces visible
|
||||||
|
to the end user of the commercial distribution. Such use shall not be
|
||||||
|
construed as a distribution of this Package.
|
||||||
|
|
||||||
|
9. The name of the Copyright Holder may not be used to endorse or promote
|
||||||
|
products derived from this software without specific prior written permission.
|
||||||
|
|
||||||
|
10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
|
||||||
|
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
|
||||||
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
||||||
|
|
||||||
|
The End
|
||||||
|
|
95
META.json
Normal file
95
META.json
Normal file
@ -0,0 +1,95 @@
|
|||||||
|
{
|
||||||
|
"abstract" : "JsonApi helpers for Dancer2 apps",
|
||||||
|
"author" : [
|
||||||
|
"Yanick Champoux <yanick@babyl.ca>"
|
||||||
|
],
|
||||||
|
"dynamic_config" : 0,
|
||||||
|
"generated_by" : "Dist::Zilla version 6.030, CPAN::Meta::Converter version 2.150010",
|
||||||
|
"license" : [
|
||||||
|
"perl_5"
|
||||||
|
],
|
||||||
|
"meta-spec" : {
|
||||||
|
"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
|
||||||
|
"version" : 2
|
||||||
|
},
|
||||||
|
"name" : "Dancer2-Plugin-JsonApi",
|
||||||
|
"prereqs" : {
|
||||||
|
"configure" : {
|
||||||
|
"requires" : {
|
||||||
|
"ExtUtils::MakeMaker" : "0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"develop" : {
|
||||||
|
"requires" : {
|
||||||
|
"Git::Wrapper" : "0",
|
||||||
|
"Test2::V0" : "0",
|
||||||
|
"Test::More" : "0.96",
|
||||||
|
"Test::PerlTidy" : "0",
|
||||||
|
"Test::Vars" : "0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"runtime" : {
|
||||||
|
"requires" : {
|
||||||
|
"Carp" : "0",
|
||||||
|
"Dancer2::Core::Role::Serializer" : "0",
|
||||||
|
"Dancer2::Plugin" : "0",
|
||||||
|
"Dancer2::Serializer::JSON" : "0",
|
||||||
|
"List::AllUtils" : "0",
|
||||||
|
"Moo" : "0",
|
||||||
|
"Set::Object" : "0",
|
||||||
|
"experimental" : "0",
|
||||||
|
"perl" : "v5.38.0"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"test" : {
|
||||||
|
"recommends" : {
|
||||||
|
"CPAN::Meta" : "2.120900"
|
||||||
|
},
|
||||||
|
"requires" : {
|
||||||
|
"Clone" : "0",
|
||||||
|
"Dancer2" : "0",
|
||||||
|
"ExtUtils::MakeMaker" : "0",
|
||||||
|
"File::Spec" : "0",
|
||||||
|
"IO::Handle" : "0",
|
||||||
|
"IPC::Open3" : "0",
|
||||||
|
"JSON" : "0",
|
||||||
|
"Test2::Plugin::ExitSummary" : "0",
|
||||||
|
"Test2::V0" : "0",
|
||||||
|
"Test::More" : "0",
|
||||||
|
"strict" : "0",
|
||||||
|
"warnings" : "0"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"provides" : {
|
||||||
|
"Dancer2::Plugin::JsonApi" : {
|
||||||
|
"file" : "lib/Dancer2/Plugin/JsonApi.pm",
|
||||||
|
"version" : "v0.0.1"
|
||||||
|
},
|
||||||
|
"Dancer2::Plugin::JsonApi::Registry" : {
|
||||||
|
"file" : "lib/Dancer2/Plugin/JsonApi/Registry.pm",
|
||||||
|
"version" : "v0.0.1"
|
||||||
|
},
|
||||||
|
"Dancer2::Plugin::JsonApi::Schema" : {
|
||||||
|
"file" : "lib/Dancer2/Plugin/JsonApi/Schema.pm",
|
||||||
|
"version" : "v0.0.1"
|
||||||
|
},
|
||||||
|
"Dancer2::Serializer::JsonApi" : {
|
||||||
|
"file" : "lib/Dancer2/Serializer/JsonApi.pm",
|
||||||
|
"version" : "v0.0.1"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"release_status" : "stable",
|
||||||
|
"version" : "0.0.1",
|
||||||
|
"x_author_pledge" : {
|
||||||
|
"version" : 1
|
||||||
|
},
|
||||||
|
"x_authority" : "cpan:YANICK",
|
||||||
|
"x_contributor_covenant" : {
|
||||||
|
"version" : 0.02
|
||||||
|
},
|
||||||
|
"x_generated_by_perl" : "v5.38.0",
|
||||||
|
"x_serialization_backend" : "Cpanel::JSON::XS version 4.37",
|
||||||
|
"x_spdx_expression" : "Artistic-1.0-Perl OR GPL-1.0-or-later"
|
||||||
|
}
|
||||||
|
|
58
META.yml
Normal file
58
META.yml
Normal file
@ -0,0 +1,58 @@
|
|||||||
|
---
|
||||||
|
abstract: 'JsonApi helpers for Dancer2 apps'
|
||||||
|
author:
|
||||||
|
- 'Yanick Champoux <yanick@babyl.ca>'
|
||||||
|
build_requires:
|
||||||
|
Clone: '0'
|
||||||
|
Dancer2: '0'
|
||||||
|
ExtUtils::MakeMaker: '0'
|
||||||
|
File::Spec: '0'
|
||||||
|
IO::Handle: '0'
|
||||||
|
IPC::Open3: '0'
|
||||||
|
JSON: '0'
|
||||||
|
Test2::Plugin::ExitSummary: '0'
|
||||||
|
Test2::V0: '0'
|
||||||
|
Test::More: '0'
|
||||||
|
strict: '0'
|
||||||
|
warnings: '0'
|
||||||
|
configure_requires:
|
||||||
|
ExtUtils::MakeMaker: '0'
|
||||||
|
dynamic_config: 0
|
||||||
|
generated_by: 'Dist::Zilla version 6.030, CPAN::Meta::Converter version 2.150010'
|
||||||
|
license: perl
|
||||||
|
meta-spec:
|
||||||
|
url: http://module-build.sourceforge.net/META-spec-v1.4.html
|
||||||
|
version: '1.4'
|
||||||
|
name: Dancer2-Plugin-JsonApi
|
||||||
|
provides:
|
||||||
|
Dancer2::Plugin::JsonApi:
|
||||||
|
file: lib/Dancer2/Plugin/JsonApi.pm
|
||||||
|
version: v0.0.1
|
||||||
|
Dancer2::Plugin::JsonApi::Registry:
|
||||||
|
file: lib/Dancer2/Plugin/JsonApi/Registry.pm
|
||||||
|
version: v0.0.1
|
||||||
|
Dancer2::Plugin::JsonApi::Schema:
|
||||||
|
file: lib/Dancer2/Plugin/JsonApi/Schema.pm
|
||||||
|
version: v0.0.1
|
||||||
|
Dancer2::Serializer::JsonApi:
|
||||||
|
file: lib/Dancer2/Serializer/JsonApi.pm
|
||||||
|
version: v0.0.1
|
||||||
|
requires:
|
||||||
|
Carp: '0'
|
||||||
|
Dancer2::Core::Role::Serializer: '0'
|
||||||
|
Dancer2::Plugin: '0'
|
||||||
|
Dancer2::Serializer::JSON: '0'
|
||||||
|
List::AllUtils: '0'
|
||||||
|
Moo: '0'
|
||||||
|
Set::Object: '0'
|
||||||
|
experimental: '0'
|
||||||
|
perl: v5.38.0
|
||||||
|
version: 0.0.1
|
||||||
|
x_author_pledge:
|
||||||
|
version: 1
|
||||||
|
x_authority: cpan:YANICK
|
||||||
|
x_contributor_covenant:
|
||||||
|
version: 0.02
|
||||||
|
x_generated_by_perl: v5.38.0
|
||||||
|
x_serialization_backend: 'YAML::Tiny version 1.74'
|
||||||
|
x_spdx_expression: 'Artistic-1.0-Perl OR GPL-1.0-or-later'
|
83
Makefile.PL
Normal file
83
Makefile.PL
Normal file
@ -0,0 +1,83 @@
|
|||||||
|
# This file was automatically generated by Dist::Zilla::Plugin::MakeMaker v6.030.
|
||||||
|
use strict;
|
||||||
|
use warnings;
|
||||||
|
|
||||||
|
use 5.038000;
|
||||||
|
|
||||||
|
use ExtUtils::MakeMaker;
|
||||||
|
|
||||||
|
my %WriteMakefileArgs = (
|
||||||
|
"ABSTRACT" => "JsonApi helpers for Dancer2 apps",
|
||||||
|
"AUTHOR" => "Yanick Champoux <yanick\@babyl.ca>",
|
||||||
|
"CONFIGURE_REQUIRES" => {
|
||||||
|
"ExtUtils::MakeMaker" => 0
|
||||||
|
},
|
||||||
|
"DISTNAME" => "Dancer2-Plugin-JsonApi",
|
||||||
|
"LICENSE" => "perl",
|
||||||
|
"MIN_PERL_VERSION" => "5.038000",
|
||||||
|
"NAME" => "Dancer2::Plugin::JsonApi",
|
||||||
|
"PREREQ_PM" => {
|
||||||
|
"Carp" => 0,
|
||||||
|
"Dancer2::Core::Role::Serializer" => 0,
|
||||||
|
"Dancer2::Plugin" => 0,
|
||||||
|
"Dancer2::Serializer::JSON" => 0,
|
||||||
|
"List::AllUtils" => 0,
|
||||||
|
"Moo" => 0,
|
||||||
|
"Set::Object" => 0,
|
||||||
|
"experimental" => 0
|
||||||
|
},
|
||||||
|
"TEST_REQUIRES" => {
|
||||||
|
"Clone" => 0,
|
||||||
|
"Dancer2" => 0,
|
||||||
|
"ExtUtils::MakeMaker" => 0,
|
||||||
|
"File::Spec" => 0,
|
||||||
|
"IO::Handle" => 0,
|
||||||
|
"IPC::Open3" => 0,
|
||||||
|
"JSON" => 0,
|
||||||
|
"Test2::Plugin::ExitSummary" => 0,
|
||||||
|
"Test2::V0" => 0,
|
||||||
|
"Test::More" => 0,
|
||||||
|
"strict" => 0,
|
||||||
|
"warnings" => 0
|
||||||
|
},
|
||||||
|
"VERSION" => "0.0.1",
|
||||||
|
"test" => {
|
||||||
|
"TESTS" => "t/*.t"
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
|
my %FallbackPrereqs = (
|
||||||
|
"Carp" => 0,
|
||||||
|
"Clone" => 0,
|
||||||
|
"Dancer2" => 0,
|
||||||
|
"Dancer2::Core::Role::Serializer" => 0,
|
||||||
|
"Dancer2::Plugin" => 0,
|
||||||
|
"Dancer2::Serializer::JSON" => 0,
|
||||||
|
"ExtUtils::MakeMaker" => 0,
|
||||||
|
"File::Spec" => 0,
|
||||||
|
"IO::Handle" => 0,
|
||||||
|
"IPC::Open3" => 0,
|
||||||
|
"JSON" => 0,
|
||||||
|
"List::AllUtils" => 0,
|
||||||
|
"Moo" => 0,
|
||||||
|
"Set::Object" => 0,
|
||||||
|
"Test2::Plugin::ExitSummary" => 0,
|
||||||
|
"Test2::V0" => 0,
|
||||||
|
"Test::More" => 0,
|
||||||
|
"experimental" => 0,
|
||||||
|
"strict" => 0,
|
||||||
|
"warnings" => 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);
|
31
README.mkdn
Normal file
31
README.mkdn
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
# NAME
|
||||||
|
|
||||||
|
Dancer2::Plugin::JsonApi - JsonApi helpers for Dancer2 apps
|
||||||
|
|
||||||
|
# VERSION
|
||||||
|
|
||||||
|
version 0.0.1
|
||||||
|
|
||||||
|
# NAME
|
||||||
|
|
||||||
|
Dancer2::Plugin::JsonAPI
|
||||||
|
|
||||||
|
## DESCRIPTION
|
||||||
|
|
||||||
|
If the serializer is not already explicitly set, the plugin will configure it to be [Dancer2::Serializer::JsonApi](https://metacpan.org/pod/Dancer2%3A%3ASerializer%3A%3AJsonApi).
|
||||||
|
|
||||||
|
## SEE ALSO
|
||||||
|
|
||||||
|
- The [JSON:API](https://jsonapi.org) specs, natch.
|
||||||
|
- [json-api-serializer](https://www.npmjs.com/package/json-api-serializer) My go to for serializing JSON API documents in JavaScript-land. Also, inspiration for this module.
|
||||||
|
|
||||||
|
# AUTHOR
|
||||||
|
|
||||||
|
Yanick Champoux <yanick@babyl.ca> [![endorse](http://api.coderwall.com/yanick/endorsecount.png)](http://coderwall.com/yanick)
|
||||||
|
|
||||||
|
# COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
19
doap.xml
Normal file
19
doap.xml
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8" ?>
|
||||||
|
<Project
|
||||||
|
xmlns="http://usefulinc.com/ns/doap#"
|
||||||
|
xmlns:dc="http://purl.org/dc/terms/"
|
||||||
|
xmlns:foaf="http://xmlns.com/foaf/0.1/"
|
||||||
|
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
||||||
|
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
|
||||||
|
>
|
||||||
|
<name>Dancer2-Plugin-JsonApi</name>
|
||||||
|
<shortdesc>JsonApi helpers for Dancer2 apps</shortdesc>
|
||||||
|
<developer>
|
||||||
|
<foaf:Person>
|
||||||
|
<foaf:name>Yanick Champoux</foaf:name>
|
||||||
|
<foaf:mbox rdf:resource="mailto:yanick@babyl.ca" />
|
||||||
|
</foaf:Person>
|
||||||
|
</developer>
|
||||||
|
<license rdf:resource="http://dev.perl.org/licenses/" />
|
||||||
|
<programming-language>Perl</programming-language>
|
||||||
|
</Project>
|
@ -3,7 +3,8 @@
|
|||||||
use 5.38.0;
|
use 5.38.0;
|
||||||
|
|
||||||
package Dancer2::Plugin::JsonApi;
|
package Dancer2::Plugin::JsonApi;
|
||||||
|
our $AUTHORITY = 'cpan:YANICK';
|
||||||
|
$Dancer2::Plugin::JsonApi::VERSION = '0.0.1';
|
||||||
use Dancer2::Plugin::JsonApi::Registry;
|
use Dancer2::Plugin::JsonApi::Registry;
|
||||||
use Dancer2::Plugin;
|
use Dancer2::Plugin;
|
||||||
use Dancer2::Serializer::JsonApi;
|
use Dancer2::Serializer::JsonApi;
|
||||||
@ -50,6 +51,18 @@ sub BUILD ( $self, @ ) {
|
|||||||
|
|
||||||
__END__
|
__END__
|
||||||
|
|
||||||
|
=pod
|
||||||
|
|
||||||
|
=encoding UTF-8
|
||||||
|
|
||||||
|
=head1 NAME
|
||||||
|
|
||||||
|
Dancer2::Plugin::JsonApi - JsonApi helpers for Dancer2 apps
|
||||||
|
|
||||||
|
=head1 VERSION
|
||||||
|
|
||||||
|
version 0.0.1
|
||||||
|
|
||||||
=head1 NAME
|
=head1 NAME
|
||||||
|
|
||||||
Dancer2::Plugin::JsonAPI
|
Dancer2::Plugin::JsonAPI
|
||||||
@ -68,3 +81,15 @@ If the serializer is not already explicitly set, the plugin will configure it to
|
|||||||
|
|
||||||
=back
|
=back
|
||||||
|
|
||||||
|
=head1 AUTHOR
|
||||||
|
|
||||||
|
Yanick Champoux <yanick@babyl.ca>
|
||||||
|
|
||||||
|
=head1 COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
||||||
|
|
||||||
|
=cut
|
@ -1,5 +1,6 @@
|
|||||||
package Dancer2::Plugin::JsonApi::Registry;
|
package Dancer2::Plugin::JsonApi::Registry;
|
||||||
|
our $AUTHORITY = 'cpan:YANICK';
|
||||||
|
$Dancer2::Plugin::JsonApi::Registry::VERSION = '0.0.1';
|
||||||
use 5.32.0;
|
use 5.32.0;
|
||||||
use Dancer2::Plugin::JsonApi::Schema;
|
use Dancer2::Plugin::JsonApi::Schema;
|
||||||
|
|
||||||
@ -46,3 +47,47 @@ sub type ( $self, $type ) {
|
|||||||
1;
|
1;
|
||||||
|
|
||||||
__END__
|
__END__
|
||||||
|
|
||||||
|
=pod
|
||||||
|
|
||||||
|
=encoding UTF-8
|
||||||
|
|
||||||
|
=head1 NAME
|
||||||
|
|
||||||
|
Dancer2::Plugin::JsonApi::Registry
|
||||||
|
|
||||||
|
=head1 VERSION
|
||||||
|
|
||||||
|
version 0.0.1
|
||||||
|
|
||||||
|
=head1 DESCRIPTION
|
||||||
|
|
||||||
|
The registry for the different types of data managed by the plugin.
|
||||||
|
|
||||||
|
=head1 METHODS
|
||||||
|
|
||||||
|
=head2 add_type($type, $definition = {})
|
||||||
|
|
||||||
|
Adds a data type to the registry.
|
||||||
|
|
||||||
|
=head2 type($type)
|
||||||
|
|
||||||
|
Returns the type's C<Dancer2::Plugin::JsonApi::Schema>. Throws an
|
||||||
|
error if the type does not exist.
|
||||||
|
|
||||||
|
=head2 serialize($type,$data,$extra_data={})
|
||||||
|
|
||||||
|
Returns the serialized form of C<$data>.
|
||||||
|
|
||||||
|
=head1 AUTHOR
|
||||||
|
|
||||||
|
Yanick Champoux <yanick@babyl.ca>
|
||||||
|
|
||||||
|
=head1 COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
||||||
|
|
||||||
|
=cut
|
@ -1,23 +0,0 @@
|
|||||||
|
|
||||||
=head1 DESCRIPTION
|
|
||||||
|
|
||||||
The registry for the different types of data managed by the plugin.
|
|
||||||
|
|
||||||
=head1 METHODS
|
|
||||||
|
|
||||||
=head2 add_type($type, $definition = {})
|
|
||||||
|
|
||||||
Adds a data type to the registry.
|
|
||||||
|
|
||||||
=head2 type($type)
|
|
||||||
|
|
||||||
Returns the type's C<Dancer2::Plugin::JsonApi::Schema>. Throws an
|
|
||||||
error if the type does not exist.
|
|
||||||
|
|
||||||
=cut
|
|
||||||
|
|
||||||
=head2 serialize($type,$data,$extra_data={})
|
|
||||||
|
|
||||||
Returns the serialized form of C<$data>.
|
|
||||||
|
|
||||||
=cut
|
|
@ -1,7 +1,8 @@
|
|||||||
use 5.32.0;
|
use 5.32.0;
|
||||||
|
|
||||||
package Dancer2::Plugin::JsonApi::Schema;
|
package Dancer2::Plugin::JsonApi::Schema;
|
||||||
|
our $AUTHORITY = 'cpan:YANICK';
|
||||||
|
$Dancer2::Plugin::JsonApi::Schema::VERSION = '0.0.1';
|
||||||
use Moo;
|
use Moo;
|
||||||
|
|
||||||
use experimental qw/ signatures /;
|
use experimental qw/ signatures /;
|
||||||
@ -221,3 +222,94 @@ sub deserialize_data ( $self, $data, $included ) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
1;
|
1;
|
||||||
|
|
||||||
|
__END__
|
||||||
|
|
||||||
|
=pod
|
||||||
|
|
||||||
|
=encoding UTF-8
|
||||||
|
|
||||||
|
=head1 NAME
|
||||||
|
|
||||||
|
Dancer2::Plugin::JsonApi::Schema
|
||||||
|
|
||||||
|
=head1 VERSION
|
||||||
|
|
||||||
|
version 0.0.1
|
||||||
|
|
||||||
|
=head1 DESCRIPTION
|
||||||
|
|
||||||
|
Defines a type of object to serialize/deserialize from/to the
|
||||||
|
JSON:API format.
|
||||||
|
|
||||||
|
=head1 ATTRIBUTES
|
||||||
|
|
||||||
|
=head2 registry
|
||||||
|
|
||||||
|
L<Dancer2::Plugin::JsonApi::Registry> to use to find the definition of
|
||||||
|
other object types.
|
||||||
|
|
||||||
|
=head2 before_serialize
|
||||||
|
|
||||||
|
Accepts a function, which will be called on the original C<$data> to serialize
|
||||||
|
to groom it.
|
||||||
|
|
||||||
|
before_serialize => sub($data,$xtra) {
|
||||||
|
# lowercase all keys
|
||||||
|
return +{ pairmap { lc($a) => $b } %$data }
|
||||||
|
}
|
||||||
|
|
||||||
|
=head2 type
|
||||||
|
|
||||||
|
The JSON:API object type. Read-only, required.
|
||||||
|
|
||||||
|
=head2 id
|
||||||
|
|
||||||
|
Key to use as a reference to the object. Can be a string,
|
||||||
|
or a function that will be passed the original data object.
|
||||||
|
Read-only, defaults to the string C<id>.
|
||||||
|
|
||||||
|
=head2 links
|
||||||
|
|
||||||
|
Links to include as part of the object.
|
||||||
|
|
||||||
|
=head2 top_level_links
|
||||||
|
|
||||||
|
Links to include to the serialized top level, if the top level object
|
||||||
|
is of the type defined by this class.
|
||||||
|
|
||||||
|
=head2 top_level_meta
|
||||||
|
|
||||||
|
Meta information to include to the serialized top level, if the top level object
|
||||||
|
is of the type defined by this class.
|
||||||
|
|
||||||
|
=head2 relationships
|
||||||
|
|
||||||
|
Relationships for the object type.
|
||||||
|
|
||||||
|
=head2 allowed_attributes
|
||||||
|
|
||||||
|
List of attributes that can be serialized/deserialized.
|
||||||
|
|
||||||
|
=head1 METHODS
|
||||||
|
|
||||||
|
=head2 top_level_serialize($data,$extra_data = {})
|
||||||
|
|
||||||
|
Serializes C<$data> as a top-level JSON:API object.
|
||||||
|
|
||||||
|
=head2 serialize_data($data,$extra_data)
|
||||||
|
|
||||||
|
Serializes the inner C<$data>.
|
||||||
|
|
||||||
|
=head1 AUTHOR
|
||||||
|
|
||||||
|
Yanick Champoux <yanick@babyl.ca>
|
||||||
|
|
||||||
|
=head1 COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
||||||
|
|
||||||
|
=cut
|
@ -1,64 +0,0 @@
|
|||||||
|
|
||||||
=head1 DESCRIPTION
|
|
||||||
|
|
||||||
Defines a type of object to serialize/deserialize from/to the
|
|
||||||
JSON:API format.
|
|
||||||
|
|
||||||
=head1 ATTRIBUTES
|
|
||||||
|
|
||||||
=head2 registry
|
|
||||||
|
|
||||||
L<Dancer2::Plugin::JsonApi::Registry> to use to find the definition of
|
|
||||||
other object types.
|
|
||||||
|
|
||||||
=head2 before_serialize
|
|
||||||
|
|
||||||
Accepts a function, which will be called on the original C<$data> to serialize
|
|
||||||
to groom it.
|
|
||||||
|
|
||||||
before_serialize => sub($data,$xtra) {
|
|
||||||
# lowercase all keys
|
|
||||||
return +{ pairmap { lc($a) => $b } %$data }
|
|
||||||
}
|
|
||||||
|
|
||||||
=head2 type
|
|
||||||
|
|
||||||
The JSON:API object type. Read-only, required.
|
|
||||||
|
|
||||||
=head2 id
|
|
||||||
|
|
||||||
Key to use as a reference to the object. Can be a string,
|
|
||||||
or a function that will be passed the original data object.
|
|
||||||
Read-only, defaults to the string C<id>.
|
|
||||||
|
|
||||||
=head2 links
|
|
||||||
|
|
||||||
Links to include as part of the object.
|
|
||||||
|
|
||||||
=head2 top_level_links
|
|
||||||
|
|
||||||
Links to include to the serialized top level, if the top level object
|
|
||||||
is of the type defined by this class.
|
|
||||||
|
|
||||||
=head2 top_level_meta
|
|
||||||
|
|
||||||
Meta information to include to the serialized top level, if the top level object
|
|
||||||
is of the type defined by this class.
|
|
||||||
|
|
||||||
=head2 relationships
|
|
||||||
|
|
||||||
Relationships for the object type.
|
|
||||||
|
|
||||||
=head2 allowed_attributes
|
|
||||||
|
|
||||||
List of attributes that can be serialized/deserialized.
|
|
||||||
|
|
||||||
=head1 METHODS
|
|
||||||
|
|
||||||
=head2 top_level_serialize($data,$extra_data = {})
|
|
||||||
|
|
||||||
Serializes C<$data> as a top-level JSON:API object.
|
|
||||||
|
|
||||||
=head2 serialize_data($data,$extra_data)
|
|
||||||
|
|
||||||
Serializes the inner C<$data>.
|
|
@ -1,12 +1,60 @@
|
|||||||
use 5.38.0;
|
use 5.38.0;
|
||||||
|
|
||||||
=head1 DESCRIPTION
|
|
||||||
|
|
||||||
Serializer for JSON:API. Takes in a data structure, munge it to conforms to the JSON:API format (potentially based on a provided registry of JSON:API schemas),
|
package Dancer2::Serializer::JsonApi;
|
||||||
and encode it as JSON.
|
our $AUTHORITY = 'cpan:YANICK';
|
||||||
|
$Dancer2::Serializer::JsonApi::VERSION = '0.0.1';
|
||||||
|
use Dancer2::Plugin::JsonApi::Registry;
|
||||||
|
use Dancer2::Serializer::JSON;
|
||||||
|
|
||||||
Note that using Dancer2::Plugin::JsonApi in an app will automatically
|
use Moo;
|
||||||
set C<Dancer2::Serializer::JsonApi> as its serializer if it's not already defined.
|
|
||||||
|
|
||||||
|
has content_type => ( is => 'ro', default => 'application/vnd.api+json' );
|
||||||
|
|
||||||
|
with 'Dancer2::Core::Role::Serializer';
|
||||||
|
|
||||||
|
|
||||||
|
has registry => (
|
||||||
|
is => 'rw',
|
||||||
|
default => sub { Dancer2::Plugin::JsonApi::Registry->new }
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
|
has json_serializer => (
|
||||||
|
is => 'ro',
|
||||||
|
default => sub { Dancer2::Serializer::JSON->new }
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
|
sub serialize {
|
||||||
|
my ( $self, $data ) = @_;
|
||||||
|
|
||||||
|
return $self->json_serializer->serialize(
|
||||||
|
$self->registry->serialize(@$data) );
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
sub deserialize ( $self, $serialized, @ ) {
|
||||||
|
$self->registry->deserialize(
|
||||||
|
$self->json_serializer->deserialize($serialized) );
|
||||||
|
}
|
||||||
|
|
||||||
|
1;
|
||||||
|
|
||||||
|
__END__
|
||||||
|
|
||||||
|
=pod
|
||||||
|
|
||||||
|
=encoding UTF-8
|
||||||
|
|
||||||
|
=head1 NAME
|
||||||
|
|
||||||
|
Dancer2::Serializer::JsonApi
|
||||||
|
|
||||||
|
=head1 VERSION
|
||||||
|
|
||||||
|
version 0.0.1
|
||||||
|
|
||||||
=head1 SYNOPSIS
|
=head1 SYNOPSIS
|
||||||
|
|
||||||
@ -46,14 +94,13 @@ As a standalone module:
|
|||||||
}
|
}
|
||||||
]);
|
]);
|
||||||
|
|
||||||
=cut
|
=head1 DESCRIPTION
|
||||||
|
|
||||||
package Dancer2::Serializer::JsonApi;
|
Serializer for JSON:API. Takes in a data structure, munge it to conforms to the JSON:API format (potentially based on a provided registry of JSON:API schemas),
|
||||||
|
and encode it as JSON.
|
||||||
|
|
||||||
use Dancer2::Plugin::JsonApi::Registry;
|
Note that using Dancer2::Plugin::JsonApi in an app will automatically
|
||||||
use Dancer2::Serializer::JSON;
|
set C<Dancer2::Serializer::JsonApi> as its serializer if it's not already defined.
|
||||||
|
|
||||||
use Moo;
|
|
||||||
|
|
||||||
=head1 ATTRIBUTES
|
=head1 ATTRIBUTES
|
||||||
|
|
||||||
@ -61,34 +108,14 @@ use Moo;
|
|||||||
|
|
||||||
Returns the content type used by the serializer, which is C<application/vnd.api+json>;
|
Returns the content type used by the serializer, which is C<application/vnd.api+json>;
|
||||||
|
|
||||||
=cut
|
|
||||||
|
|
||||||
has content_type => ( is => 'ro', default => 'application/vnd.api+json' );
|
|
||||||
|
|
||||||
with 'Dancer2::Core::Role::Serializer';
|
|
||||||
|
|
||||||
=head2 registry
|
=head2 registry
|
||||||
|
|
||||||
The L<Dancer2::Plugin::JsonApi::Registry> to use.
|
The L<Dancer2::Plugin::JsonApi::Registry> to use.
|
||||||
|
|
||||||
=cut
|
|
||||||
|
|
||||||
has registry => (
|
|
||||||
is => 'rw',
|
|
||||||
default => sub { Dancer2::Plugin::JsonApi::Registry->new }
|
|
||||||
);
|
|
||||||
|
|
||||||
=head2 json_serializer
|
=head2 json_serializer
|
||||||
|
|
||||||
The underlying JSON serializer. Defaults to L<Dancer2::Serializer::JSON>.
|
The underlying JSON serializer. Defaults to L<Dancer2::Serializer::JSON>.
|
||||||
|
|
||||||
=cut
|
|
||||||
|
|
||||||
has json_serializer => (
|
|
||||||
is => 'ro',
|
|
||||||
default => sub { Dancer2::Serializer::JSON->new }
|
|
||||||
);
|
|
||||||
|
|
||||||
=head1 METHODS
|
=head1 METHODS
|
||||||
|
|
||||||
=head2 $self->serialize( [ $type, $data, $xtra ])
|
=head2 $self->serialize( [ $type, $data, $xtra ])
|
||||||
@ -96,24 +123,19 @@ has json_serializer => (
|
|||||||
Serializes the C<$data> using the C<$type> from the registry.
|
Serializes the C<$data> using the C<$type> from the registry.
|
||||||
The returned value will be a JSON string.
|
The returned value will be a JSON string.
|
||||||
|
|
||||||
=cut
|
|
||||||
|
|
||||||
sub serialize {
|
|
||||||
my ( $self, $data ) = @_;
|
|
||||||
|
|
||||||
return $self->json_serializer->serialize(
|
|
||||||
$self->registry->serialize(@$data) );
|
|
||||||
}
|
|
||||||
|
|
||||||
=head2 $self->deserialize( $json_string )
|
=head2 $self->deserialize( $json_string )
|
||||||
|
|
||||||
Takes in the serialized C<$json_string> and recreate data out of it.
|
Takes in the serialized C<$json_string> and recreate data out of it.
|
||||||
|
|
||||||
|
=head1 AUTHOR
|
||||||
|
|
||||||
|
Yanick Champoux <yanick@babyl.ca>
|
||||||
|
|
||||||
|
=head1 COPYRIGHT AND LICENSE
|
||||||
|
|
||||||
|
This software is copyright (c) 2023 by Yanick Champoux.
|
||||||
|
|
||||||
|
This is free software; you can redistribute it and/or modify it under
|
||||||
|
the same terms as the Perl 5 programming language system itself.
|
||||||
|
|
||||||
=cut
|
=cut
|
||||||
|
|
||||||
sub deserialize ( $self, $serialized, @ ) {
|
|
||||||
$self->registry->deserialize(
|
|
||||||
$self->json_serializer->deserialize($serialized) );
|
|
||||||
}
|
|
||||||
|
|
||||||
1;
|
|
63
t/00-compile.t
Normal file
63
t/00-compile.t
Normal file
@ -0,0 +1,63 @@
|
|||||||
|
use 5.006;
|
||||||
|
use strict;
|
||||||
|
use warnings;
|
||||||
|
|
||||||
|
# this test was generated with Dist::Zilla::Plugin::Test::Compile 2.058
|
||||||
|
|
||||||
|
use Test::More;
|
||||||
|
|
||||||
|
plan tests => 4 + ($ENV{AUTHOR_TESTING} ? 1 : 0);
|
||||||
|
|
||||||
|
my @module_files = (
|
||||||
|
'Dancer2/Plugin/JsonApi.pm',
|
||||||
|
'Dancer2/Plugin/JsonApi/Registry.pm',
|
||||||
|
'Dancer2/Plugin/JsonApi/Schema.pm',
|
||||||
|
'Dancer2/Serializer/JsonApi.pm'
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
# no fake home requested
|
||||||
|
|
||||||
|
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<perlfaq8/How can I capture STDERR from an external command?>
|
||||||
|
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) ) if $ENV{AUTHOR_TESTING};
|
||||||
|
|
||||||
|
|
50
t/00-report-prereqs.dd
Normal file
50
t/00-report-prereqs.dd
Normal file
@ -0,0 +1,50 @@
|
|||||||
|
do { my $x = {
|
||||||
|
'configure' => {
|
||||||
|
'requires' => {
|
||||||
|
'ExtUtils::MakeMaker' => '0'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
'develop' => {
|
||||||
|
'requires' => {
|
||||||
|
'Git::Wrapper' => '0',
|
||||||
|
'Test2::V0' => '0',
|
||||||
|
'Test::More' => '0.96',
|
||||||
|
'Test::PerlTidy' => '0',
|
||||||
|
'Test::Vars' => '0'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
'runtime' => {
|
||||||
|
'requires' => {
|
||||||
|
'Carp' => '0',
|
||||||
|
'Dancer2::Core::Role::Serializer' => '0',
|
||||||
|
'Dancer2::Plugin' => '0',
|
||||||
|
'Dancer2::Serializer::JSON' => '0',
|
||||||
|
'List::AllUtils' => '0',
|
||||||
|
'Moo' => '0',
|
||||||
|
'Set::Object' => '0',
|
||||||
|
'experimental' => '0',
|
||||||
|
'perl' => 'v5.38.0'
|
||||||
|
}
|
||||||
|
},
|
||||||
|
'test' => {
|
||||||
|
'recommends' => {
|
||||||
|
'CPAN::Meta' => '2.120900'
|
||||||
|
},
|
||||||
|
'requires' => {
|
||||||
|
'Clone' => '0',
|
||||||
|
'Dancer2' => '0',
|
||||||
|
'ExtUtils::MakeMaker' => '0',
|
||||||
|
'File::Spec' => '0',
|
||||||
|
'IO::Handle' => '0',
|
||||||
|
'IPC::Open3' => '0',
|
||||||
|
'JSON' => '0',
|
||||||
|
'Test2::Plugin::ExitSummary' => '0',
|
||||||
|
'Test2::V0' => '0',
|
||||||
|
'Test::More' => '0',
|
||||||
|
'strict' => '0',
|
||||||
|
'warnings' => '0'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
$x;
|
||||||
|
}
|
197
t/00-report-prereqs.t
Normal file
197
t/00-report-prereqs.t
Normal file
@ -0,0 +1,197 @@
|
|||||||
|
#!perl
|
||||||
|
|
||||||
|
use strict;
|
||||||
|
use warnings;
|
||||||
|
|
||||||
|
# This test was generated by Dist::Zilla::Plugin::Test::ReportPrereqs 0.029
|
||||||
|
|
||||||
|
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 grep { $_ eq $mod } @exclude;
|
||||||
|
|
||||||
|
my $want = $req_hash->{$phase}{$type}{$mod};
|
||||||
|
$want = "undef" unless defined $want;
|
||||||
|
$want = "any" if !$want && $want == 0;
|
||||||
|
|
||||||
|
if ($mod eq 'perl') {
|
||||||
|
push @reports, ['perl', $want, $]];
|
||||||
|
next;
|
||||||
|
}
|
||||||
|
|
||||||
|
my $req_string = $want eq 'any' ? 'any version required' : "version '$want' required";
|
||||||
|
|
||||||
|
my $file = $mod;
|
||||||
|
$file =~ s{::}{/}g;
|
||||||
|
$file .= ".pm";
|
||||||
|
my ($prefix) = grep { -e File::Spec->catfile($_, $file) } @INC;
|
||||||
|
|
||||||
|
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('Reported prereqs');
|
||||||
|
|
||||||
|
# vim: ts=4 sts=4 sw=4 et:
|
6
xt/release/unused-vars.t
Normal file
6
xt/release/unused-vars.t
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
use Test::More 0.96 tests => 1;
|
||||||
|
use Test::Vars;
|
||||||
|
|
||||||
|
subtest 'unused vars' => sub {
|
||||||
|
all_vars_ok();
|
||||||
|
};
|
Loading…
Reference in New Issue
Block a user