@@ -0,0 +1,65 @@
+# =========================================================================
+# THIS FILE IS AUTOMATICALLY GENERATED BY MINILLA.
+# DO NOT EDIT DIRECTLY.
+# =========================================================================
+
+use 5.008_001;
+
+use strict;
+use warnings;
+use utf8;
+
+use Module::Build;
+use File::Basename;
+use File::Spec;
+
+my %args = (
+ license => 'perl',
+ dynamic_config => 0,
+
+ configure_requires => {
+ 'Module::Build' => 0.38,
+ },
+
+ name => 'Protocol-WebSocket',
+ module_name => 'Protocol::WebSocket',
+ allow_pureperl => 0,
+
+ script_files => [glob('script/*'), glob('bin/*')],
+ c_source => [qw()],
+ PL_files => {},
+
+ test_files => ((-d '.git' || $ENV{RELEASE_TESTING}) && -d 'xt') ? 't/ xt/' : 't/',
+ recursive_test_files => 1,
+
+
+);
+if (-d 'share') {
+ $args{share_dir} = 'share';
+}
+
+my $builder = Module::Build->subclass(
+ class => 'MyBuilder',
+ code => q{
+ sub ACTION_distmeta {
+ die "Do not run distmeta. Install Minilla and `minil install` instead.\n";
+ }
+ sub ACTION_installdeps {
+ die "Do not run installdeps. Run `cpanm --installdeps .` instead.\n";
+ }
+ }
+)->new(%args);
+$builder->create_build_script();
+
+use File::Copy;
+
+print "cp META.json MYMETA.json\n";
+copy("META.json","MYMETA.json") or die "Copy failed(META.json): $!";
+
+if (-f 'META.yml') {
+ print "cp META.yml MYMETA.yml\n";
+ copy("META.yml","MYMETA.yml") or die "Copy failed(META.yml): $!";
+} else {
+ print "There is no META.yml... You may install this module from the repository...\n";
+}
+
@@ -1,5 +1,77 @@
Revision history for perl module Protocol::WebSocket
+0.18 2014-09-01T14:45:16Z
+
+ - Digest::SHA1 -> Digest::SHA (Michal Špaček)
+
+0.17 2014-04-09T08:12:01Z
+
+ - perl 5.8 unpack fix (Graham Ollis)
+ - doc and test fixes (Michal Špaček)
+
+0.16 2014-01-07T20:33:59Z
+
+ - just meta files update
+
+0.15 2013-11-03T15:54:47Z
+
+ - Explicitly stringify $payload in _mask() method (Toshio Ito)
+
+0.14 2013-10-14T08:50:38Z
+
+ - Fix Changes file (Neil Bowers)
+ - Fix distribution (reported by Géraud CONTINSOUZAS)
+
+0.13 2013-10-13T17:17:03Z
+
+ - Implemented set cookies for requests (Joao Orui)
+
+ The following changes made by Toshio Ito (debug-ito):
+ - Add test in which Frame class generates and parses a series of fragments.
+ - Add test for destructiveness of append() method.
+ - Documentation: add remarks about destructiveness of append() method.
+ Sometimes it's useful, the other times it's confusing.
+ - Add documentation of "version" field in new() method.
+ - Add documentation of "masked" field in new() method.
+ - Remove fin() accessor from documentation and test. If a message is
+ fragmented, the return value of fin() is meaningless anyway. Plus, probably
+ current implementation does not handle fin flags if control frames are
+ injected in non-control fragments. If we want fin() accessor, the test for
+ that case is necessary.
+ - Add documentation about "opcode" field in new() method and opcode() accessor
+ method. tests are also added.
+ - Add is_continuation() method.
+ - Now "type" field for new() is immediately resolved to opcode, so that
+ new(type => $type) and is_{type} methods are now consistent. This fixes
+ github issue vti/protocol-websocket#19 ($frame->{type} field is preserved for
+ backward-compatibility, but direct assignment $frame->{type} = "close"
+ followed by $frame->to_bytes() will not work anymore. However, direct
+ assignment is considered rude anyway...)
+ - Add "continuation" frame type. opcode() method is revised so that it can
+ correctly return 0 if $frame->{opcode} == 0.
+ - POD update: ATTRIBUTES - type section is moved under new() method. This is
+ way more straightforward.
+ - Document "fin" field in the constructor and fin() accessor. to_bytes() now
+ encodes "fin" bit according to the fin field of the Frame object.
+
+0.12 2012-10-24
+
+ - Improved frame performance (Chuck Bredestege)
+ - Check origin only if origin is present (Matthew Lien)
+
+0.11 2012-08-28
+
+ - Added wsconsole
+ - Fixed default version in WebSocket Frame
+ - Fixed default ports in WebSocket URL
+
+0.10 2012-08-21
+
+ - Fixed origin issue in hybi-17
+ - Added query string in resource name (Atomer Ju)
+ - Added possibility to write headers before receiving a nonce (HAProxy)
+ - Updated examples
+
0.00906 2011-10-30
- Support draft-ietf-hybi-17
@@ -20,8 +92,8 @@ Revision history for perl module Protocol::WebSocket
0.00902 2011-05-12
- - API CHANGE: Frame's to_string now returns a Perl string, use to_bytes to get a
- UTF-8 encoded octets
+ - API CHANGE: Frame's to_string now returns a Perl string,
+ use to_bytes to get a UTF-8 encoded octets
- Automatically decode when building frame from a Perl string
- Pay attention to SCRIPT_NAME in PSGI
- If an origin was passed in, don't change it (Jon Gentle)
@@ -58,3 +130,4 @@ Revision history for perl module Protocol::WebSocket
0.0002 2010-11-26
- Initial release
+
@@ -0,0 +1,381 @@
+This software is copyright (c) 2013 by Viacheslav Tykhanovskyi
+<viacheslav.t@gmail.com>.
+
+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) 2013 by Viacheslav Tykhanovskyi
+<viacheslav.t@gmail.com>.
+
+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, Suite 500, Boston, MA 02110-1335 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 Artistic License 1.0 ---
+
+This software is copyright (c) 2013 by Viacheslav Tykhanovskyi
+<viacheslav.t@gmail.com>.
+
+This is free software, licensed under:
+
+ The 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.
+ - "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 ftp.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) accompany any non-standard executables with their corresponding Standard
+ Version executables, giving the non-standard executables non-standard
+ names, and clearly documenting 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.
+
+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 whomever generated them, and may be sold
+commercially, and may be aggregated with this Package.
+
+7. C or perl subroutines supplied by you and linked into this Package shall not
+be considered part of this Package.
+
+8. The name of the Copyright Holder may not be used to endorse or promote
+products derived from this software without specific prior written permission.
+
+9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
+MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+The End
@@ -1,4 +1,7 @@
Changes
+LICENSE
+MANIFEST.SKIP
+cpanfile
examples/anyevent-http-server.pl
examples/anyevent.pl
examples/event.pl
@@ -13,18 +16,8 @@ examples/nginx-engine.pl
examples/plack.psgi
examples/poe.pl
examples/reflex.pl
-inc/Module/AutoInstall.pm
-inc/Module/Install.pm
-inc/Module/Install/AutoInstall.pm
-inc/Module/Install/Base.pm
-inc/Module/Install/Can.pm
-inc/Module/Install/Fetch.pm
-inc/Module/Install/Include.pm
-inc/Module/Install/Makefile.pm
-inc/Module/Install/Metadata.pm
-inc/Module/Install/Win32.pm
-inc/Module/Install/WriteAll.pm
lib/Protocol/WebSocket.pm
+lib/Protocol/WebSocket/Client.pm
lib/Protocol/WebSocket/Cookie.pm
lib/Protocol/WebSocket/Cookie/Request.pm
lib/Protocol/WebSocket/Cookie/Response.pm
@@ -37,13 +30,9 @@ lib/Protocol/WebSocket/Request.pm
lib/Protocol/WebSocket/Response.pm
lib/Protocol/WebSocket/Stateful.pm
lib/Protocol/WebSocket/URL.pm
-Makefile.PL
-MANIFEST This list of files
-MANIFEST.SKIP
-META.yml
-MYMETA.json
-MYMETA.yml
+minil.toml
t/challenge
+t/client.t
t/cookie.t
t/draft-hixie-75/request.t
t/draft-hixie-75/response.t
@@ -55,16 +44,26 @@ t/draft-ietf-hybi-00/response.t
t/draft-ietf-hybi-00/server-ssl.t
t/draft-ietf-hybi-00/server.t
t/draft-ietf-hybi-10/client.t
-t/draft-ietf-hybi-10/frame.t
t/draft-ietf-hybi-10/request.t
t/draft-ietf-hybi-10/response.t
t/draft-ietf-hybi-10/server.t
+t/draft-ietf-hybi-17/client.t
+t/draft-ietf-hybi-17/frame.t
+t/draft-ietf-hybi-17/request.t
+t/draft-ietf-hybi-17/request_psgi.t
+t/draft-ietf-hybi-17/response.t
+t/draft-ietf-hybi-17/server.t
t/empty
t/message
t/message.t
t/request_common.t
t/response_common.t
t/url.t
+util/wsconsole
xt/changes.t
xt/pod-coverage.t
xt/pod.t
+META.json
+META.yml
+MANIFEST
+Build.PL
\ No newline at end of file
@@ -0,0 +1,122 @@
+{
+ "abstract" : "WebSocket protocol",
+ "author" : [
+ "Viacheslav Tykhanovskyi, C<vti@cpan.org>."
+ ],
+ "dynamic_config" : 0,
+ "generated_by" : "Minilla/v2.1.1",
+ "license" : [
+ "perl_5"
+ ],
+ "meta-spec" : {
+ "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
+ "version" : "2"
+ },
+ "name" : "Protocol-WebSocket",
+ "no_index" : {
+ "directory" : [
+ "t",
+ "xt",
+ "inc",
+ "share",
+ "eg",
+ "examples",
+ "author",
+ "builder"
+ ]
+ },
+ "prereqs" : {
+ "configure" : {
+ "requires" : {
+ "Module::Build" : "0.38"
+ }
+ },
+ "develop" : {
+ "requires" : {
+ "Test::CPAN::Meta" : "0",
+ "Test::MinimumVersion::Fast" : "0.04",
+ "Test::PAUSE::Permissions" : "0.04",
+ "Test::Pod" : "1.41",
+ "Test::Spellunker" : "v0.2.7"
+ }
+ },
+ "runtime" : {
+ "requires" : {
+ "Carp" : "0",
+ "Digest::MD5" : "0",
+ "Digest::SHA" : "0",
+ "Scalar::Util" : "0"
+ }
+ }
+ },
+ "provides" : {
+ "Protocol::WebSocket" : {
+ "file" : "lib/Protocol/WebSocket.pm",
+ "version" : "0.18"
+ },
+ "Protocol::WebSocket::Client" : {
+ "file" : "lib/Protocol/WebSocket/Client.pm"
+ },
+ "Protocol::WebSocket::Cookie" : {
+ "file" : "lib/Protocol/WebSocket/Cookie.pm"
+ },
+ "Protocol::WebSocket::Cookie::Request" : {
+ "file" : "lib/Protocol/WebSocket/Cookie/Request.pm"
+ },
+ "Protocol::WebSocket::Cookie::Response" : {
+ "file" : "lib/Protocol/WebSocket/Cookie/Response.pm"
+ },
+ "Protocol::WebSocket::Frame" : {
+ "file" : "lib/Protocol/WebSocket/Frame.pm"
+ },
+ "Protocol::WebSocket::Handshake" : {
+ "file" : "lib/Protocol/WebSocket/Handshake.pm"
+ },
+ "Protocol::WebSocket::Handshake::Client" : {
+ "file" : "lib/Protocol/WebSocket/Handshake/Client.pm"
+ },
+ "Protocol::WebSocket::Handshake::Server" : {
+ "file" : "lib/Protocol/WebSocket/Handshake/Server.pm"
+ },
+ "Protocol::WebSocket::Message" : {
+ "file" : "lib/Protocol/WebSocket/Message.pm"
+ },
+ "Protocol::WebSocket::Request" : {
+ "file" : "lib/Protocol/WebSocket/Request.pm"
+ },
+ "Protocol::WebSocket::Response" : {
+ "file" : "lib/Protocol/WebSocket/Response.pm"
+ },
+ "Protocol::WebSocket::Stateful" : {
+ "file" : "lib/Protocol/WebSocket/Stateful.pm"
+ },
+ "Protocol::WebSocket::URL" : {
+ "file" : "lib/Protocol/WebSocket/URL.pm"
+ }
+ },
+ "release_status" : "stable",
+ "resources" : {
+ "bugtracker" : {
+ "web" : "https://github.com/vti/protocol-websocket/issues"
+ },
+ "homepage" : "https://github.com/vti/protocol-websocket",
+ "repository" : {
+ "url" : "git://github.com/vti/protocol-websocket.git",
+ "web" : "https://github.com/vti/protocol-websocket"
+ }
+ },
+ "version" : "0.18",
+ "x_contributors" : [
+ "Jon Gentle <atrodo@atrodo.org>",
+ "Lee Aylward <lee@laylward.com>",
+ "Chia-liang Kao <clkao@clkao.org>",
+ "BlueT - Matthew Lien - 練喆明 <BlueT@BlueT.org>",
+ "Joao Orui <joao@joao.jp>",
+ "Jonathan Barber <jonathan.barber@gmail.com>",
+ "Neil Bowers <neil@bowers.com>",
+ "Toshio Ito <debug.ito@gmail.com>",
+ "Graham Ollis <plicease@cpan.org>",
+ "Michal Špaček <tupinek@gmail.com>",
+ "Viacheslav Tykhanovskyi <viacheslav.t@gmail.com>"
+ ]
+}
@@ -1,33 +1,76 @@
---
-abstract: 'WebSocket request/response'
+abstract: 'WebSocket protocol'
author:
- - 'Viacheslav Tykhanovskyi <vti@cpan.org>'
-build_requires:
- ExtUtils::MakeMaker: 6.62
+ - 'Viacheslav Tykhanovskyi, C<vti@cpan.org>.'
+build_requires: {}
configure_requires:
- ExtUtils::MakeMaker: 6.62
-distribution_type: module
-dynamic_config: 1
-generated_by: 'Module::Install version 1.04'
-license: artistic_2
+ Module::Build: '0.38'
+dynamic_config: 0
+generated_by: 'Minilla/v2.1.1, CPAN::Meta::Converter version 2.140640'
+license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
- version: 1.4
+ version: '1.4'
name: Protocol-WebSocket
no_index:
directory:
- - examples
- - inc
- t
- xt
+ - inc
+ - share
+ - eg
+ - examples
+ - author
+ - builder
+provides:
+ Protocol::WebSocket:
+ file: lib/Protocol/WebSocket.pm
+ version: '0.18'
+ Protocol::WebSocket::Client:
+ file: lib/Protocol/WebSocket/Client.pm
+ Protocol::WebSocket::Cookie:
+ file: lib/Protocol/WebSocket/Cookie.pm
+ Protocol::WebSocket::Cookie::Request:
+ file: lib/Protocol/WebSocket/Cookie/Request.pm
+ Protocol::WebSocket::Cookie::Response:
+ file: lib/Protocol/WebSocket/Cookie/Response.pm
+ Protocol::WebSocket::Frame:
+ file: lib/Protocol/WebSocket/Frame.pm
+ Protocol::WebSocket::Handshake:
+ file: lib/Protocol/WebSocket/Handshake.pm
+ Protocol::WebSocket::Handshake::Client:
+ file: lib/Protocol/WebSocket/Handshake/Client.pm
+ Protocol::WebSocket::Handshake::Server:
+ file: lib/Protocol/WebSocket/Handshake/Server.pm
+ Protocol::WebSocket::Message:
+ file: lib/Protocol/WebSocket/Message.pm
+ Protocol::WebSocket::Request:
+ file: lib/Protocol/WebSocket/Request.pm
+ Protocol::WebSocket::Response:
+ file: lib/Protocol/WebSocket/Response.pm
+ Protocol::WebSocket::Stateful:
+ file: lib/Protocol/WebSocket/Stateful.pm
+ Protocol::WebSocket::URL:
+ file: lib/Protocol/WebSocket/URL.pm
requires:
- Carp: 0
- Digest::MD5: 0
- Digest::SHA1: 0
- Scalar::Util: 0
- perl: 5.8.7
+ Carp: '0'
+ Digest::MD5: '0'
+ Digest::SHA: '0'
+ Scalar::Util: '0'
resources:
- bugtracker: http://github.com/vti/protocol-websocket/issues
- license: http://dev.perl.org/licenses/
- repository: http://github.com/vti/protocol-websocket/
-version: 0.00906
+ bugtracker: https://github.com/vti/protocol-websocket/issues
+ homepage: https://github.com/vti/protocol-websocket
+ repository: git://github.com/vti/protocol-websocket.git
+version: '0.18'
+x_contributors:
+ - 'Jon Gentle <atrodo@atrodo.org>'
+ - 'Lee Aylward <lee@laylward.com>'
+ - 'Chia-liang Kao <clkao@clkao.org>'
+ - 'BlueT - Matthew Lien - 練喆明 <BlueT@BlueT.org>'
+ - 'Joao Orui <joao@joao.jp>'
+ - 'Jonathan Barber <jonathan.barber@gmail.com>'
+ - 'Neil Bowers <neil@bowers.com>'
+ - 'Toshio Ito <debug.ito@gmail.com>'
+ - 'Graham Ollis <plicease@cpan.org>'
+ - 'Michal Špaček <tupinek@gmail.com>'
+ - 'Viacheslav Tykhanovskyi <viacheslav.t@gmail.com>'
@@ -1,58 +0,0 @@
-{
- "abstract" : "WebSocket request/response",
- "author" : [
- "Viacheslav Tykhanovskyi <vti@cpan.org>"
- ],
- "dynamic_config" : 0,
- "generated_by" : "Module::Install version 1.01, CPAN::Meta::Converter version 2.112621",
- "license" : [
- "artistic_2"
- ],
- "meta-spec" : {
- "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
- "version" : "2"
- },
- "name" : "Protocol-WebSocket",
- "no_index" : {
- "directory" : [
- "examples",
- "inc",
- "t",
- "xt"
- ]
- },
- "prereqs" : {
- "build" : {
- "requires" : {
- "ExtUtils::MakeMaker" : "6.62"
- }
- },
- "configure" : {
- "requires" : {
- "ExtUtils::MakeMaker" : "6.42"
- }
- },
- "runtime" : {
- "requires" : {
- "Carp" : 0,
- "Digest::MD5" : 0,
- "Digest::SHA1" : 0,
- "Scalar::Util" : 0,
- "perl" : "5.008007"
- }
- }
- },
- "release_status" : "stable",
- "resources" : {
- "bugtracker" : {
- "web" : "http://github.com/vti/protocol-websocket/issues"
- },
- "license" : [
- "http://dev.perl.org/licenses/"
- ],
- "repository" : {
- "url" : "http://github.com/vti/protocol-websocket/"
- }
- },
- "version" : "0.00905"
-}
@@ -1,32 +0,0 @@
----
-abstract: 'WebSocket request/response'
-author:
- - 'Viacheslav Tykhanovskyi <vti@cpan.org>'
-build_requires:
- ExtUtils::MakeMaker: 6.62
-configure_requires:
- ExtUtils::MakeMaker: 6.42
-dynamic_config: 0
-generated_by: 'Module::Install version 1.01, CPAN::Meta::Converter version 2.112621'
-license: artistic_2
-meta-spec:
- url: http://module-build.sourceforge.net/META-spec-v1.4.html
- version: 1.4
-name: Protocol-WebSocket
-no_index:
- directory:
- - examples
- - inc
- - t
- - xt
-requires:
- Carp: 0
- Digest::MD5: 0
- Digest::SHA1: 0
- Scalar::Util: 0
- perl: 5.008007
-resources:
- bugtracker: http://github.com/vti/protocol-websocket/issues
- license: http://dev.perl.org/licenses/
- repository: http://github.com/vti/protocol-websocket/
-version: 0.00905
@@ -1,32 +0,0 @@
-#!/usr/bin/env perl
-
-use strict;
-use warnings;
-
-use inc::Module::Install;
-
-name 'Protocol-WebSocket';
-
-version_from 'lib/Protocol/WebSocket.pm';
-author 'Viacheslav Tykhanovskyi <vti@cpan.org>';
-abstract 'WebSocket request/response';
-license 'artistic_2';
-perl_version '5.008007';
-
-requires 'Carp' => 0;
-requires 'Digest::MD5' => 0;
-requires 'Digest::SHA1' => 0;
-requires 'Scalar::Util' => 0;
-
-tests 't/*.t t/*/*.t t/*/*/*.t t/*/*/*/*.t';
-
-no_index directory => 't';
-
-resources
- bugtracker => 'http://github.com/vti/protocol-websocket/issues',
- repository => 'http://github.com/vti/protocol-websocket/',
- license => 'http://dev.perl.org/licenses/';
-
-auto_install;
-
-WriteAll;
@@ -0,0 +1,4 @@
+requires 'Carp' => 0;
+requires 'Digest::MD5' => 0;
+requires 'Digest::SHA' => 0;
+requires 'Scalar::Util' => 0;
@@ -40,7 +40,7 @@ AnyEvent::Socket::tcp_server undef, 3000, sub {
$frame->append($chunk);
while (my $message = $frame->next) {
- $hdl->push_write($frame->new($message)->to_string);
+ $hdl->push_write($frame->new($message)->to_bytes);
}
}
);
@@ -34,7 +34,7 @@ EventReactor->new(
$frame->append($chunk);
while (my $message = $frame->next) {
- $client->write($frame->new($message)->to_string);
+ $client->write($frame->new($message)->to_bytes);
}
}
);
@@ -37,7 +37,7 @@ my $listener = IO::Async::Listener->new(
$frame->append($$buffref);
while (my $message = $frame->next) {
- $self->write($frame->new($message)->to_string);
+ $self->write($frame->new($message)->to_bytes);
}
$$buffref = "";
@@ -46,7 +46,7 @@ sub ie_input {
$frame->append($$input_buffer_reference);
while (my $message = $frame->next) {
- print $client $frame->new($message)->to_string;
+ print $client $frame->new($message)->to_bytes;
}
$$input_buffer_reference = '';
@@ -55,7 +55,7 @@ my $serv = lambda {
$frame->append($match);
while (my $message = $frame->next) {
- $res .= $frame->new($message)->to_string;
+ $res .= $frame->new($message)->to_bytes;
}
again;
@@ -49,7 +49,7 @@ sub mux_input {
$frame->append($$input);
while (my $message = $frame->next) {
- print $c $frame->new($message)->to_string;
+ print $c $frame->new($message)->to_bytes;
}
}
@@ -36,7 +36,7 @@ while (1) {
}
my $hs = Protocol::WebSocket::Handshake::Server->new;
-my $frame = Protocol::WebSocket::Frame->new;
+my $frame = $hs->build_frame;
my $buffer = '';
@@ -63,7 +63,7 @@ LOOP: while (1) {
$frame->append($chunk);
while (defined(my $message = $frame->next)) {
- $buffer .= $frame->new($message)->to_string;
+ $buffer .= $frame->new($message)->to_bytes;
}
}
@@ -45,7 +45,7 @@ sub mux_input {
$frame->append($$in_ref);
while (my $message = $frame->next) {
- print $fh $frame->new($message)->to_string;
+ print $fh $frame->new($message)->to_bytes;
}
$$in_ref = "";
@@ -39,7 +39,7 @@ ngxe_server(
$frame->append($recv);
while (my $message = $frame->next) {
- $send .= $frame->new($message)->to_string;
+ $send .= $frame->new($message)->to_bytes;
}
}
@@ -25,12 +25,13 @@ my $psgi_app = sub {
$h->push_write($hs->to_string);
+ $h->on_eof(sub {});
$h->on_read(
sub {
$frame->append($_[0]->rbuf);
while (my $message = $frame->next) {
- $h->push_write(Protocol::WebSocket::Frame->new($message)->to_string);
+ $h->push_write(Protocol::WebSocket::Frame->new($message)->to_bytes);
}
}
);
@@ -30,7 +30,7 @@ POE::Component::Server::TCP->new(
$frame->append($chunk);
while (my $message = $frame->next) {
- $_[HEAP]{client}->put($frame->new($message)->to_string);
+ $_[HEAP]{client}->put($frame->new($message)->to_bytes);
}
}
);
@@ -33,7 +33,7 @@
my $frame = $self->frame;
$frame->append($args->{data});
while (my $message = $frame->next) {
- $self->put($frame->new($message)->to_string);
+ $self->put($frame->new($message)->to_bytes);
}
}
}
@@ -1,915 +0,0 @@
-#line 1
-package Module::AutoInstall;
-
-use strict;
-use Cwd ();
-use ExtUtils::MakeMaker ();
-
-use vars qw{$VERSION};
-BEGIN {
- $VERSION = '1.04';
-}
-
-# special map on pre-defined feature sets
-my %FeatureMap = (
- '' => 'Core Features', # XXX: deprecated
- '-core' => 'Core Features',
-);
-
-# various lexical flags
-my ( @Missing, @Existing, %DisabledTests, $UnderCPAN, $InstallDepsTarget, $HasCPANPLUS );
-my (
- $Config, $CheckOnly, $SkipInstall, $AcceptDefault, $TestOnly, $AllDeps,
- $UpgradeDeps
-);
-my ( $PostambleActions, $PostambleActionsNoTest, $PostambleActionsUpgradeDeps,
- $PostambleActionsUpgradeDepsNoTest, $PostambleActionsListDeps,
- $PostambleActionsListAllDeps, $PostambleUsed, $NoTest);
-
-# See if it's a testing or non-interactive session
-_accept_default( $ENV{AUTOMATED_TESTING} or ! -t STDIN );
-_init();
-
-sub _accept_default {
- $AcceptDefault = shift;
-}
-
-sub _installdeps_target {
- $InstallDepsTarget = shift;
-}
-
-sub missing_modules {
- return @Missing;
-}
-
-sub do_install {
- __PACKAGE__->install(
- [
- $Config
- ? ( UNIVERSAL::isa( $Config, 'HASH' ) ? %{$Config} : @{$Config} )
- : ()
- ],
- @Missing,
- );
-}
-
-# initialize various flags, and/or perform install
-sub _init {
- foreach my $arg (
- @ARGV,
- split(
- /[\s\t]+/,
- $ENV{PERL_AUTOINSTALL} || $ENV{PERL_EXTUTILS_AUTOINSTALL} || ''
- )
- )
- {
- if ( $arg =~ /^--config=(.*)$/ ) {
- $Config = [ split( ',', $1 ) ];
- }
- elsif ( $arg =~ /^--installdeps=(.*)$/ ) {
- __PACKAGE__->install( $Config, @Missing = split( /,/, $1 ) );
- exit 0;
- }
- elsif ( $arg =~ /^--upgradedeps=(.*)$/ ) {
- $UpgradeDeps = 1;
- __PACKAGE__->install( $Config, @Missing = split( /,/, $1 ) );
- exit 0;
- }
- elsif ( $arg =~ /^--default(?:deps)?$/ ) {
- $AcceptDefault = 1;
- }
- elsif ( $arg =~ /^--check(?:deps)?$/ ) {
- $CheckOnly = 1;
- }
- elsif ( $arg =~ /^--skip(?:deps)?$/ ) {
- $SkipInstall = 1;
- }
- elsif ( $arg =~ /^--test(?:only)?$/ ) {
- $TestOnly = 1;
- }
- elsif ( $arg =~ /^--all(?:deps)?$/ ) {
- $AllDeps = 1;
- }
- }
-}
-
-# overrides MakeMaker's prompt() to automatically accept the default choice
-sub _prompt {
- goto &ExtUtils::MakeMaker::prompt unless $AcceptDefault;
-
- my ( $prompt, $default ) = @_;
- my $y = ( $default =~ /^[Yy]/ );
-
- print $prompt, ' [', ( $y ? 'Y' : 'y' ), '/', ( $y ? 'n' : 'N' ), '] ';
- print "$default\n";
- return $default;
-}
-
-# the workhorse
-sub import {
- my $class = shift;
- my @args = @_ or return;
- my $core_all;
-
- print "*** $class version " . $class->VERSION . "\n";
- print "*** Checking for Perl dependencies...\n";
-
- my $cwd = Cwd::cwd();
-
- $Config = [];
-
- my $maxlen = length(
- (
- sort { length($b) <=> length($a) }
- grep { /^[^\-]/ }
- map {
- ref($_)
- ? ( ( ref($_) eq 'HASH' ) ? keys(%$_) : @{$_} )
- : ''
- }
- map { +{@args}->{$_} }
- grep { /^[^\-]/ or /^-core$/i } keys %{ +{@args} }
- )[0]
- );
-
- # We want to know if we're under CPAN early to avoid prompting, but
- # if we aren't going to try and install anything anyway then skip the
- # check entirely since we don't want to have to load (and configure)
- # an old CPAN just for a cosmetic message
-
- $UnderCPAN = _check_lock(1) unless $SkipInstall || $InstallDepsTarget;
-
- while ( my ( $feature, $modules ) = splice( @args, 0, 2 ) ) {
- my ( @required, @tests, @skiptests );
- my $default = 1;
- my $conflict = 0;
-
- if ( $feature =~ m/^-(\w+)$/ ) {
- my $option = lc($1);
-
- # check for a newer version of myself
- _update_to( $modules, @_ ) and return if $option eq 'version';
-
- # sets CPAN configuration options
- $Config = $modules if $option eq 'config';
-
- # promote every features to core status
- $core_all = ( $modules =~ /^all$/i ) and next
- if $option eq 'core';
-
- next unless $option eq 'core';
- }
-
- print "[" . ( $FeatureMap{ lc($feature) } || $feature ) . "]\n";
-
- $modules = [ %{$modules} ] if UNIVERSAL::isa( $modules, 'HASH' );
-
- unshift @$modules, -default => &{ shift(@$modules) }
- if ( ref( $modules->[0] ) eq 'CODE' ); # XXX: bugward combatability
-
- while ( my ( $mod, $arg ) = splice( @$modules, 0, 2 ) ) {
- if ( $mod =~ m/^-(\w+)$/ ) {
- my $option = lc($1);
-
- $default = $arg if ( $option eq 'default' );
- $conflict = $arg if ( $option eq 'conflict' );
- @tests = @{$arg} if ( $option eq 'tests' );
- @skiptests = @{$arg} if ( $option eq 'skiptests' );
-
- next;
- }
-
- printf( "- %-${maxlen}s ...", $mod );
-
- if ( $arg and $arg =~ /^\D/ ) {
- unshift @$modules, $arg;
- $arg = 0;
- }
-
- # XXX: check for conflicts and uninstalls(!) them.
- my $cur = _load($mod);
- if (_version_cmp ($cur, $arg) >= 0)
- {
- print "loaded. ($cur" . ( $arg ? " >= $arg" : '' ) . ")\n";
- push @Existing, $mod => $arg;
- $DisabledTests{$_} = 1 for map { glob($_) } @skiptests;
- }
- else {
- if (not defined $cur) # indeed missing
- {
- print "missing." . ( $arg ? " (would need $arg)" : '' ) . "\n";
- }
- else
- {
- # no need to check $arg as _version_cmp ($cur, undef) would satisfy >= above
- print "too old. ($cur < $arg)\n";
- }
-
- push @required, $mod => $arg;
- }
- }
-
- next unless @required;
-
- my $mandatory = ( $feature eq '-core' or $core_all );
-
- if (
- !$SkipInstall
- and (
- $CheckOnly
- or ($mandatory and $UnderCPAN)
- or $AllDeps
- or $InstallDepsTarget
- or _prompt(
- qq{==> Auto-install the }
- . ( @required / 2 )
- . ( $mandatory ? ' mandatory' : ' optional' )
- . qq{ module(s) from CPAN?},
- $default ? 'y' : 'n',
- ) =~ /^[Yy]/
- )
- )
- {
- push( @Missing, @required );
- $DisabledTests{$_} = 1 for map { glob($_) } @skiptests;
- }
-
- elsif ( !$SkipInstall
- and $default
- and $mandatory
- and
- _prompt( qq{==> The module(s) are mandatory! Really skip?}, 'n', )
- =~ /^[Nn]/ )
- {
- push( @Missing, @required );
- $DisabledTests{$_} = 1 for map { glob($_) } @skiptests;
- }
-
- else {
- $DisabledTests{$_} = 1 for map { glob($_) } @tests;
- }
- }
-
- if ( @Missing and not( $CheckOnly or $UnderCPAN) ) {
- require Config;
- my $make = $Config::Config{make};
- if ($InstallDepsTarget) {
- print
-"*** To install dependencies type '$make installdeps' or '$make installdeps_notest'.\n";
- }
- else {
- print
-"*** Dependencies will be installed the next time you type '$make'.\n";
- }
-
- # make an educated guess of whether we'll need root permission.
- print " (You may need to do that as the 'root' user.)\n"
- if eval '$>';
- }
- print "*** $class configuration finished.\n";
-
- chdir $cwd;
-
- # import to main::
- no strict 'refs';
- *{'main::WriteMakefile'} = \&Write if caller(0) eq 'main';
-
- return (@Existing, @Missing);
-}
-
-sub _running_under {
- my $thing = shift;
- print <<"END_MESSAGE";
-*** Since we're running under ${thing}, I'll just let it take care
- of the dependency's installation later.
-END_MESSAGE
- return 1;
-}
-
-# Check to see if we are currently running under CPAN.pm and/or CPANPLUS;
-# if we are, then we simply let it taking care of our dependencies
-sub _check_lock {
- return unless @Missing or @_;
-
- if ($ENV{PERL5_CPANM_IS_RUNNING}) {
- return _running_under('cpanminus');
- }
-
- my $cpan_env = $ENV{PERL5_CPAN_IS_RUNNING};
-
- if ($ENV{PERL5_CPANPLUS_IS_RUNNING}) {
- return _running_under($cpan_env ? 'CPAN' : 'CPANPLUS');
- }
-
- require CPAN;
-
- if ($CPAN::VERSION > '1.89') {
- if ($cpan_env) {
- return _running_under('CPAN');
- }
- return; # CPAN.pm new enough, don't need to check further
- }
-
- # last ditch attempt, this -will- configure CPAN, very sorry
-
- _load_cpan(1); # force initialize even though it's already loaded
-
- # Find the CPAN lock-file
- my $lock = MM->catfile( $CPAN::Config->{cpan_home}, ".lock" );
- return unless -f $lock;
-
- # Check the lock
- local *LOCK;
- return unless open(LOCK, $lock);
-
- if (
- ( $^O eq 'MSWin32' ? _under_cpan() : <LOCK> == getppid() )
- and ( $CPAN::Config->{prerequisites_policy} || '' ) ne 'ignore'
- ) {
- print <<'END_MESSAGE';
-
-*** Since we're running under CPAN, I'll just let it take care
- of the dependency's installation later.
-END_MESSAGE
- return 1;
- }
-
- close LOCK;
- return;
-}
-
-sub install {
- my $class = shift;
-
- my $i; # used below to strip leading '-' from config keys
- my @config = ( map { s/^-// if ++$i; $_ } @{ +shift } );
-
- my ( @modules, @installed );
- while ( my ( $pkg, $ver ) = splice( @_, 0, 2 ) ) {
-
- # grep out those already installed
- if ( _version_cmp( _load($pkg), $ver ) >= 0 ) {
- push @installed, $pkg;
- }
- else {
- push @modules, $pkg, $ver;
- }
- }
-
- if ($UpgradeDeps) {
- push @modules, @installed;
- @installed = ();
- }
-
- return @installed unless @modules; # nothing to do
- return @installed if _check_lock(); # defer to the CPAN shell
-
- print "*** Installing dependencies...\n";
-
- return unless _connected_to('cpan.org');
-
- my %args = @config;
- my %failed;
- local *FAILED;
- if ( $args{do_once} and open( FAILED, '.#autoinstall.failed' ) ) {
- while (<FAILED>) { chomp; $failed{$_}++ }
- close FAILED;
-
- my @newmod;
- while ( my ( $k, $v ) = splice( @modules, 0, 2 ) ) {
- push @newmod, ( $k => $v ) unless $failed{$k};
- }
- @modules = @newmod;
- }
-
- if ( _has_cpanplus() and not $ENV{PERL_AUTOINSTALL_PREFER_CPAN} ) {
- _install_cpanplus( \@modules, \@config );
- } else {
- _install_cpan( \@modules, \@config );
- }
-
- print "*** $class installation finished.\n";
-
- # see if we have successfully installed them
- while ( my ( $pkg, $ver ) = splice( @modules, 0, 2 ) ) {
- if ( _version_cmp( _load($pkg), $ver ) >= 0 ) {
- push @installed, $pkg;
- }
- elsif ( $args{do_once} and open( FAILED, '>> .#autoinstall.failed' ) ) {
- print FAILED "$pkg\n";
- }
- }
-
- close FAILED if $args{do_once};
-
- return @installed;
-}
-
-sub _install_cpanplus {
- my @modules = @{ +shift };
- my @config = _cpanplus_config( @{ +shift } );
- my $installed = 0;
-
- require CPANPLUS::Backend;
- my $cp = CPANPLUS::Backend->new;
- my $conf = $cp->configure_object;
-
- return unless $conf->can('conf') # 0.05x+ with "sudo" support
- or _can_write($conf->_get_build('base')); # 0.04x
-
- # if we're root, set UNINST=1 to avoid trouble unless user asked for it.
- my $makeflags = $conf->get_conf('makeflags') || '';
- if ( UNIVERSAL::isa( $makeflags, 'HASH' ) ) {
- # 0.03+ uses a hashref here
- $makeflags->{UNINST} = 1 unless exists $makeflags->{UNINST};
-
- } else {
- # 0.02 and below uses a scalar
- $makeflags = join( ' ', split( ' ', $makeflags ), 'UNINST=1' )
- if ( $makeflags !~ /\bUNINST\b/ and eval qq{ $> eq '0' } );
-
- }
- $conf->set_conf( makeflags => $makeflags );
- $conf->set_conf( prereqs => 1 );
-
-
-
- while ( my ( $key, $val ) = splice( @config, 0, 2 ) ) {
- $conf->set_conf( $key, $val );
- }
-
- my $modtree = $cp->module_tree;
- while ( my ( $pkg, $ver ) = splice( @modules, 0, 2 ) ) {
- print "*** Installing $pkg...\n";
-
- MY::preinstall( $pkg, $ver ) or next if defined &MY::preinstall;
-
- my $success;
- my $obj = $modtree->{$pkg};
-
- if ( $obj and _version_cmp( $obj->{version}, $ver ) >= 0 ) {
- my $pathname = $pkg;
- $pathname =~ s/::/\\W/;
-
- foreach my $inc ( grep { m/$pathname.pm/i } keys(%INC) ) {
- delete $INC{$inc};
- }
-
- my $rv = $cp->install( modules => [ $obj->{module} ] );
-
- if ( $rv and ( $rv->{ $obj->{module} } or $rv->{ok} ) ) {
- print "*** $pkg successfully installed.\n";
- $success = 1;
- } else {
- print "*** $pkg installation cancelled.\n";
- $success = 0;
- }
-
- $installed += $success;
- } else {
- print << ".";
-*** Could not find a version $ver or above for $pkg; skipping.
-.
- }
-
- MY::postinstall( $pkg, $ver, $success ) if defined &MY::postinstall;
- }
-
- return $installed;
-}
-
-sub _cpanplus_config {
- my @config = ();
- while ( @_ ) {
- my ($key, $value) = (shift(), shift());
- if ( $key eq 'prerequisites_policy' ) {
- if ( $value eq 'follow' ) {
- $value = CPANPLUS::Internals::Constants::PREREQ_INSTALL();
- } elsif ( $value eq 'ask' ) {
- $value = CPANPLUS::Internals::Constants::PREREQ_ASK();
- } elsif ( $value eq 'ignore' ) {
- $value = CPANPLUS::Internals::Constants::PREREQ_IGNORE();
- } else {
- die "*** Cannot convert option $key = '$value' to CPANPLUS version.\n";
- }
- push @config, 'prereqs', $value;
- } elsif ( $key eq 'force' ) {
- push @config, $key, $value;
- } elsif ( $key eq 'notest' ) {
- push @config, 'skiptest', $value;
- } else {
- die "*** Cannot convert option $key to CPANPLUS version.\n";
- }
- }
- return @config;
-}
-
-sub _install_cpan {
- my @modules = @{ +shift };
- my @config = @{ +shift };
- my $installed = 0;
- my %args;
-
- _load_cpan();
- require Config;
-
- if (CPAN->VERSION < 1.80) {
- # no "sudo" support, probe for writableness
- return unless _can_write( MM->catfile( $CPAN::Config->{cpan_home}, 'sources' ) )
- and _can_write( $Config::Config{sitelib} );
- }
-
- # if we're root, set UNINST=1 to avoid trouble unless user asked for it.
- my $makeflags = $CPAN::Config->{make_install_arg} || '';
- $CPAN::Config->{make_install_arg} =
- join( ' ', split( ' ', $makeflags ), 'UNINST=1' )
- if ( $makeflags !~ /\bUNINST\b/ and eval qq{ $> eq '0' } );
-
- # don't show start-up info
- $CPAN::Config->{inhibit_startup_message} = 1;
-
- # set additional options
- while ( my ( $opt, $arg ) = splice( @config, 0, 2 ) ) {
- ( $args{$opt} = $arg, next )
- if $opt =~ /^(?:force|notest)$/; # pseudo-option
- $CPAN::Config->{$opt} = $arg;
- }
-
- if ($args{notest} && (not CPAN::Shell->can('notest'))) {
- die "Your version of CPAN is too old to support the 'notest' pragma";
- }
-
- local $CPAN::Config->{prerequisites_policy} = 'follow';
-
- while ( my ( $pkg, $ver ) = splice( @modules, 0, 2 ) ) {
- MY::preinstall( $pkg, $ver ) or next if defined &MY::preinstall;
-
- print "*** Installing $pkg...\n";
-
- my $obj = CPAN::Shell->expand( Module => $pkg );
- my $success = 0;
-
- if ( $obj and _version_cmp( $obj->cpan_version, $ver ) >= 0 ) {
- my $pathname = $pkg;
- $pathname =~ s/::/\\W/;
-
- foreach my $inc ( grep { m/$pathname.pm/i } keys(%INC) ) {
- delete $INC{$inc};
- }
-
- my $rv = do {
- if ($args{force}) {
- CPAN::Shell->force( install => $pkg )
- } elsif ($args{notest}) {
- CPAN::Shell->notest( install => $pkg )
- } else {
- CPAN::Shell->install($pkg)
- }
- };
-
- $rv ||= eval {
- $CPAN::META->instance( 'CPAN::Distribution', $obj->cpan_file, )
- ->{install}
- if $CPAN::META;
- };
-
- if ( $rv eq 'YES' ) {
- print "*** $pkg successfully installed.\n";
- $success = 1;
- }
- else {
- print "*** $pkg installation failed.\n";
- $success = 0;
- }
-
- $installed += $success;
- }
- else {
- print << ".";
-*** Could not find a version $ver or above for $pkg; skipping.
-.
- }
-
- MY::postinstall( $pkg, $ver, $success ) if defined &MY::postinstall;
- }
-
- return $installed;
-}
-
-sub _has_cpanplus {
- return (
- $HasCPANPLUS = (
- $INC{'CPANPLUS/Config.pm'}
- or _load('CPANPLUS::Shell::Default')
- )
- );
-}
-
-# make guesses on whether we're under the CPAN installation directory
-sub _under_cpan {
- require Cwd;
- require File::Spec;
-
- my $cwd = File::Spec->canonpath( Cwd::cwd() );
- my $cpan = File::Spec->canonpath( $CPAN::Config->{cpan_home} );
-
- return ( index( $cwd, $cpan ) > -1 );
-}
-
-sub _update_to {
- my $class = __PACKAGE__;
- my $ver = shift;
-
- return
- if _version_cmp( _load($class), $ver ) >= 0; # no need to upgrade
-
- if (
- _prompt( "==> A newer version of $class ($ver) is required. Install?",
- 'y' ) =~ /^[Nn]/
- )
- {
- die "*** Please install $class $ver manually.\n";
- }
-
- print << ".";
-*** Trying to fetch it from CPAN...
-.
-
- # install ourselves
- _load($class) and return $class->import(@_)
- if $class->install( [], $class, $ver );
-
- print << '.'; exit 1;
-
-*** Cannot bootstrap myself. :-( Installation terminated.
-.
-}
-
-# check if we're connected to some host, using inet_aton
-sub _connected_to {
- my $site = shift;
-
- return (
- ( _load('Socket') and Socket::inet_aton($site) ) or _prompt(
- qq(
-*** Your host cannot resolve the domain name '$site', which
- probably means the Internet connections are unavailable.
-==> Should we try to install the required module(s) anyway?), 'n'
- ) =~ /^[Yy]/
- );
-}
-
-# check if a directory is writable; may create it on demand
-sub _can_write {
- my $path = shift;
- mkdir( $path, 0755 ) unless -e $path;
-
- return 1 if -w $path;
-
- print << ".";
-*** You are not allowed to write to the directory '$path';
- the installation may fail due to insufficient permissions.
-.
-
- if (
- eval '$>' and lc(`sudo -V`) =~ /version/ and _prompt(
- qq(
-==> Should we try to re-execute the autoinstall process with 'sudo'?),
- ((-t STDIN) ? 'y' : 'n')
- ) =~ /^[Yy]/
- )
- {
-
- # try to bootstrap ourselves from sudo
- print << ".";
-*** Trying to re-execute the autoinstall process with 'sudo'...
-.
- my $missing = join( ',', @Missing );
- my $config = join( ',',
- UNIVERSAL::isa( $Config, 'HASH' ) ? %{$Config} : @{$Config} )
- if $Config;
-
- return
- unless system( 'sudo', $^X, $0, "--config=$config",
- "--installdeps=$missing" );
-
- print << ".";
-*** The 'sudo' command exited with error! Resuming...
-.
- }
-
- return _prompt(
- qq(
-==> Should we try to install the required module(s) anyway?), 'n'
- ) =~ /^[Yy]/;
-}
-
-# load a module and return the version it reports
-sub _load {
- my $mod = pop; # class/instance doesn't matter
- my $file = $mod;
-
- $file =~ s|::|/|g;
- $file .= '.pm';
-
- local $@;
- return eval { require $file; $mod->VERSION } || ( $@ ? undef: 0 );
-}
-
-# Load CPAN.pm and it's configuration
-sub _load_cpan {
- return if $CPAN::VERSION and $CPAN::Config and not @_;
- require CPAN;
-
- # CPAN-1.82+ adds CPAN::Config::AUTOLOAD to redirect to
- # CPAN::HandleConfig->load. CPAN reports that the redirection
- # is deprecated in a warning printed at the user.
-
- # CPAN-1.81 expects CPAN::HandleConfig->load, does not have
- # $CPAN::HandleConfig::VERSION but cannot handle
- # CPAN::Config->load
-
- # Which "versions expect CPAN::Config->load?
-
- if ( $CPAN::HandleConfig::VERSION
- || CPAN::HandleConfig->can('load')
- ) {
- # Newer versions of CPAN have a HandleConfig module
- CPAN::HandleConfig->load;
- } else {
- # Older versions had the load method in Config directly
- CPAN::Config->load;
- }
-}
-
-# compare two versions, either use Sort::Versions or plain comparison
-# return values same as <=>
-sub _version_cmp {
- my ( $cur, $min ) = @_;
- return -1 unless defined $cur; # if 0 keep comparing
- return 1 unless $min;
-
- $cur =~ s/\s+$//;
-
- # check for version numbers that are not in decimal format
- if ( ref($cur) or ref($min) or $cur =~ /v|\..*\./ or $min =~ /v|\..*\./ ) {
- if ( ( $version::VERSION or defined( _load('version') )) and
- version->can('new')
- ) {
-
- # use version.pm if it is installed.
- return version->new($cur) <=> version->new($min);
- }
- elsif ( $Sort::Versions::VERSION or defined( _load('Sort::Versions') ) )
- {
-
- # use Sort::Versions as the sorting algorithm for a.b.c versions
- return Sort::Versions::versioncmp( $cur, $min );
- }
-
- warn "Cannot reliably compare non-decimal formatted versions.\n"
- . "Please install version.pm or Sort::Versions.\n";
- }
-
- # plain comparison
- local $^W = 0; # shuts off 'not numeric' bugs
- return $cur <=> $min;
-}
-
-# nothing; this usage is deprecated.
-sub main::PREREQ_PM { return {}; }
-
-sub _make_args {
- my %args = @_;
-
- $args{PREREQ_PM} = { %{ $args{PREREQ_PM} || {} }, @Existing, @Missing }
- if $UnderCPAN or $TestOnly;
-
- if ( $args{EXE_FILES} and -e 'MANIFEST' ) {
- require ExtUtils::Manifest;
- my $manifest = ExtUtils::Manifest::maniread('MANIFEST');
-
- $args{EXE_FILES} =
- [ grep { exists $manifest->{$_} } @{ $args{EXE_FILES} } ];
- }
-
- $args{test}{TESTS} ||= 't/*.t';
- $args{test}{TESTS} = join( ' ',
- grep { !exists( $DisabledTests{$_} ) }
- map { glob($_) } split( /\s+/, $args{test}{TESTS} ) );
-
- my $missing = join( ',', @Missing );
- my $config =
- join( ',', UNIVERSAL::isa( $Config, 'HASH' ) ? %{$Config} : @{$Config} )
- if $Config;
-
- $PostambleActions = (
- ($missing and not $UnderCPAN)
- ? "\$(PERL) $0 --config=$config --installdeps=$missing"
- : "\$(NOECHO) \$(NOOP)"
- );
-
- my $deps_list = join( ',', @Missing, @Existing );
-
- $PostambleActionsUpgradeDeps =
- "\$(PERL) $0 --config=$config --upgradedeps=$deps_list";
-
- my $config_notest =
- join( ',', (UNIVERSAL::isa( $Config, 'HASH' ) ? %{$Config} : @{$Config}),
- 'notest', 1 )
- if $Config;
-
- $PostambleActionsNoTest = (
- ($missing and not $UnderCPAN)
- ? "\$(PERL) $0 --config=$config_notest --installdeps=$missing"
- : "\$(NOECHO) \$(NOOP)"
- );
-
- $PostambleActionsUpgradeDepsNoTest =
- "\$(PERL) $0 --config=$config_notest --upgradedeps=$deps_list";
-
- $PostambleActionsListDeps =
- '@$(PERL) -le "print for @ARGV" '
- . join(' ', map $Missing[$_], grep $_ % 2 == 0, 0..$#Missing);
-
- my @all = (@Missing, @Existing);
-
- $PostambleActionsListAllDeps =
- '@$(PERL) -le "print for @ARGV" '
- . join(' ', map $all[$_], grep $_ % 2 == 0, 0..$#all);
-
- return %args;
-}
-
-# a wrapper to ExtUtils::MakeMaker::WriteMakefile
-sub Write {
- require Carp;
- Carp::croak "WriteMakefile: Need even number of args" if @_ % 2;
-
- if ($CheckOnly) {
- print << ".";
-*** Makefile not written in check-only mode.
-.
- return;
- }
-
- my %args = _make_args(@_);
-
- no strict 'refs';
-
- $PostambleUsed = 0;
- local *MY::postamble = \&postamble unless defined &MY::postamble;
- ExtUtils::MakeMaker::WriteMakefile(%args);
-
- print << "." unless $PostambleUsed;
-*** WARNING: Makefile written with customized MY::postamble() without
- including contents from Module::AutoInstall::postamble() --
- auto installation features disabled. Please contact the author.
-.
-
- return 1;
-}
-
-sub postamble {
- $PostambleUsed = 1;
- my $fragment;
-
- $fragment .= <<"AUTO_INSTALL" if !$InstallDepsTarget;
-
-config :: installdeps
-\t\$(NOECHO) \$(NOOP)
-AUTO_INSTALL
-
- $fragment .= <<"END_MAKE";
-
-checkdeps ::
-\t\$(PERL) $0 --checkdeps
-
-installdeps ::
-\t$PostambleActions
-
-installdeps_notest ::
-\t$PostambleActionsNoTest
-
-upgradedeps ::
-\t$PostambleActionsUpgradeDeps
-
-upgradedeps_notest ::
-\t$PostambleActionsUpgradeDepsNoTest
-
-listdeps ::
-\t$PostambleActionsListDeps
-
-listalldeps ::
-\t$PostambleActionsListAllDeps
-
-END_MAKE
-
- return $fragment;
-}
-
-1;
-
-__END__
-
-#line 1178
@@ -1,93 +0,0 @@
-#line 1
-package Module::Install::AutoInstall;
-
-use strict;
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-sub AutoInstall { $_[0] }
-
-sub run {
- my $self = shift;
- $self->auto_install_now(@_);
-}
-
-sub write {
- my $self = shift;
- $self->auto_install(@_);
-}
-
-sub auto_install {
- my $self = shift;
- return if $self->{done}++;
-
- # Flatten array of arrays into a single array
- my @core = map @$_, map @$_, grep ref,
- $self->build_requires, $self->requires;
-
- my @config = @_;
-
- # We'll need Module::AutoInstall
- $self->include('Module::AutoInstall');
- require Module::AutoInstall;
-
- my @features_require = Module::AutoInstall->import(
- (@config ? (-config => \@config) : ()),
- (@core ? (-core => \@core) : ()),
- $self->features,
- );
-
- my %seen;
- my @requires = map @$_, map @$_, grep ref, $self->requires;
- while (my ($mod, $ver) = splice(@requires, 0, 2)) {
- $seen{$mod}{$ver}++;
- }
- my @build_requires = map @$_, map @$_, grep ref, $self->build_requires;
- while (my ($mod, $ver) = splice(@build_requires, 0, 2)) {
- $seen{$mod}{$ver}++;
- }
- my @configure_requires = map @$_, map @$_, grep ref, $self->configure_requires;
- while (my ($mod, $ver) = splice(@configure_requires, 0, 2)) {
- $seen{$mod}{$ver}++;
- }
-
- my @deduped;
- while (my ($mod, $ver) = splice(@features_require, 0, 2)) {
- push @deduped, $mod => $ver unless $seen{$mod}{$ver}++;
- }
-
- $self->requires(@deduped);
-
- $self->makemaker_args( Module::AutoInstall::_make_args() );
-
- my $class = ref($self);
- $self->postamble(
- "# --- $class section:\n" .
- Module::AutoInstall::postamble()
- );
-}
-
-sub installdeps_target {
- my ($self, @args) = @_;
-
- $self->include('Module::AutoInstall');
- require Module::AutoInstall;
-
- Module::AutoInstall::_installdeps_target(1);
-
- $self->auto_install(@args);
-}
-
-sub auto_install_now {
- my $self = shift;
- $self->auto_install(@_);
- Module::AutoInstall::do_install();
-}
-
-1;
@@ -1,83 +0,0 @@
-#line 1
-package Module::Install::Base;
-
-use strict 'vars';
-use vars qw{$VERSION};
-BEGIN {
- $VERSION = '1.04';
-}
-
-# Suspend handler for "redefined" warnings
-BEGIN {
- my $w = $SIG{__WARN__};
- $SIG{__WARN__} = sub { $w };
-}
-
-#line 42
-
-sub new {
- my $class = shift;
- unless ( defined &{"${class}::call"} ) {
- *{"${class}::call"} = sub { shift->_top->call(@_) };
- }
- unless ( defined &{"${class}::load"} ) {
- *{"${class}::load"} = sub { shift->_top->load(@_) };
- }
- bless { @_ }, $class;
-}
-
-#line 61
-
-sub AUTOLOAD {
- local $@;
- my $func = eval { shift->_top->autoload } or return;
- goto &$func;
-}
-
-#line 75
-
-sub _top {
- $_[0]->{_top};
-}
-
-#line 90
-
-sub admin {
- $_[0]->_top->{admin}
- or
- Module::Install::Base::FakeAdmin->new;
-}
-
-#line 106
-
-sub is_admin {
- ! $_[0]->admin->isa('Module::Install::Base::FakeAdmin');
-}
-
-sub DESTROY {}
-
-package Module::Install::Base::FakeAdmin;
-
-use vars qw{$VERSION};
-BEGIN {
- $VERSION = $Module::Install::Base::VERSION;
-}
-
-my $fake;
-
-sub new {
- $fake ||= bless(\@_, $_[0]);
-}
-
-sub AUTOLOAD {}
-
-sub DESTROY {}
-
-# Restore warning handler
-BEGIN {
- $SIG{__WARN__} = $SIG{__WARN__}->();
-}
-
-1;
-
-#line 159
@@ -1,81 +0,0 @@
-#line 1
-package Module::Install::Can;
-
-use strict;
-use Config ();
-use File::Spec ();
-use ExtUtils::MakeMaker ();
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-# check if we can load some module
-### Upgrade this to not have to load the module if possible
-sub can_use {
- my ($self, $mod, $ver) = @_;
- $mod =~ s{::|\\}{/}g;
- $mod .= '.pm' unless $mod =~ /\.pm$/i;
-
- my $pkg = $mod;
- $pkg =~ s{/}{::}g;
- $pkg =~ s{\.pm$}{}i;
-
- local $@;
- eval { require $mod; $pkg->VERSION($ver || 0); 1 };
-}
-
-# check if we can run some command
-sub can_run {
- my ($self, $cmd) = @_;
-
- my $_cmd = $cmd;
- return $_cmd if (-x $_cmd or $_cmd = MM->maybe_command($_cmd));
-
- for my $dir ((split /$Config::Config{path_sep}/, $ENV{PATH}), '.') {
- next if $dir eq '';
- my $abs = File::Spec->catfile($dir, $_[1]);
- return $abs if (-x $abs or $abs = MM->maybe_command($abs));
- }
-
- return;
-}
-
-# can we locate a (the) C compiler
-sub can_cc {
- my $self = shift;
- my @chunks = split(/ /, $Config::Config{cc}) or return;
-
- # $Config{cc} may contain args; try to find out the program part
- while (@chunks) {
- return $self->can_run("@chunks") || (pop(@chunks), next);
- }
-
- return;
-}
-
-# Fix Cygwin bug on maybe_command();
-if ( $^O eq 'cygwin' ) {
- require ExtUtils::MM_Cygwin;
- require ExtUtils::MM_Win32;
- if ( ! defined(&ExtUtils::MM_Cygwin::maybe_command) ) {
- *ExtUtils::MM_Cygwin::maybe_command = sub {
- my ($self, $file) = @_;
- if ($file =~ m{^/cygdrive/}i and ExtUtils::MM_Win32->can('maybe_command')) {
- ExtUtils::MM_Win32->maybe_command($file);
- } else {
- ExtUtils::MM_Unix->maybe_command($file);
- }
- }
- }
-}
-
-1;
-
-__END__
-
-#line 156
@@ -1,93 +0,0 @@
-#line 1
-package Module::Install::Fetch;
-
-use strict;
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-sub get_file {
- my ($self, %args) = @_;
- my ($scheme, $host, $path, $file) =
- $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
-
- if ( $scheme eq 'http' and ! eval { require LWP::Simple; 1 } ) {
- $args{url} = $args{ftp_url}
- or (warn("LWP support unavailable!\n"), return);
- ($scheme, $host, $path, $file) =
- $args{url} =~ m|^(\w+)://([^/]+)(.+)/(.+)| or return;
- }
-
- $|++;
- print "Fetching '$file' from $host... ";
-
- unless (eval { require Socket; Socket::inet_aton($host) }) {
- warn "'$host' resolve failed!\n";
- return;
- }
-
- return unless $scheme eq 'ftp' or $scheme eq 'http';
-
- require Cwd;
- my $dir = Cwd::getcwd();
- chdir $args{local_dir} or return if exists $args{local_dir};
-
- if (eval { require LWP::Simple; 1 }) {
- LWP::Simple::mirror($args{url}, $file);
- }
- elsif (eval { require Net::FTP; 1 }) { eval {
- # use Net::FTP to get past firewall
- my $ftp = Net::FTP->new($host, Passive => 1, Timeout => 600);
- $ftp->login("anonymous", 'anonymous@example.com');
- $ftp->cwd($path);
- $ftp->binary;
- $ftp->get($file) or (warn("$!\n"), return);
- $ftp->quit;
- } }
- elsif (my $ftp = $self->can_run('ftp')) { eval {
- # no Net::FTP, fallback to ftp.exe
- require FileHandle;
- my $fh = FileHandle->new;
-
- local $SIG{CHLD} = 'IGNORE';
- unless ($fh->open("|$ftp -n")) {
- warn "Couldn't open ftp: $!\n";
- chdir $dir; return;
- }
-
- my @dialog = split(/\n/, <<"END_FTP");
-open $host
-user anonymous anonymous\@example.com
-cd $path
-binary
-get $file $file
-quit
-END_FTP
- foreach (@dialog) { $fh->print("$_\n") }
- $fh->close;
- } }
- else {
- warn "No working 'ftp' program available!\n";
- chdir $dir; return;
- }
-
- unless (-f $file) {
- warn "Fetching failed: $@\n";
- chdir $dir; return;
- }
-
- return if exists $args{size} and -s $file != $args{size};
- system($args{run}) if exists $args{run};
- unlink($file) if $args{remove};
-
- print(((!exists $args{check_for} or -e $args{check_for})
- ? "done!" : "failed! ($!)"), "\n");
- chdir $dir; return !$?;
-}
-
-1;
@@ -1,34 +0,0 @@
-#line 1
-package Module::Install::Include;
-
-use strict;
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-sub include {
- shift()->admin->include(@_);
-}
-
-sub include_deps {
- shift()->admin->include_deps(@_);
-}
-
-sub auto_include {
- shift()->admin->auto_include(@_);
-}
-
-sub auto_include_deps {
- shift()->admin->auto_include_deps(@_);
-}
-
-sub auto_include_dependent_dists {
- shift()->admin->auto_include_dependent_dists(@_);
-}
-
-1;
@@ -1,414 +0,0 @@
-#line 1
-package Module::Install::Makefile;
-
-use strict 'vars';
-use ExtUtils::MakeMaker ();
-use Module::Install::Base ();
-use Fcntl qw/:flock :seek/;
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-sub Makefile { $_[0] }
-
-my %seen = ();
-
-sub prompt {
- shift;
-
- # Infinite loop protection
- my @c = caller();
- if ( ++$seen{"$c[1]|$c[2]|$_[0]"} > 3 ) {
- die "Caught an potential prompt infinite loop ($c[1]|$c[2]|$_[0])";
- }
-
- # In automated testing or non-interactive session, always use defaults
- if ( ($ENV{AUTOMATED_TESTING} or -! -t STDIN) and ! $ENV{PERL_MM_USE_DEFAULT} ) {
- local $ENV{PERL_MM_USE_DEFAULT} = 1;
- goto &ExtUtils::MakeMaker::prompt;
- } else {
- goto &ExtUtils::MakeMaker::prompt;
- }
-}
-
-# Store a cleaned up version of the MakeMaker version,
-# since we need to behave differently in a variety of
-# ways based on the MM version.
-my $makemaker = eval $ExtUtils::MakeMaker::VERSION;
-
-# If we are passed a param, do a "newer than" comparison.
-# Otherwise, just return the MakeMaker version.
-sub makemaker {
- ( @_ < 2 or $makemaker >= eval($_[1]) ) ? $makemaker : 0
-}
-
-# Ripped from ExtUtils::MakeMaker 6.56, and slightly modified
-# as we only need to know here whether the attribute is an array
-# or a hash or something else (which may or may not be appendable).
-my %makemaker_argtype = (
- C => 'ARRAY',
- CONFIG => 'ARRAY',
-# CONFIGURE => 'CODE', # ignore
- DIR => 'ARRAY',
- DL_FUNCS => 'HASH',
- DL_VARS => 'ARRAY',
- EXCLUDE_EXT => 'ARRAY',
- EXE_FILES => 'ARRAY',
- FUNCLIST => 'ARRAY',
- H => 'ARRAY',
- IMPORTS => 'HASH',
- INCLUDE_EXT => 'ARRAY',
- LIBS => 'ARRAY', # ignore ''
- MAN1PODS => 'HASH',
- MAN3PODS => 'HASH',
- META_ADD => 'HASH',
- META_MERGE => 'HASH',
- PL_FILES => 'HASH',
- PM => 'HASH',
- PMLIBDIRS => 'ARRAY',
- PMLIBPARENTDIRS => 'ARRAY',
- PREREQ_PM => 'HASH',
- CONFIGURE_REQUIRES => 'HASH',
- SKIP => 'ARRAY',
- TYPEMAPS => 'ARRAY',
- XS => 'HASH',
-# VERSION => ['version',''], # ignore
-# _KEEP_AFTER_FLUSH => '',
-
- clean => 'HASH',
- depend => 'HASH',
- dist => 'HASH',
- dynamic_lib=> 'HASH',
- linkext => 'HASH',
- macro => 'HASH',
- postamble => 'HASH',
- realclean => 'HASH',
- test => 'HASH',
- tool_autosplit => 'HASH',
-
- # special cases where you can use makemaker_append
- CCFLAGS => 'APPENDABLE',
- DEFINE => 'APPENDABLE',
- INC => 'APPENDABLE',
- LDDLFLAGS => 'APPENDABLE',
- LDFROM => 'APPENDABLE',
-);
-
-sub makemaker_args {
- my ($self, %new_args) = @_;
- my $args = ( $self->{makemaker_args} ||= {} );
- foreach my $key (keys %new_args) {
- if ($makemaker_argtype{$key}) {
- if ($makemaker_argtype{$key} eq 'ARRAY') {
- $args->{$key} = [] unless defined $args->{$key};
- unless (ref $args->{$key} eq 'ARRAY') {
- $args->{$key} = [$args->{$key}]
- }
- push @{$args->{$key}},
- ref $new_args{$key} eq 'ARRAY'
- ? @{$new_args{$key}}
- : $new_args{$key};
- }
- elsif ($makemaker_argtype{$key} eq 'HASH') {
- $args->{$key} = {} unless defined $args->{$key};
- foreach my $skey (keys %{ $new_args{$key} }) {
- $args->{$key}{$skey} = $new_args{$key}{$skey};
- }
- }
- elsif ($makemaker_argtype{$key} eq 'APPENDABLE') {
- $self->makemaker_append($key => $new_args{$key});
- }
- }
- else {
- if (defined $args->{$key}) {
- warn qq{MakeMaker attribute "$key" is overriden; use "makemaker_append" to append values\n};
- }
- $args->{$key} = $new_args{$key};
- }
- }
- return $args;
-}
-
-# For mm args that take multiple space-seperated args,
-# append an argument to the current list.
-sub makemaker_append {
- my $self = shift;
- my $name = shift;
- my $args = $self->makemaker_args;
- $args->{$name} = defined $args->{$name}
- ? join( ' ', $args->{$name}, @_ )
- : join( ' ', @_ );
-}
-
-sub build_subdirs {
- my $self = shift;
- my $subdirs = $self->makemaker_args->{DIR} ||= [];
- for my $subdir (@_) {
- push @$subdirs, $subdir;
- }
-}
-
-sub clean_files {
- my $self = shift;
- my $clean = $self->makemaker_args->{clean} ||= {};
- %$clean = (
- %$clean,
- FILES => join ' ', grep { length $_ } ($clean->{FILES} || (), @_),
- );
-}
-
-sub realclean_files {
- my $self = shift;
- my $realclean = $self->makemaker_args->{realclean} ||= {};
- %$realclean = (
- %$realclean,
- FILES => join ' ', grep { length $_ } ($realclean->{FILES} || (), @_),
- );
-}
-
-sub libs {
- my $self = shift;
- my $libs = ref $_[0] ? shift : [ shift ];
- $self->makemaker_args( LIBS => $libs );
-}
-
-sub inc {
- my $self = shift;
- $self->makemaker_args( INC => shift );
-}
-
-sub _wanted_t {
-}
-
-sub tests_recursive {
- my $self = shift;
- my $dir = shift || 't';
- unless ( -d $dir ) {
- die "tests_recursive dir '$dir' does not exist";
- }
- my %tests = map { $_ => 1 } split / /, ($self->tests || '');
- require File::Find;
- File::Find::find(
- sub { /\.t$/ and -f $_ and $tests{"$File::Find::dir/*.t"} = 1 },
- $dir
- );
- $self->tests( join ' ', sort keys %tests );
-}
-
-sub write {
- my $self = shift;
- die "&Makefile->write() takes no arguments\n" if @_;
-
- # Check the current Perl version
- my $perl_version = $self->perl_version;
- if ( $perl_version ) {
- eval "use $perl_version; 1"
- or die "ERROR: perl: Version $] is installed, "
- . "but we need version >= $perl_version";
- }
-
- # Make sure we have a new enough MakeMaker
- require ExtUtils::MakeMaker;
-
- if ( $perl_version and $self->_cmp($perl_version, '5.006') >= 0 ) {
- # MakeMaker can complain about module versions that include
- # an underscore, even though its own version may contain one!
- # Hence the funny regexp to get rid of it. See RT #35800
- # for details.
- my ($v) = $ExtUtils::MakeMaker::VERSION =~ /^(\d+\.\d+)/;
- $self->build_requires( 'ExtUtils::MakeMaker' => $v );
- $self->configure_requires( 'ExtUtils::MakeMaker' => $v );
- } else {
- # Allow legacy-compatibility with 5.005 by depending on the
- # most recent EU:MM that supported 5.005.
- $self->build_requires( 'ExtUtils::MakeMaker' => 6.36 );
- $self->configure_requires( 'ExtUtils::MakeMaker' => 6.36 );
- }
-
- # Generate the MakeMaker params
- my $args = $self->makemaker_args;
- $args->{DISTNAME} = $self->name;
- $args->{NAME} = $self->module_name || $self->name;
- $args->{NAME} =~ s/-/::/g;
- $args->{VERSION} = $self->version or die <<'EOT';
-ERROR: Can't determine distribution version. Please specify it
-explicitly via 'version' in Makefile.PL, or set a valid $VERSION
-in a module, and provide its file path via 'version_from' (or
-'all_from' if you prefer) in Makefile.PL.
-EOT
-
- if ( $self->tests ) {
- my @tests = split ' ', $self->tests;
- my %seen;
- $args->{test} = {
- TESTS => (join ' ', grep {!$seen{$_}++} @tests),
- };
- } elsif ( $Module::Install::ExtraTests::use_extratests ) {
- # Module::Install::ExtraTests doesn't set $self->tests and does its own tests via harness.
- # So, just ignore our xt tests here.
- } elsif ( -d 'xt' and ($Module::Install::AUTHOR or $ENV{RELEASE_TESTING}) ) {
- $args->{test} = {
- TESTS => join( ' ', map { "$_/*.t" } grep { -d $_ } qw{ t xt } ),
- };
- }
- if ( $] >= 5.005 ) {
- $args->{ABSTRACT} = $self->abstract;
- $args->{AUTHOR} = join ', ', @{$self->author || []};
- }
- if ( $self->makemaker(6.10) ) {
- $args->{NO_META} = 1;
- #$args->{NO_MYMETA} = 1;
- }
- if ( $self->makemaker(6.17) and $self->sign ) {
- $args->{SIGN} = 1;
- }
- unless ( $self->is_admin ) {
- delete $args->{SIGN};
- }
- if ( $self->makemaker(6.31) and $self->license ) {
- $args->{LICENSE} = $self->license;
- }
-
- my $prereq = ($args->{PREREQ_PM} ||= {});
- %$prereq = ( %$prereq,
- map { @$_ } # flatten [module => version]
- map { @$_ }
- grep $_,
- ($self->requires)
- );
-
- # Remove any reference to perl, PREREQ_PM doesn't support it
- delete $args->{PREREQ_PM}->{perl};
-
- # Merge both kinds of requires into BUILD_REQUIRES
- my $build_prereq = ($args->{BUILD_REQUIRES} ||= {});
- %$build_prereq = ( %$build_prereq,
- map { @$_ } # flatten [module => version]
- map { @$_ }
- grep $_,
- ($self->configure_requires, $self->build_requires)
- );
-
- # Remove any reference to perl, BUILD_REQUIRES doesn't support it
- delete $args->{BUILD_REQUIRES}->{perl};
-
- # Delete bundled dists from prereq_pm, add it to Makefile DIR
- my $subdirs = ($args->{DIR} || []);
- if ($self->bundles) {
- my %processed;
- foreach my $bundle (@{ $self->bundles }) {
- my ($mod_name, $dist_dir) = @$bundle;
- delete $prereq->{$mod_name};
- $dist_dir = File::Basename::basename($dist_dir); # dir for building this module
- if (not exists $processed{$dist_dir}) {
- if (-d $dist_dir) {
- # List as sub-directory to be processed by make
- push @$subdirs, $dist_dir;
- }
- # Else do nothing: the module is already present on the system
- $processed{$dist_dir} = undef;
- }
- }
- }
-
- unless ( $self->makemaker('6.55_03') ) {
- %$prereq = (%$prereq,%$build_prereq);
- delete $args->{BUILD_REQUIRES};
- }
-
- if ( my $perl_version = $self->perl_version ) {
- eval "use $perl_version; 1"
- or die "ERROR: perl: Version $] is installed, "
- . "but we need version >= $perl_version";
-
- if ( $self->makemaker(6.48) ) {
- $args->{MIN_PERL_VERSION} = $perl_version;
- }
- }
-
- if ($self->installdirs) {
- warn qq{old INSTALLDIRS (probably set by makemaker_args) is overriden by installdirs\n} if $args->{INSTALLDIRS};
- $args->{INSTALLDIRS} = $self->installdirs;
- }
-
- my %args = map {
- ( $_ => $args->{$_} ) } grep {defined($args->{$_} )
- } keys %$args;
-
- my $user_preop = delete $args{dist}->{PREOP};
- if ( my $preop = $self->admin->preop($user_preop) ) {
- foreach my $key ( keys %$preop ) {
- $args{dist}->{$key} = $preop->{$key};
- }
- }
-
- my $mm = ExtUtils::MakeMaker::WriteMakefile(%args);
- $self->fix_up_makefile($mm->{FIRST_MAKEFILE} || 'Makefile');
-}
-
-sub fix_up_makefile {
- my $self = shift;
- my $makefile_name = shift;
- my $top_class = ref($self->_top) || '';
- my $top_version = $self->_top->VERSION || '';
-
- my $preamble = $self->preamble
- ? "# Preamble by $top_class $top_version\n"
- . $self->preamble
- : '';
- my $postamble = "# Postamble by $top_class $top_version\n"
- . ($self->postamble || '');
-
- local *MAKEFILE;
- open MAKEFILE, "+< $makefile_name" or die "fix_up_makefile: Couldn't open $makefile_name: $!";
- eval { flock MAKEFILE, LOCK_EX };
- my $makefile = do { local $/; <MAKEFILE> };
-
- $makefile =~ s/\b(test_harness\(\$\(TEST_VERBOSE\), )/$1'inc', /;
- $makefile =~ s/( -I\$\(INST_ARCHLIB\))/ -Iinc$1/g;
- $makefile =~ s/( "-I\$\(INST_LIB\)")/ "-Iinc"$1/g;
- $makefile =~ s/^(FULLPERL = .*)/$1 "-Iinc"/m;
- $makefile =~ s/^(PERL = .*)/$1 "-Iinc"/m;
-
- # Module::Install will never be used to build the Core Perl
- # Sometimes PERL_LIB and PERL_ARCHLIB get written anyway, which breaks
- # PREFIX/PERL5LIB, and thus, install_share. Blank them if they exist
- $makefile =~ s/^PERL_LIB = .+/PERL_LIB =/m;
- #$makefile =~ s/^PERL_ARCHLIB = .+/PERL_ARCHLIB =/m;
-
- # Perl 5.005 mentions PERL_LIB explicitly, so we have to remove that as well.
- $makefile =~ s/(\"?)-I\$\(PERL_LIB\)\1//g;
-
- # XXX - This is currently unused; not sure if it breaks other MM-users
- # $makefile =~ s/^pm_to_blib\s+:\s+/pm_to_blib :: /mg;
-
- seek MAKEFILE, 0, SEEK_SET;
- truncate MAKEFILE, 0;
- print MAKEFILE "$preamble$makefile$postamble" or die $!;
- close MAKEFILE or die $!;
-
- 1;
-}
-
-sub preamble {
- my ($self, $text) = @_;
- $self->{preamble} = $text . $self->{preamble} if defined $text;
- $self->{preamble};
-}
-
-sub postamble {
- my ($self, $text) = @_;
- $self->{postamble} ||= $self->admin->postamble;
- $self->{postamble} .= $text if defined $text;
- $self->{postamble}
-}
-
-1;
-
-__END__
-
-#line 540
@@ -1,722 +0,0 @@
-#line 1
-package Module::Install::Metadata;
-
-use strict 'vars';
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-my @boolean_keys = qw{
- sign
-};
-
-my @scalar_keys = qw{
- name
- module_name
- abstract
- version
- distribution_type
- tests
- installdirs
-};
-
-my @tuple_keys = qw{
- configure_requires
- build_requires
- requires
- recommends
- bundles
- resources
-};
-
-my @resource_keys = qw{
- homepage
- bugtracker
- repository
-};
-
-my @array_keys = qw{
- keywords
- author
-};
-
-*authors = \&author;
-
-sub Meta { shift }
-sub Meta_BooleanKeys { @boolean_keys }
-sub Meta_ScalarKeys { @scalar_keys }
-sub Meta_TupleKeys { @tuple_keys }
-sub Meta_ResourceKeys { @resource_keys }
-sub Meta_ArrayKeys { @array_keys }
-
-foreach my $key ( @boolean_keys ) {
- *$key = sub {
- my $self = shift;
- if ( defined wantarray and not @_ ) {
- return $self->{values}->{$key};
- }
- $self->{values}->{$key} = ( @_ ? $_[0] : 1 );
- return $self;
- };
-}
-
-foreach my $key ( @scalar_keys ) {
- *$key = sub {
- my $self = shift;
- return $self->{values}->{$key} if defined wantarray and !@_;
- $self->{values}->{$key} = shift;
- return $self;
- };
-}
-
-foreach my $key ( @array_keys ) {
- *$key = sub {
- my $self = shift;
- return $self->{values}->{$key} if defined wantarray and !@_;
- $self->{values}->{$key} ||= [];
- push @{$self->{values}->{$key}}, @_;
- return $self;
- };
-}
-
-foreach my $key ( @resource_keys ) {
- *$key = sub {
- my $self = shift;
- unless ( @_ ) {
- return () unless $self->{values}->{resources};
- return map { $_->[1] }
- grep { $_->[0] eq $key }
- @{ $self->{values}->{resources} };
- }
- return $self->{values}->{resources}->{$key} unless @_;
- my $uri = shift or die(
- "Did not provide a value to $key()"
- );
- $self->resources( $key => $uri );
- return 1;
- };
-}
-
-foreach my $key ( grep { $_ ne "resources" } @tuple_keys) {
- *$key = sub {
- my $self = shift;
- return $self->{values}->{$key} unless @_;
- my @added;
- while ( @_ ) {
- my $module = shift or last;
- my $version = shift || 0;
- push @added, [ $module, $version ];
- }
- push @{ $self->{values}->{$key} }, @added;
- return map {@$_} @added;
- };
-}
-
-# Resource handling
-my %lc_resource = map { $_ => 1 } qw{
- homepage
- license
- bugtracker
- repository
-};
-
-sub resources {
- my $self = shift;
- while ( @_ ) {
- my $name = shift or last;
- my $value = shift or next;
- if ( $name eq lc $name and ! $lc_resource{$name} ) {
- die("Unsupported reserved lowercase resource '$name'");
- }
- $self->{values}->{resources} ||= [];
- push @{ $self->{values}->{resources} }, [ $name, $value ];
- }
- $self->{values}->{resources};
-}
-
-# Aliases for build_requires that will have alternative
-# meanings in some future version of META.yml.
-sub test_requires { shift->build_requires(@_) }
-sub install_requires { shift->build_requires(@_) }
-
-# Aliases for installdirs options
-sub install_as_core { $_[0]->installdirs('perl') }
-sub install_as_cpan { $_[0]->installdirs('site') }
-sub install_as_site { $_[0]->installdirs('site') }
-sub install_as_vendor { $_[0]->installdirs('vendor') }
-
-sub dynamic_config {
- my $self = shift;
- my $value = @_ ? shift : 1;
- if ( $self->{values}->{dynamic_config} ) {
- # Once dynamic we never change to static, for safety
- return 0;
- }
- $self->{values}->{dynamic_config} = $value ? 1 : 0;
- return 1;
-}
-
-# Convenience command
-sub static_config {
- shift->dynamic_config(0);
-}
-
-sub perl_version {
- my $self = shift;
- return $self->{values}->{perl_version} unless @_;
- my $version = shift or die(
- "Did not provide a value to perl_version()"
- );
-
- # Normalize the version
- $version = $self->_perl_version($version);
-
- # We don't support the really old versions
- unless ( $version >= 5.005 ) {
- die "Module::Install only supports 5.005 or newer (use ExtUtils::MakeMaker)\n";
- }
-
- $self->{values}->{perl_version} = $version;
-}
-
-sub all_from {
- my ( $self, $file ) = @_;
-
- unless ( defined($file) ) {
- my $name = $self->name or die(
- "all_from called with no args without setting name() first"
- );
- $file = join('/', 'lib', split(/-/, $name)) . '.pm';
- $file =~ s{.*/}{} unless -e $file;
- unless ( -e $file ) {
- die("all_from cannot find $file from $name");
- }
- }
- unless ( -f $file ) {
- die("The path '$file' does not exist, or is not a file");
- }
-
- $self->{values}{all_from} = $file;
-
- # Some methods pull from POD instead of code.
- # If there is a matching .pod, use that instead
- my $pod = $file;
- $pod =~ s/\.pm$/.pod/i;
- $pod = $file unless -e $pod;
-
- # Pull the different values
- $self->name_from($file) unless $self->name;
- $self->version_from($file) unless $self->version;
- $self->perl_version_from($file) unless $self->perl_version;
- $self->author_from($pod) unless @{$self->author || []};
- $self->license_from($pod) unless $self->license;
- $self->abstract_from($pod) unless $self->abstract;
-
- return 1;
-}
-
-sub provides {
- my $self = shift;
- my $provides = ( $self->{values}->{provides} ||= {} );
- %$provides = (%$provides, @_) if @_;
- return $provides;
-}
-
-sub auto_provides {
- my $self = shift;
- return $self unless $self->is_admin;
- unless (-e 'MANIFEST') {
- warn "Cannot deduce auto_provides without a MANIFEST, skipping\n";
- return $self;
- }
- # Avoid spurious warnings as we are not checking manifest here.
- local $SIG{__WARN__} = sub {1};
- require ExtUtils::Manifest;
- local *ExtUtils::Manifest::manicheck = sub { return };
-
- require Module::Build;
- my $build = Module::Build->new(
- dist_name => $self->name,
- dist_version => $self->version,
- license => $self->license,
- );
- $self->provides( %{ $build->find_dist_packages || {} } );
-}
-
-sub feature {
- my $self = shift;
- my $name = shift;
- my $features = ( $self->{values}->{features} ||= [] );
- my $mods;
-
- if ( @_ == 1 and ref( $_[0] ) ) {
- # The user used ->feature like ->features by passing in the second
- # argument as a reference. Accomodate for that.
- $mods = $_[0];
- } else {
- $mods = \@_;
- }
-
- my $count = 0;
- push @$features, (
- $name => [
- map {
- ref($_) ? ( ref($_) eq 'HASH' ) ? %$_ : @$_ : $_
- } @$mods
- ]
- );
-
- return @$features;
-}
-
-sub features {
- my $self = shift;
- while ( my ( $name, $mods ) = splice( @_, 0, 2 ) ) {
- $self->feature( $name, @$mods );
- }
- return $self->{values}->{features}
- ? @{ $self->{values}->{features} }
- : ();
-}
-
-sub no_index {
- my $self = shift;
- my $type = shift;
- push @{ $self->{values}->{no_index}->{$type} }, @_ if $type;
- return $self->{values}->{no_index};
-}
-
-sub read {
- my $self = shift;
- $self->include_deps( 'YAML::Tiny', 0 );
-
- require YAML::Tiny;
- my $data = YAML::Tiny::LoadFile('META.yml');
-
- # Call methods explicitly in case user has already set some values.
- while ( my ( $key, $value ) = each %$data ) {
- next unless $self->can($key);
- if ( ref $value eq 'HASH' ) {
- while ( my ( $module, $version ) = each %$value ) {
- $self->can($key)->($self, $module => $version );
- }
- } else {
- $self->can($key)->($self, $value);
- }
- }
- return $self;
-}
-
-sub write {
- my $self = shift;
- return $self unless $self->is_admin;
- $self->admin->write_meta;
- return $self;
-}
-
-sub version_from {
- require ExtUtils::MM_Unix;
- my ( $self, $file ) = @_;
- $self->version( ExtUtils::MM_Unix->parse_version($file) );
-
- # for version integrity check
- $self->makemaker_args( VERSION_FROM => $file );
-}
-
-sub abstract_from {
- require ExtUtils::MM_Unix;
- my ( $self, $file ) = @_;
- $self->abstract(
- bless(
- { DISTNAME => $self->name },
- 'ExtUtils::MM_Unix'
- )->parse_abstract($file)
- );
-}
-
-# Add both distribution and module name
-sub name_from {
- my ($self, $file) = @_;
- if (
- Module::Install::_read($file) =~ m/
- ^ \s*
- package \s*
- ([\w:]+)
- \s* ;
- /ixms
- ) {
- my ($name, $module_name) = ($1, $1);
- $name =~ s{::}{-}g;
- $self->name($name);
- unless ( $self->module_name ) {
- $self->module_name($module_name);
- }
- } else {
- die("Cannot determine name from $file\n");
- }
-}
-
-sub _extract_perl_version {
- if (
- $_[0] =~ m/
- ^\s*
- (?:use|require) \s*
- v?
- ([\d_\.]+)
- \s* ;
- /ixms
- ) {
- my $perl_version = $1;
- $perl_version =~ s{_}{}g;
- return $perl_version;
- } else {
- return;
- }
-}
-
-sub perl_version_from {
- my $self = shift;
- my $perl_version=_extract_perl_version(Module::Install::_read($_[0]));
- if ($perl_version) {
- $self->perl_version($perl_version);
- } else {
- warn "Cannot determine perl version info from $_[0]\n";
- return;
- }
-}
-
-sub author_from {
- my $self = shift;
- my $content = Module::Install::_read($_[0]);
- if ($content =~ m/
- =head \d \s+ (?:authors?)\b \s*
- ([^\n]*)
- |
- =head \d \s+ (?:licen[cs]e|licensing|copyright|legal)\b \s*
- .*? copyright .*? \d\d\d[\d.]+ \s* (?:\bby\b)? \s*
- ([^\n]*)
- /ixms) {
- my $author = $1 || $2;
-
- # XXX: ugly but should work anyway...
- if (eval "require Pod::Escapes; 1") {
- # Pod::Escapes has a mapping table.
- # It's in core of perl >= 5.9.3, and should be installed
- # as one of the Pod::Simple's prereqs, which is a prereq
- # of Pod::Text 3.x (see also below).
- $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
- {
- defined $2
- ? chr($2)
- : defined $Pod::Escapes::Name2character_number{$1}
- ? chr($Pod::Escapes::Name2character_number{$1})
- : do {
- warn "Unknown escape: E<$1>";
- "E<$1>";
- };
- }gex;
- }
- elsif (eval "require Pod::Text; 1" && $Pod::Text::VERSION < 3) {
- # Pod::Text < 3.0 has yet another mapping table,
- # though the table name of 2.x and 1.x are different.
- # (1.x is in core of Perl < 5.6, 2.x is in core of
- # Perl < 5.9.3)
- my $mapping = ($Pod::Text::VERSION < 2)
- ? \%Pod::Text::HTML_Escapes
- : \%Pod::Text::ESCAPES;
- $author =~ s{ E<( (\d+) | ([A-Za-z]+) )> }
- {
- defined $2
- ? chr($2)
- : defined $mapping->{$1}
- ? $mapping->{$1}
- : do {
- warn "Unknown escape: E<$1>";
- "E<$1>";
- };
- }gex;
- }
- else {
- $author =~ s{E<lt>}{<}g;
- $author =~ s{E<gt>}{>}g;
- }
- $self->author($author);
- } else {
- warn "Cannot determine author info from $_[0]\n";
- }
-}
-
-#Stolen from M::B
-my %license_urls = (
- perl => 'http://dev.perl.org/licenses/',
- apache => 'http://apache.org/licenses/LICENSE-2.0',
- apache_1_1 => 'http://apache.org/licenses/LICENSE-1.1',
- artistic => 'http://opensource.org/licenses/artistic-license.php',
- artistic_2 => 'http://opensource.org/licenses/artistic-license-2.0.php',
- lgpl => 'http://opensource.org/licenses/lgpl-license.php',
- lgpl2 => 'http://opensource.org/licenses/lgpl-2.1.php',
- lgpl3 => 'http://opensource.org/licenses/lgpl-3.0.html',
- bsd => 'http://opensource.org/licenses/bsd-license.php',
- gpl => 'http://opensource.org/licenses/gpl-license.php',
- gpl2 => 'http://opensource.org/licenses/gpl-2.0.php',
- gpl3 => 'http://opensource.org/licenses/gpl-3.0.html',
- mit => 'http://opensource.org/licenses/mit-license.php',
- mozilla => 'http://opensource.org/licenses/mozilla1.1.php',
- open_source => undef,
- unrestricted => undef,
- restrictive => undef,
- unknown => undef,
-);
-
-sub license {
- my $self = shift;
- return $self->{values}->{license} unless @_;
- my $license = shift or die(
- 'Did not provide a value to license()'
- );
- $license = __extract_license($license) || lc $license;
- $self->{values}->{license} = $license;
-
- # Automatically fill in license URLs
- if ( $license_urls{$license} ) {
- $self->resources( license => $license_urls{$license} );
- }
-
- return 1;
-}
-
-sub _extract_license {
- my $pod = shift;
- my $matched;
- return __extract_license(
- ($matched) = $pod =~ m/
- (=head \d \s+ L(?i:ICEN[CS]E|ICENSING)\b.*?)
- (=head \d.*|=cut.*|)\z
- /xms
- ) || __extract_license(
- ($matched) = $pod =~ m/
- (=head \d \s+ (?:C(?i:OPYRIGHTS?)|L(?i:EGAL))\b.*?)
- (=head \d.*|=cut.*|)\z
- /xms
- );
-}
-
-sub __extract_license {
- my $license_text = shift or return;
- my @phrases = (
- '(?:under )?the same (?:terms|license) as (?:perl|the perl (?:\d )?programming language)' => 'perl', 1,
- '(?:under )?the terms of (?:perl|the perl programming language) itself' => 'perl', 1,
- 'Artistic and GPL' => 'perl', 1,
- 'GNU general public license' => 'gpl', 1,
- 'GNU public license' => 'gpl', 1,
- 'GNU lesser general public license' => 'lgpl', 1,
- 'GNU lesser public license' => 'lgpl', 1,
- 'GNU library general public license' => 'lgpl', 1,
- 'GNU library public license' => 'lgpl', 1,
- 'GNU Free Documentation license' => 'unrestricted', 1,
- 'GNU Affero General Public License' => 'open_source', 1,
- '(?:Free)?BSD license' => 'bsd', 1,
- 'Artistic license 2\.0' => 'artistic_2', 1,
- 'Artistic license' => 'artistic', 1,
- 'Apache (?:Software )?license' => 'apache', 1,
- 'GPL' => 'gpl', 1,
- 'LGPL' => 'lgpl', 1,
- 'BSD' => 'bsd', 1,
- 'Artistic' => 'artistic', 1,
- 'MIT' => 'mit', 1,
- 'Mozilla Public License' => 'mozilla', 1,
- 'Q Public License' => 'open_source', 1,
- 'OpenSSL License' => 'unrestricted', 1,
- 'SSLeay License' => 'unrestricted', 1,
- 'zlib License' => 'open_source', 1,
- 'proprietary' => 'proprietary', 0,
- );
- while ( my ($pattern, $license, $osi) = splice(@phrases, 0, 3) ) {
- $pattern =~ s#\s+#\\s+#gs;
- if ( $license_text =~ /\b$pattern\b/i ) {
- return $license;
- }
- }
- return '';
-}
-
-sub license_from {
- my $self = shift;
- if (my $license=_extract_license(Module::Install::_read($_[0]))) {
- $self->license($license);
- } else {
- warn "Cannot determine license info from $_[0]\n";
- return 'unknown';
- }
-}
-
-sub _extract_bugtracker {
- my @links = $_[0] =~ m#L<(
- https?\Q://rt.cpan.org/\E[^>]+|
- https?\Q://github.com/\E[\w_]+/[\w_]+/issues|
- https?\Q://code.google.com/p/\E[\w_\-]+/issues/list
- )>#gx;
- my %links;
- @links{@links}=();
- @links=keys %links;
- return @links;
-}
-
-sub bugtracker_from {
- my $self = shift;
- my $content = Module::Install::_read($_[0]);
- my @links = _extract_bugtracker($content);
- unless ( @links ) {
- warn "Cannot determine bugtracker info from $_[0]\n";
- return 0;
- }
- if ( @links > 1 ) {
- warn "Found more than one bugtracker link in $_[0]\n";
- return 0;
- }
-
- # Set the bugtracker
- bugtracker( $links[0] );
- return 1;
-}
-
-sub requires_from {
- my $self = shift;
- my $content = Module::Install::_readperl($_[0]);
- my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+(v?[\d\.]+)/mg;
- while ( @requires ) {
- my $module = shift @requires;
- my $version = shift @requires;
- $self->requires( $module => $version );
- }
-}
-
-sub test_requires_from {
- my $self = shift;
- my $content = Module::Install::_readperl($_[0]);
- my @requires = $content =~ m/^use\s+([^\W\d]\w*(?:::\w+)*)\s+([\d\.]+)/mg;
- while ( @requires ) {
- my $module = shift @requires;
- my $version = shift @requires;
- $self->test_requires( $module => $version );
- }
-}
-
-# Convert triple-part versions (eg, 5.6.1 or 5.8.9) to
-# numbers (eg, 5.006001 or 5.008009).
-# Also, convert double-part versions (eg, 5.8)
-sub _perl_version {
- my $v = $_[-1];
- $v =~ s/^([1-9])\.([1-9]\d?\d?)$/sprintf("%d.%03d",$1,$2)/e;
- $v =~ s/^([1-9])\.([1-9]\d?\d?)\.(0|[1-9]\d?\d?)$/sprintf("%d.%03d%03d",$1,$2,$3 || 0)/e;
- $v =~ s/(\.\d\d\d)000$/$1/;
- $v =~ s/_.+$//;
- if ( ref($v) ) {
- # Numify
- $v = $v + 0;
- }
- return $v;
-}
-
-sub add_metadata {
- my $self = shift;
- my %hash = @_;
- for my $key (keys %hash) {
- warn "add_metadata: $key is not prefixed with 'x_'.\n" .
- "Use appopriate function to add non-private metadata.\n" unless $key =~ /^x_/;
- $self->{values}->{$key} = $hash{$key};
- }
-}
-
-
-######################################################################
-# MYMETA Support
-
-sub WriteMyMeta {
- die "WriteMyMeta has been deprecated";
-}
-
-sub write_mymeta_yaml {
- my $self = shift;
-
- # We need YAML::Tiny to write the MYMETA.yml file
- unless ( eval { require YAML::Tiny; 1; } ) {
- return 1;
- }
-
- # Generate the data
- my $meta = $self->_write_mymeta_data or return 1;
-
- # Save as the MYMETA.yml file
- print "Writing MYMETA.yml\n";
- YAML::Tiny::DumpFile('MYMETA.yml', $meta);
-}
-
-sub write_mymeta_json {
- my $self = shift;
-
- # We need JSON to write the MYMETA.json file
- unless ( eval { require JSON; 1; } ) {
- return 1;
- }
-
- # Generate the data
- my $meta = $self->_write_mymeta_data or return 1;
-
- # Save as the MYMETA.yml file
- print "Writing MYMETA.json\n";
- Module::Install::_write(
- 'MYMETA.json',
- JSON->new->pretty(1)->canonical->encode($meta),
- );
-}
-
-sub _write_mymeta_data {
- my $self = shift;
-
- # If there's no existing META.yml there is nothing we can do
- return undef unless -f 'META.yml';
-
- # We need Parse::CPAN::Meta to load the file
- unless ( eval { require Parse::CPAN::Meta; 1; } ) {
- return undef;
- }
-
- # Merge the perl version into the dependencies
- my $val = $self->Meta->{values};
- my $perl = delete $val->{perl_version};
- if ( $perl ) {
- $val->{requires} ||= [];
- my $requires = $val->{requires};
-
- # Canonize to three-dot version after Perl 5.6
- if ( $perl >= 5.006 ) {
- $perl =~ s{^(\d+)\.(\d\d\d)(\d*)}{join('.', $1, int($2||0), int($3||0))}e
- }
- unshift @$requires, [ perl => $perl ];
- }
-
- # Load the advisory META.yml file
- my @yaml = Parse::CPAN::Meta::LoadFile('META.yml');
- my $meta = $yaml[0];
-
- # Overwrite the non-configure dependency hashs
- delete $meta->{requires};
- delete $meta->{build_requires};
- delete $meta->{recommends};
- if ( exists $val->{requires} ) {
- $meta->{requires} = { map { @$_ } @{ $val->{requires} } };
- }
- if ( exists $val->{build_requires} ) {
- $meta->{build_requires} = { map { @$_ } @{ $val->{build_requires} } };
- }
-
- return $meta;
-}
-
-1;
@@ -1,64 +0,0 @@
-#line 1
-package Module::Install::Win32;
-
-use strict;
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = 'Module::Install::Base';
- $ISCORE = 1;
-}
-
-# determine if the user needs nmake, and download it if needed
-sub check_nmake {
- my $self = shift;
- $self->load('can_run');
- $self->load('get_file');
-
- require Config;
- return unless (
- $^O eq 'MSWin32' and
- $Config::Config{make} and
- $Config::Config{make} =~ /^nmake\b/i and
- ! $self->can_run('nmake')
- );
-
- print "The required 'nmake' executable not found, fetching it...\n";
-
- require File::Basename;
- my $rv = $self->get_file(
- url => 'http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe',
- ftp_url => 'ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe',
- local_dir => File::Basename::dirname($^X),
- size => 51928,
- run => 'Nmake15.exe /o > nul',
- check_for => 'Nmake.exe',
- remove => 1,
- );
-
- die <<'END_MESSAGE' unless $rv;
-
--------------------------------------------------------------------------------
-
-Since you are using Microsoft Windows, you will need the 'nmake' utility
-before installation. It's available at:
-
- http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe
- or
- ftp://ftp.microsoft.com/Softlib/MSLFILES/Nmake15.exe
-
-Please download the file manually, save it to a directory in %PATH% (e.g.
-C:\WINDOWS\COMMAND\), then launch the MS-DOS command line shell, "cd" to
-that directory, and run "Nmake15.exe" from there; that will create the
-'nmake.exe' file needed by this module.
-
-You may then resume the installation process described in README.
-
--------------------------------------------------------------------------------
-END_MESSAGE
-
-}
-
-1;
@@ -1,63 +0,0 @@
-#line 1
-package Module::Install::WriteAll;
-
-use strict;
-use Module::Install::Base ();
-
-use vars qw{$VERSION @ISA $ISCORE};
-BEGIN {
- $VERSION = '1.04';
- @ISA = qw{Module::Install::Base};
- $ISCORE = 1;
-}
-
-sub WriteAll {
- my $self = shift;
- my %args = (
- meta => 1,
- sign => 0,
- inline => 0,
- check_nmake => 1,
- @_,
- );
-
- $self->sign(1) if $args{sign};
- $self->admin->WriteAll(%args) if $self->is_admin;
-
- $self->check_nmake if $args{check_nmake};
- unless ( $self->makemaker_args->{PL_FILES} ) {
- # XXX: This still may be a bit over-defensive...
- unless ($self->makemaker(6.25)) {
- $self->makemaker_args( PL_FILES => {} ) if -f 'Build.PL';
- }
- }
-
- # Until ExtUtils::MakeMaker support MYMETA.yml, make sure
- # we clean it up properly ourself.
- $self->realclean_files('MYMETA.yml');
-
- if ( $args{inline} ) {
- $self->Inline->write;
- } else {
- $self->Makefile->write;
- }
-
- # The Makefile write process adds a couple of dependencies,
- # so write the META.yml files after the Makefile.
- if ( $args{meta} ) {
- $self->Meta->write;
- }
-
- # Experimental support for MYMETA
- if ( $ENV{X_MYMETA} ) {
- if ( $ENV{X_MYMETA} eq 'JSON' ) {
- $self->Meta->write_mymeta_json;
- } else {
- $self->Meta->write_mymeta_yaml;
- }
- }
-
- return 1;
-}
-
-1;
@@ -1,470 +0,0 @@
-#line 1
-package Module::Install;
-
-# For any maintainers:
-# The load order for Module::Install is a bit magic.
-# It goes something like this...
-#
-# IF ( host has Module::Install installed, creating author mode ) {
-# 1. Makefile.PL calls "use inc::Module::Install"
-# 2. $INC{inc/Module/Install.pm} set to installed version of inc::Module::Install
-# 3. The installed version of inc::Module::Install loads
-# 4. inc::Module::Install calls "require Module::Install"
-# 5. The ./inc/ version of Module::Install loads
-# } ELSE {
-# 1. Makefile.PL calls "use inc::Module::Install"
-# 2. $INC{inc/Module/Install.pm} set to ./inc/ version of Module::Install
-# 3. The ./inc/ version of Module::Install loads
-# }
-
-use 5.005;
-use strict 'vars';
-use Cwd ();
-use File::Find ();
-use File::Path ();
-
-use vars qw{$VERSION $MAIN};
-BEGIN {
- # All Module::Install core packages now require synchronised versions.
- # This will be used to ensure we don't accidentally load old or
- # different versions of modules.
- # This is not enforced yet, but will be some time in the next few
- # releases once we can make sure it won't clash with custom
- # Module::Install extensions.
- $VERSION = '1.04';
-
- # Storage for the pseudo-singleton
- $MAIN = undef;
-
- *inc::Module::Install::VERSION = *VERSION;
- @inc::Module::Install::ISA = __PACKAGE__;
-
-}
-
-sub import {
- my $class = shift;
- my $self = $class->new(@_);
- my $who = $self->_caller;
-
- #-------------------------------------------------------------
- # all of the following checks should be included in import(),
- # to allow "eval 'require Module::Install; 1' to test
- # installation of Module::Install. (RT #51267)
- #-------------------------------------------------------------
-
- # Whether or not inc::Module::Install is actually loaded, the
- # $INC{inc/Module/Install.pm} is what will still get set as long as
- # the caller loaded module this in the documented manner.
- # If not set, the caller may NOT have loaded the bundled version, and thus
- # they may not have a MI version that works with the Makefile.PL. This would
- # result in false errors or unexpected behaviour. And we don't want that.
- my $file = join( '/', 'inc', split /::/, __PACKAGE__ ) . '.pm';
- unless ( $INC{$file} ) { die <<"END_DIE" }
-
-Please invoke ${\__PACKAGE__} with:
-
- use inc::${\__PACKAGE__};
-
-not:
-
- use ${\__PACKAGE__};
-
-END_DIE
-
- # This reportedly fixes a rare Win32 UTC file time issue, but
- # as this is a non-cross-platform XS module not in the core,
- # we shouldn't really depend on it. See RT #24194 for detail.
- # (Also, this module only supports Perl 5.6 and above).
- eval "use Win32::UTCFileTime" if $^O eq 'MSWin32' && $] >= 5.006;
-
- # If the script that is loading Module::Install is from the future,
- # then make will detect this and cause it to re-run over and over
- # again. This is bad. Rather than taking action to touch it (which
- # is unreliable on some platforms and requires write permissions)
- # for now we should catch this and refuse to run.
- if ( -f $0 ) {
- my $s = (stat($0))[9];
-
- # If the modification time is only slightly in the future,
- # sleep briefly to remove the problem.
- my $a = $s - time;
- if ( $a > 0 and $a < 5 ) { sleep 5 }
-
- # Too far in the future, throw an error.
- my $t = time;
- if ( $s > $t ) { die <<"END_DIE" }
-
-Your installer $0 has a modification time in the future ($s > $t).
-
-This is known to create infinite loops in make.
-
-Please correct this, then run $0 again.
-
-END_DIE
- }
-
-
- # Build.PL was formerly supported, but no longer is due to excessive
- # difficulty in implementing every single feature twice.
- if ( $0 =~ /Build.PL$/i ) { die <<"END_DIE" }
-
-Module::Install no longer supports Build.PL.
-
-It was impossible to maintain duel backends, and has been deprecated.
-
-Please remove all Build.PL files and only use the Makefile.PL installer.
-
-END_DIE
-
- #-------------------------------------------------------------
-
- # To save some more typing in Module::Install installers, every...
- # use inc::Module::Install
- # ...also acts as an implicit use strict.
- $^H |= strict::bits(qw(refs subs vars));
-
- #-------------------------------------------------------------
-
- unless ( -f $self->{file} ) {
- foreach my $key (keys %INC) {
- delete $INC{$key} if $key =~ /Module\/Install/;
- }
-
- local $^W;
- require "$self->{path}/$self->{dispatch}.pm";
- File::Path::mkpath("$self->{prefix}/$self->{author}");
- $self->{admin} = "$self->{name}::$self->{dispatch}"->new( _top => $self );
- $self->{admin}->init;
- @_ = ($class, _self => $self);
- goto &{"$self->{name}::import"};
- }
-
- local $^W;
- *{"${who}::AUTOLOAD"} = $self->autoload;
- $self->preload;
-
- # Unregister loader and worker packages so subdirs can use them again
- delete $INC{'inc/Module/Install.pm'};
- delete $INC{'Module/Install.pm'};
-
- # Save to the singleton
- $MAIN = $self;
-
- return 1;
-}
-
-sub autoload {
- my $self = shift;
- my $who = $self->_caller;
- my $cwd = Cwd::cwd();
- my $sym = "${who}::AUTOLOAD";
- $sym->{$cwd} = sub {
- my $pwd = Cwd::cwd();
- if ( my $code = $sym->{$pwd} ) {
- # Delegate back to parent dirs
- goto &$code unless $cwd eq $pwd;
- }
- unless ($$sym =~ s/([^:]+)$//) {
- # XXX: it looks like we can't retrieve the missing function
- # via $$sym (usually $main::AUTOLOAD) in this case.
- # I'm still wondering if we should slurp Makefile.PL to
- # get some context or not ...
- my ($package, $file, $line) = caller;
- die <<"EOT";
-Unknown function is found at $file line $line.
-Execution of $file aborted due to runtime errors.
-
-If you're a contributor to a project, you may need to install
-some Module::Install extensions from CPAN (or other repository).
-If you're a user of a module, please contact the author.
-EOT
- }
- my $method = $1;
- if ( uc($method) eq $method ) {
- # Do nothing
- return;
- } elsif ( $method =~ /^_/ and $self->can($method) ) {
- # Dispatch to the root M:I class
- return $self->$method(@_);
- }
-
- # Dispatch to the appropriate plugin
- unshift @_, ( $self, $1 );
- goto &{$self->can('call')};
- };
-}
-
-sub preload {
- my $self = shift;
- unless ( $self->{extensions} ) {
- $self->load_extensions(
- "$self->{prefix}/$self->{path}", $self
- );
- }
-
- my @exts = @{$self->{extensions}};
- unless ( @exts ) {
- @exts = $self->{admin}->load_all_extensions;
- }
-
- my %seen;
- foreach my $obj ( @exts ) {
- while (my ($method, $glob) = each %{ref($obj) . '::'}) {
- next unless $obj->can($method);
- next if $method =~ /^_/;
- next if $method eq uc($method);
- $seen{$method}++;
- }
- }
-
- my $who = $self->_caller;
- foreach my $name ( sort keys %seen ) {
- local $^W;
- *{"${who}::$name"} = sub {
- ${"${who}::AUTOLOAD"} = "${who}::$name";
- goto &{"${who}::AUTOLOAD"};
- };
- }
-}
-
-sub new {
- my ($class, %args) = @_;
-
- delete $INC{'FindBin.pm'};
- {
- # to suppress the redefine warning
- local $SIG{__WARN__} = sub {};
- require FindBin;
- }
-
- # ignore the prefix on extension modules built from top level.
- my $base_path = Cwd::abs_path($FindBin::Bin);
- unless ( Cwd::abs_path(Cwd::cwd()) eq $base_path ) {
- delete $args{prefix};
- }
- return $args{_self} if $args{_self};
-
- $args{dispatch} ||= 'Admin';
- $args{prefix} ||= 'inc';
- $args{author} ||= ($^O eq 'VMS' ? '_author' : '.author');
- $args{bundle} ||= 'inc/BUNDLES';
- $args{base} ||= $base_path;
- $class =~ s/^\Q$args{prefix}\E:://;
- $args{name} ||= $class;
- $args{version} ||= $class->VERSION;
- unless ( $args{path} ) {
- $args{path} = $args{name};
- $args{path} =~ s!::!/!g;
- }
- $args{file} ||= "$args{base}/$args{prefix}/$args{path}.pm";
- $args{wrote} = 0;
-
- bless( \%args, $class );
-}
-
-sub call {
- my ($self, $method) = @_;
- my $obj = $self->load($method) or return;
- splice(@_, 0, 2, $obj);
- goto &{$obj->can($method)};
-}
-
-sub load {
- my ($self, $method) = @_;
-
- $self->load_extensions(
- "$self->{prefix}/$self->{path}", $self
- ) unless $self->{extensions};
-
- foreach my $obj (@{$self->{extensions}}) {
- return $obj if $obj->can($method);
- }
-
- my $admin = $self->{admin} or die <<"END_DIE";
-The '$method' method does not exist in the '$self->{prefix}' path!
-Please remove the '$self->{prefix}' directory and run $0 again to load it.
-END_DIE
-
- my $obj = $admin->load($method, 1);
- push @{$self->{extensions}}, $obj;
-
- $obj;
-}
-
-sub load_extensions {
- my ($self, $path, $top) = @_;
-
- my $should_reload = 0;
- unless ( grep { ! ref $_ and lc $_ eq lc $self->{prefix} } @INC ) {
- unshift @INC, $self->{prefix};
- $should_reload = 1;
- }
-
- foreach my $rv ( $self->find_extensions($path) ) {
- my ($file, $pkg) = @{$rv};
- next if $self->{pathnames}{$pkg};
-
- local $@;
- my $new = eval { local $^W; require $file; $pkg->can('new') };
- unless ( $new ) {
- warn $@ if $@;
- next;
- }
- $self->{pathnames}{$pkg} =
- $should_reload ? delete $INC{$file} : $INC{$file};
- push @{$self->{extensions}}, &{$new}($pkg, _top => $top );
- }
-
- $self->{extensions} ||= [];
-}
-
-sub find_extensions {
- my ($self, $path) = @_;
-
- my @found;
- File::Find::find( sub {
- my $file = $File::Find::name;
- return unless $file =~ m!^\Q$path\E/(.+)\.pm\Z!is;
- my $subpath = $1;
- return if lc($subpath) eq lc($self->{dispatch});
-
- $file = "$self->{path}/$subpath.pm";
- my $pkg = "$self->{name}::$subpath";
- $pkg =~ s!/!::!g;
-
- # If we have a mixed-case package name, assume case has been preserved
- # correctly. Otherwise, root through the file to locate the case-preserved
- # version of the package name.
- if ( $subpath eq lc($subpath) || $subpath eq uc($subpath) ) {
- my $content = Module::Install::_read($subpath . '.pm');
- my $in_pod = 0;
- foreach ( split //, $content ) {
- $in_pod = 1 if /^=\w/;
- $in_pod = 0 if /^=cut/;
- next if ($in_pod || /^=cut/); # skip pod text
- next if /^\s*#/; # and comments
- if ( m/^\s*package\s+($pkg)\s*;/i ) {
- $pkg = $1;
- last;
- }
- }
- }
-
- push @found, [ $file, $pkg ];
- }, $path ) if -d $path;
-
- @found;
-}
-
-
-
-
-
-#####################################################################
-# Common Utility Functions
-
-sub _caller {
- my $depth = 0;
- my $call = caller($depth);
- while ( $call eq __PACKAGE__ ) {
- $depth++;
- $call = caller($depth);
- }
- return $call;
-}
-
-# Done in evals to avoid confusing Perl::MinimumVersion
-eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
-sub _read {
- local *FH;
- open( FH, '<', $_[0] ) or die "open($_[0]): $!";
- my $string = do { local $/; <FH> };
- close FH or die "close($_[0]): $!";
- return $string;
-}
-END_NEW
-sub _read {
- local *FH;
- open( FH, "< $_[0]" ) or die "open($_[0]): $!";
- my $string = do { local $/; <FH> };
- close FH or die "close($_[0]): $!";
- return $string;
-}
-END_OLD
-
-sub _readperl {
- my $string = Module::Install::_read($_[0]);
- $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg;
- $string =~ s/(\n)\n*__(?:DATA|END)__\b.*\z/$1/s;
- $string =~ s/\n\n=\w+.+?\n\n=cut\b.+?\n+/\n\n/sg;
- return $string;
-}
-
-sub _readpod {
- my $string = Module::Install::_read($_[0]);
- $string =~ s/(?:\015{1,2}\012|\015|\012)/\n/sg;
- return $string if $_[0] =~ /\.pod\z/;
- $string =~ s/(^|\n=cut\b.+?\n+)[^=\s].+?\n(\n=\w+|\z)/$1$2/sg;
- $string =~ s/\n*=pod\b[^\n]*\n+/\n\n/sg;
- $string =~ s/\n*=cut\b[^\n]*\n+/\n\n/sg;
- $string =~ s/^\n+//s;
- return $string;
-}
-
-# Done in evals to avoid confusing Perl::MinimumVersion
-eval( $] >= 5.006 ? <<'END_NEW' : <<'END_OLD' ); die $@ if $@;
-sub _write {
- local *FH;
- open( FH, '>', $_[0] ) or die "open($_[0]): $!";
- foreach ( 1 .. $#_ ) {
- print FH $_[$_] or die "print($_[0]): $!";
- }
- close FH or die "close($_[0]): $!";
-}
-END_NEW
-sub _write {
- local *FH;
- open( FH, "> $_[0]" ) or die "open($_[0]): $!";
- foreach ( 1 .. $#_ ) {
- print FH $_[$_] or die "print($_[0]): $!";
- }
- close FH or die "close($_[0]): $!";
-}
-END_OLD
-
-# _version is for processing module versions (eg, 1.03_05) not
-# Perl versions (eg, 5.8.1).
-sub _version ($) {
- my $s = shift || 0;
- my $d =()= $s =~ /(\.)/g;
- if ( $d >= 2 ) {
- # Normalise multipart versions
- $s =~ s/(\.)(\d{1,3})/sprintf("$1%03d",$2)/eg;
- }
- $s =~ s/^(\d+)\.?//;
- my $l = $1 || 0;
- my @v = map {
- $_ . '0' x (3 - length $_)
- } $s =~ /(\d{1,3})\D?/g;
- $l = $l . '.' . join '', @v if @v;
- return $l + 0;
-}
-
-sub _cmp ($$) {
- _version($_[1]) <=> _version($_[2]);
-}
-
-# Cloned from Params::Util::_CLASS
-sub _CLASS ($) {
- (
- defined $_[0]
- and
- ! ref $_[0]
- and
- $_[0] =~ m/^[^\W\d]\w*(?:::\w+)*\z/s
- ) ? $_[0] : undef;
-}
-
-1;
-
-# Copyright 2008 - 2011 Adam Kennedy.
@@ -0,0 +1,168 @@
+package Protocol::WebSocket::Client;
+
+use strict;
+use warnings;
+
+require Carp;
+use Protocol::WebSocket::URL;
+use Protocol::WebSocket::Handshake::Client;
+use Protocol::WebSocket::Frame;
+
+sub new {
+ my $class = shift;
+ $class = ref $class if ref $class;
+ my (%params) = @_;
+
+ my $self = {};
+ bless $self, $class;
+
+ Carp::croak('url is required') unless $params{url};
+ $self->{url} = Protocol::WebSocket::URL->new->parse($params{url})
+ or Carp::croak("Can't parse url");
+
+ $self->{version} = $params{version};
+
+ $self->{on_connect} = $params{on_connect};
+ $self->{on_write} = $params{on_write};
+ $self->{on_frame} = $params{on_frame};
+ $self->{on_eof} = $params{on_eof};
+ $self->{on_error} = $params{on_error};
+
+ $self->{hs} =
+ Protocol::WebSocket::Handshake::Client->new(url => $self->{url});
+ $self->{frame_buffer} = $self->_build_frame;
+
+ return $self;
+}
+
+sub url { shift->{url} }
+sub version { shift->{version} }
+
+sub on {
+ my $self = shift;
+ my ($event, $cb) = @_;
+
+ $self->{"on_$event"} = $cb;
+
+ return $self;
+}
+
+sub read {
+ my $self = shift;
+ my ($buffer) = @_;
+
+ my $hs = $self->{hs};
+ my $frame_buffer = $self->{frame_buffer};
+
+ unless ($hs->is_done) {
+ if (!$hs->parse($buffer)) {
+ $self->{on_error}->($self, $hs->error);
+ return $self;
+ }
+
+ $self->{on_connect}->($self) if $self->{on_connect} && $hs->is_done;
+ }
+
+ if ($hs->is_done) {
+ $frame_buffer->append($buffer);
+
+ while (my $bytes = $frame_buffer->next) {
+ $self->{on_read}->($self, $bytes);
+
+ #$self->{on_frame}->($self, $bytes);
+ }
+ }
+
+ return $self;
+}
+
+sub write {
+ my $self = shift;
+ my ($buffer) = @_;
+
+ my $frame =
+ ref $buffer
+ ? $buffer
+ : $self->_build_frame(masked => 1, buffer => $buffer);
+ $self->{on_write}->($self, $frame->to_bytes);
+
+ return $self;
+}
+
+sub connect {
+ my $self = shift;
+
+ my $hs = $self->{hs};
+
+ $self->{on_write}->($self, $hs->to_string);
+
+ return $self;
+}
+
+sub disconnect {
+ my $self = shift;
+
+ my $frame = $self->_build_frame(type => 'close');
+
+ $self->{on_write}->($self, $frame->to_bytes);
+
+ return $self;
+}
+
+sub _build_frame {
+ my $self = shift;
+
+ return Protocol::WebSocket::Frame->new(version => $self->{version}, @_);
+}
+
+1;
+__END__
+
+=head1 NAME
+
+Protocol::WebSocket::Client - WebSocket client
+
+=head1 SYNOPSIS
+
+ my $sock = ...get non-blocking socket...;
+
+ my $client = Protocol::WebSocket->new(url => 'ws://localhost:3000');
+ $client->on(
+ write => sub {
+ my $client = shift;
+ my ($buf) = @_;
+
+ syswrite $sock, $buf;
+ }
+ );
+ $client->on(
+ read => sub {
+ my $client = shift;
+ my ($buf) = @_;
+
+ ...do smth with read data...
+ }
+ );
+
+ # Sends a correct handshake header
+ $client->connect;
+
+ # Register on connect handler
+ $client->on(
+ connect => sub {
+ $client->write('hi there');
+ }
+ );
+
+ # Parses incoming data and on every frame calls on_read
+ $client->read(...data from socket...);
+
+ # Sends correct close header
+ $client->disconnect;
+
+=head1 DESCRIPTION
+
+L<Protocol::WebSocket::Client> is a convenient class for writing a WebSocket
+client.
+
+=cut
@@ -12,8 +12,11 @@ sub parse {
my $cookies = [];
- my $pair = shift @{$self->pairs};
- my $version = $pair->[1];
+ my $version = 1;
+ if ($self->pairs->[0] eq '$Version') {
+ my $pair = shift @{$self->pairs};
+ $version = $pair->[1];
+ }
my $cookie;
foreach my $pair (@{$self->pairs}) {
@@ -55,7 +55,7 @@ Protocol::WebSocket::Cookie::Response - WebSocket Cookie Response
=head1 SYNOPSIS
# Constructor
- my $cookie = Parser::WebSocket::Cookie::Response->new(
+ my $cookie = Protocol::WebSocket::Cookie::Response->new(
name => 'foo',
value => 'bar',
discard => 1,
@@ -64,7 +64,7 @@ Protocol::WebSocket::Cookie::Response - WebSocket Cookie Response
$cookie->to_string; # foo=bar; Discard; Max-Age=0; Version=1
# Parser
- my $cookie = Parser::WebSocket::Cookie::Response->new;
+ my $cookie = Protocol::WebSocket::Cookie::Response->new;
$cookie->parse('foo=bar; Discard; Max-Age=0; Version=1');
=head1 DESCRIPTION
@@ -7,15 +7,16 @@ use Config;
use Encode ();
use Scalar::Util 'readonly';
-use constant MAX_RAND_INT => 2 ** 32;
+use constant MAX_RAND_INT => 2**32;
use constant MATH_RANDOM_SECURE => eval "require Math::Random::Secure;";
our %TYPES = (
- text => 0x01,
- binary => 0x02,
- ping => 0x09,
- pong => 0x0a,
- close => 0x08
+ continuation => 0x00,
+ text => 0x01,
+ binary => 0x02,
+ ping => 0x09,
+ pong => 0x0a,
+ close => 0x08
);
sub new {
@@ -43,7 +44,11 @@ sub new {
$self->{buffer} = $buffer;
}
- $self->{version} ||= 'draft-ietf-hidy-10';
+ if (defined($self->{type}) && defined($TYPES{$self->{type}})) {
+ $self->opcode($TYPES{$self->{type}});
+ }
+
+ $self->{version} ||= 'draft-ietf-hybi-17';
$self->{fragments} = [];
@@ -79,16 +84,28 @@ sub next {
return Encode::decode('UTF-8', $bytes);
}
-sub fin { @_ > 1 ? $_[0]->{fin} = $_[1] : $_[0]->{fin} }
-sub rsv { @_ > 1 ? $_[0]->{rsv} = $_[1] : $_[0]->{rsv} }
-sub opcode { @_ > 1 ? $_[0]->{opcode} = $_[1] : $_[0]->{opcode} || 1 }
+sub fin {
+ @_ > 1 ? $_[0]->{fin} =
+ $_[1]
+ : defined($_[0]->{fin}) ? $_[0]->{fin}
+ : 1;
+}
+sub rsv { @_ > 1 ? $_[0]->{rsv} = $_[1] : $_[0]->{rsv} }
+
+sub opcode {
+ @_ > 1 ? $_[0]->{opcode} =
+ $_[1]
+ : defined($_[0]->{opcode}) ? $_[0]->{opcode}
+ : 1;
+}
sub masked { @_ > 1 ? $_[0]->{masked} = $_[1] : $_[0]->{masked} }
-sub is_ping { $_[0]->opcode == 9 }
-sub is_pong { $_[0]->opcode == 10 }
-sub is_close { $_[0]->opcode == 8 }
-sub is_text { $_[0]->opcode == 1 }
-sub is_binary { $_[0]->opcode == 2 }
+sub is_ping { $_[0]->opcode == 9 }
+sub is_pong { $_[0]->opcode == 10 }
+sub is_close { $_[0]->opcode == 8 }
+sub is_continuation { $_[0]->opcode == 0 }
+sub is_text { $_[0]->opcode == 1 }
+sub is_binary { $_[0]->opcode == 2 }
sub next_bytes {
my $self = shift;
@@ -146,7 +163,7 @@ sub next_bytes {
$bits =~ s{^.}{0};
# Can we handle 64bit numbers?
- if ($Config{ivsize} <= 4 || $Config{longsize} < 8) {
+ if ($Config{ivsize} <= 4 || $Config{longsize} < 8 || $] < 5.010) {
$bits = substr($bits, 32);
$payload_len = unpack 'N', pack 'B*', $bits;
}
@@ -159,8 +176,9 @@ sub next_bytes {
if ($payload_len > $self->{max_payload_size}) {
$self->{buffer} = '';
- die
- "Payload is too big. Deny big message ($payload_len) or increase max_payload_size ($self->{max_payload_size})";
+ die "Payload is too big. "
+ . "Deny big message ($payload_len) "
+ . "or increase max_payload_size ($self->{max_payload_size})";
}
my $mask;
@@ -229,21 +247,15 @@ sub to_bytes {
}
if (length $self->{buffer} > $self->{max_payload_size}) {
- die
- "Payload is too big. Send shorter messages or increase max_payload_size";
+ die "Payload is too big. "
+ . "Send shorter messages or increase max_payload_size";
}
my $string = '';
- my $opcode;
- if (my $type = $self->{type}) {
- $opcode = $TYPES{$type};
- }
- else {
- $opcode = $self->opcode || 1;
- }
+ my $opcode = $self->opcode;
- $string .= pack 'C', ($opcode + 128);
+ $string .= pack 'C', ($opcode + ($self->fin ? 128 : 0));
my $payload_len = length($self->{buffer});
if ($payload_len <= 125) {
@@ -287,27 +299,17 @@ sub to_string {
my $self = shift;
die 'DO NOT USE';
-
- if ( $self->version eq 'draft-hixie-75'
- || $self->version eq 'draft-ietf-hybi-00')
- {
- return "\x00" . Encode::decode('UTF-8', $self->{buffer}) . "\xff";
- }
}
sub _mask {
my $self = shift;
my ($payload, $mask) = @_;
- my @mask = split //, $mask;
-
- my @payload = split //, $payload;
- for (my $i = 0; $i < @payload; $i++) {
- my $j = $i % 4;
- $payload[$i] ^= $mask[$j];
- }
+ $mask = $mask x (int(length($payload) / 4) + 1);
+ $mask = substr($mask, 0, length($payload));
+ $payload = "$payload" ^ $mask;
- return join '', @payload;
+ return $payload;
}
1;
@@ -338,26 +340,57 @@ Construct or parse a WebSocket frame.
By default built-in C<rand> is used, this is not secure, so when
L<Math::Random::Secure> is installed it is used instead.
-=head1 ATTRIBUTES
+=head1 METHODS
+
+=head2 C<new>
+
+ Protocol::WebSocket::Frame->new('data'); # same as (buffer => 'data')
+ Protocol::WebSocket::Frame->new(buffer => 'data', type => 'close');
+
+Create a new L<Protocol::WebSocket::Frame> instance. Automatically detect if the
+passed data is a Perl string or bytes.
+
+When called with more than one arguments, it takes the following named arguments
+(all of them are optional).
+
+=over
-=head2 C<type>
+=item C<buffer> => STR (default: C<"">)
-Frame's type. C<text> by default. Other accepted values:
+The payload of the frame.
+=item C<type> => TYPE_STR (default: C<"text">)
+
+The type of the frame. Accepted values are:
+
+ continuation
+ text
binary
ping
pong
close
-=head1 METHODS
+=item C<opcode> => INT (default: 1)
-=head2 C<new>
+The opcode of the frame. If C<type> field is set to a valid string, this field is ignored.
- Protocol::WebSocket::Frame->new('data');
- Protocol::WebSocket::Frame->new(buffer => 'data', type => 'close');
+=item C<fin> => BOOL (default: 1)
-Create a new L<Protocol::WebSocket::Frame> instance. Automatically detect if the
-passed data is a Perl string or bytes.
+"fin" flag of the frame. "fin" flag must be 1 in the ending frame of fragments.
+
+=item C<masked> => BOOL (default: 0)
+
+If set to true, the frame will be masked.
+
+=item C<version> => VERSION_STR (default: C<'draft-ietf-hybi-17'>)
+
+WebSocket protocol version string. See L<Protocol::WebSocket> for valid version strings.
+
+=back
+
+=head2 C<is_continuation>
+
+Check if frame is of continuation type.
=head2 C<is_text>
@@ -379,12 +412,22 @@ Check if frame is a pong response.
Check if frame is of close type.
+=head2 C<opcode>
+
+ $opcode = $frame->opcode;
+ $frame->opcode(8);
+
+Get/set opcode of the frame.
+
=head2 C<append>
- $frame->append(...);
+ $frame->append($chunk);
Append a frame chunk.
+Beware that this method is B<destructive>.
+It makes C<$chunk> empty unless C<$chunk> is read-only.
+
=head2 C<next>
$frame->append(...);
@@ -8,6 +8,7 @@ use base 'Protocol::WebSocket::Handshake';
require Carp;
use Protocol::WebSocket::URL;
+use Protocol::WebSocket::Frame;
sub new {
my $self = shift->SUPER::new(@_);
@@ -61,6 +62,12 @@ sub parse {
sub is_done { shift->res->is_done }
sub to_string { shift->req->to_string }
+sub build_frame {
+ my $self = shift;
+
+ return Protocol::WebSocket::Frame->new(masked => 1, version => $self->version, @_);
+}
+
sub _build_url { Protocol::WebSocket::URL->new }
sub _set_url {
@@ -74,7 +81,9 @@ sub _set_url {
my $req = $self->req;
my $host = $url->host;
- $host .= ':' . $url->port if defined $url->port;
+ $host .= ':' . $url->port
+ if defined $url->port
+ && ($url->secure ? $url->port ne '443' : $url->port ne '80');
$req->host($host);
$req->resource_name($url->resource_name);
@@ -6,6 +6,7 @@ use warnings;
use base 'Protocol::WebSocket::Handshake';
use Protocol::WebSocket::Request;
+use Protocol::WebSocket::Frame;
sub new_from_psgi {
my $class = shift;
@@ -29,21 +30,27 @@ sub parse {
return;
}
- return 1 unless $req->is_done;
+ if ($req->is_body || $req->is_done) {
+ $res->version($req->version);
+ $res->host($req->host);
- $res->version($req->version);
- $res->host($req->host);
-
- $res->secure($req->secure);
- $res->resource_name($req->resource_name);
- $res->origin($req->origin);
+ $res->secure($req->secure);
+ $res->resource_name($req->resource_name);
+ $res->origin($req->origin);
+ }
if ($req->version eq 'draft-ietf-hybi-00') {
- $res->number1($req->number1);
- $res->number2($req->number2);
- $res->challenge($req->challenge);
+ if ($self->is_done) {
+ $res->checksum(undef);
+ $res->number1($req->number1);
+ $res->number2($req->number2);
+ $res->challenge($req->challenge);
+ }
+ else {
+ $res->checksum('');
+ }
}
- elsif ($req->version eq 'draft-ietf-hybi-10'
+ elsif ($self->is_done && $req->version eq 'draft-ietf-hybi-10'
|| $req->version eq 'draft-ietf-hybi-17')
{
$res->key($req->key);
@@ -52,8 +59,30 @@ sub parse {
return 1;
}
+sub is_body { shift->req->is_body }
sub is_done { shift->req->is_done }
-sub to_string { shift->res->to_string }
+sub to_string {
+ my $self = shift;
+
+ if ($self->is_body) {
+ return $self->{partial} = $self->res->to_string;
+ }
+ elsif ($self->{partial}) {
+ my $to_string = $self->res->to_string;
+
+ $to_string =~ s/^\Q$self->{partial}\E//;
+
+ return $to_string;
+ }
+
+ return $self->res->to_string;
+}
+
+sub build_frame {
+ my $self = shift;
+
+ return Protocol::WebSocket::Frame->new(version => $self->version, @_);
+}
1;
__END__
@@ -111,10 +140,20 @@ on error.
When buffer is passed it's modified (unless readonly).
+=head2 C<build_frame>
+
+ $handshake->build_frame;
+
+Builds L<Protocol::WebSocket::Frame> with an appropriate version.
+
=head2 C<to_string>
Construct a WebSocket server response.
+=head2 C<is_body>
+
+Check whether handshake is in body state.
+
=head2 C<is_done>
Check whether handshake is done.
@@ -71,11 +71,10 @@ sub number2 { @_ > 1 ? $_[0]->{number2} = $_[1] : $_[0]->{number2} }
sub challenge { @_ > 1 ? $_[0]->{challenge} = $_[1] : $_[0]->{challenge} }
sub checksum {
- my $self = shift;
- my $checksum = shift;
+ my $self = shift;
- if (defined $checksum) {
- $self->{checksum} = $checksum;
+ if (@_) {
+ $self->{checksum} = $_[0];
return $self;
}
@@ -85,7 +84,7 @@ sub checksum {
Carp::croak(qq/number2 is required/) unless defined $self->number2;
Carp::croak(qq/challenge is required/) unless defined $self->challenge;
- $checksum = '';
+ my $checksum = '';
$checksum .= pack 'N' => $self->number1;
$checksum .= pack 'N' => $self->number2;
$checksum .= $self->challenge;
@@ -18,6 +18,8 @@ sub new_from_psgi {
my $version = '';
+ my $cookies;
+
my $fields = {
upgrade => $env->{HTTP_UPGRADE},
connection => $env->{HTTP_CONNECTION},
@@ -53,16 +55,21 @@ sub new_from_psgi {
$fields->{'sec-websocket-key2'} = $env->{HTTP_SEC_WEBSOCKET_KEY2};
}
- if ($version eq 'draft-ietf-hybi-10') {
+ if ($version eq 'draft-ietf-hybi-10' || $version eq 'draft-ietf-hybi-17') {
$fields->{'sec-websocket-origin'} = $env->{HTTP_SEC_WEBSOCKET_ORIGIN};
}
else {
$fields->{origin} = $env->{HTTP_ORIGIN};
}
+ if ($env->{HTTP_COOKIE}) {
+ $cookies = Protocol::WebSocket::Cookie->new->parse($env->{HTTP_COOKIE});
+ }
+
my $self = $class->new(
version => $version,
fields => $fields,
+ cookies => $cookies,
resource_name => "$env->{SCRIPT_NAME}$env->{PATH_INFO}"
. ($env->{QUERY_STRING} ? "?$env->{QUERY_STRING}" : "")
);
@@ -77,7 +84,18 @@ sub new_from_psgi {
return $self;
}
-sub cookies { shift->{cookies} }
+sub cookies {
+ if(@_ > 1) {
+ my $cookie = Protocol::WebSocket::Cookie->new;
+ return unless $_[1];
+
+ if (my $cookies = $cookie->parse($_[1])) {
+ $_[0]->{cookies} = $cookies;
+ }
+ } else {
+ return $_[0]->{cookies};
+ }
+}
sub resource_name {
@_ > 1 ? $_[0]->{resource_name} = $_[1] : $_[0]->{resource_name} || '/';
@@ -110,6 +128,12 @@ sub to_string {
Carp::croak(qq/Host is required/) unless defined $self->host;
$string .= "Host: " . $self->host . "\x0d\x0a";
+ if (ref $self->{cookies} eq 'Protocol::WebSocket::Cookie') {
+ my $cookie_string = $self->{cookies}->to_string;
+ $string .= 'Cookie: ' . $cookie_string . "\x0d\x0a"
+ if $cookie_string;
+ }
+
my $origin = $self->origin ? $self->origin : 'http://' . $self->host;
$origin =~ s{^http:}{https:} if $self->secure;
$string .= (
@@ -162,8 +186,6 @@ sub to_string {
Carp::croak('Version ' . $self->version . ' is not supported');
}
- # TODO cookies
-
$string .= "\x0d\x0a";
$string .= $self->challenge if $version eq 'draft-ietf-hybi-00';
@@ -171,6 +193,38 @@ sub to_string {
return $string;
}
+sub parse {
+ my $self = shift;
+
+ my $retval = $self->SUPER::parse($_[0]);
+
+ if (!$self->{finalized} && ($self->is_body || $self->is_done)) {
+ $self->{finalized} = 1;
+
+ if ($self->key1 && $self->key2) {
+ $self->version('draft-ietf-hybi-00');
+ }
+ elsif ($self->key) {
+ if ($self->field('sec-websocket-version') eq '13') {
+ $self->version('draft-ietf-hybi-17');
+ }
+ else {
+ $self->version('draft-ietf-hybi-10');
+ }
+ }
+ else {
+ $self->version('draft-hixie-75');
+ }
+
+ if (!$self->_finalize) {
+ $self->error('Not a valid request');
+ return;
+ }
+ }
+
+ return $retval;
+}
+
sub _parse_first_line {
my ($self, $line) = @_;
@@ -199,19 +253,6 @@ sub _parse_body {
my $challenge = substr $self->{buffer}, 0, 8, '';
$self->challenge($challenge);
-
- $self->version('draft-ietf-hybi-00');
- }
- elsif ($self->key) {
- if ($self->field('sec-websocket-version') eq '13') {
- $self->version('draft-ietf-hybi-17');
- }
- else {
- $self->version('draft-ietf-hybi-10');
- }
- }
- else {
- $self->version('draft-hixie-75');
}
if (length $self->{buffer}) {
@@ -219,10 +260,7 @@ sub _parse_body {
return;
}
- return $self if $self->_finalize;
-
- $self->error('Not a valid request');
- return;
+ return $self;
}
sub _number {
@@ -353,10 +391,12 @@ sub _finalize {
return unless grep { lc $_ eq 'upgrade' } @connections;
my $origin = $self->field('Sec-WebSocket-Origin') || $self->field('Origin');
- return unless $origin;
+ #return unless $origin;
$self->origin($origin);
- $self->secure(1) if $self->origin =~ m{^https:};
+ if (defined $self->origin) {
+ $self->secure(1) if $self->origin =~ m{^https:};
+ }
my $host = $self->field('Host');
return unless $host;
@@ -366,11 +406,7 @@ sub _finalize {
|| $self->field('WebSocket-Protocol');
$self->subprotocol($subprotocol) if $subprotocol;
- my $cookie = $self->_build_cookie;
- if (my $cookies = $cookie->parse($self->field('Cookie'))) {
- $self->{cookies} = $cookies;
- }
-
+ $self->cookies($self->field('Cookie'));
return $self;
}
@@ -7,7 +7,7 @@ use base 'Protocol::WebSocket::Message';
require Carp;
use MIME::Base64 ();
-use Digest::SHA1 ();
+use Digest::SHA ();
use Protocol::WebSocket::URL;
use Protocol::WebSocket::Cookie::Response;
@@ -91,7 +91,7 @@ sub headers {
my $key = $self->key;
$key .= '258EAFA5-E914-47DA-95CA-C5AB0DC85B11'; # WTF
- $key = Digest::SHA1::sha1($key);
+ $key = Digest::SHA::sha1($key);
$key = MIME::Base64::encode_base64($key);
$key =~ s{\s+}{}g;
@@ -294,6 +294,8 @@ Construct a WebSocket response.
=head2 C<cookies>
+=head2 C<key>
+
=head2 C<key1>
$self->key1;
@@ -17,6 +17,7 @@ sub state { @_ > 1 ? $_[0]->{state} = $_[1] : $_[0]->{state} }
sub done { shift->state('done') }
sub is_state { shift->state eq shift }
+sub is_body { shift->is_state('body') }
sub is_done { shift->is_state('done') }
1;
@@ -44,6 +45,8 @@ Create a new L<Protocol::WebSocket::Stateful> instance.
=head2 C<is_state>
+=head2 C<is_body>
+
=head2 C<is_done>
=cut
@@ -36,11 +36,13 @@ sub parse {
my ($host, $port) = $string =~ m{^$scheme://([^:\/]+)(?::(\d+))?(?:|\/|$)};
$host = '/' unless defined $host && $host ne '';
$self->host($host);
+ $port ||= $self->secure ? 443 : 80;
$self->port($port);
- my ($path) = $string =~ m{^$scheme://(?:.*?)(/.*?)(?:\?|$)};
- $path = '/' unless defined $path && $path ne '';
- $self->resource_name($path);
+ # path and query
+ my ($pnq) = $string =~ m{^$scheme://(?:.*?)(/.*)$};
+ $pnq = '/' unless defined $pnq && $pnq ne '';
+ $self->resource_name($pnq);
return $self;
}
@@ -77,7 +79,7 @@ Protocol::WebSocket::URL - WebSocket URL
$url->to_string; # wss://example.com:3000
# Parse
- my $url = Protocol::WebSocket::URL->new('wss://example.com:3000);
+ my $url = Protocol::WebSocket::URL->new->parse('wss://example.com:3000');
$url->host; # example.com
$url->port; # 3000
$url->secure; # 1
@@ -3,11 +3,18 @@ package Protocol::WebSocket;
use strict;
use warnings;
-our $VERSION = 0.00906;
+our $VERSION = '0.18';
+
+use Protocol::WebSocket::Frame;
+use Protocol::WebSocket::Handshake::Client;
+use Protocol::WebSocket::Handshake::Server;
+use Protocol::WebSocket::URL;
1;
__END__
+=encoding UTF-8
+
=head1 NAME
Protocol::WebSocket - WebSocket protocol
@@ -21,8 +28,7 @@ Protocol::WebSocket - WebSocket protocol
$hs->is_done; # tells us when handshake is done
- # Passing version is important for backwards compatibility
- my $frame = Protocol::WebSocket::Frame->new(version => $hs->version);
+ my $frame = $hs->build_frame;
$frame->append('some data from the client');
@@ -31,10 +37,10 @@ Protocol::WebSocket - WebSocket protocol
# Send close frame back
send(
- Protocol::WebSocket::Frame->new(
+ $hs->build_frame(
type => 'close',
version => $version
- )
+ )->to_bytes
);
return;
@@ -53,7 +59,7 @@ L<Protocol::WebSocket> supports the following WebSocket protocol versions:
draft-ietf-hybi-17 (latest)
draft-ietf-hybi-10
- draft-ietf-hybi-00
+ draft-ietf-hybi-00 (with HAProxy support)
draft-hixie-75
By default the latest version is used. The WebSocket version is detected
@@ -63,27 +69,39 @@ attribute to an appropriate value.
L<Protocol::WebSocket> itself does not contain any code and cannot be used
directly. Instead the following modules should be used:
-=head2 L<Protocol::WebSocket::Handshake::Server>
+=head2 High-level modules
+
+=head3 L<Protocol::WebSocket::Server>
+
+Server helper class.
+
+=head3 L<Protocol::WebSocket::Client>
+
+Client helper class.
+
+=head2 Low-level modules
+
+=head3 L<Protocol::WebSocket::Handshake::Server>
Server handshake parser and constructor.
-=head2 L<Protocol::WebSocket::Handshake::Client>
+=head3 L<Protocol::WebSocket::Handshake::Client>
Client handshake parser and constructor.
-=head2 L<Protocol::WebSocket::Frame>
+=head3 L<Protocol::WebSocket::Frame>
WebSocket frame parser and constructor.
-=head2 L<Protocol::WebSocket::Request>
+=head3 L<Protocol::WebSocket::Request>
Low level WebSocket request parser and constructor.
-=head2 L<Protocol::WebSocket::Response>
+=head3 L<Protocol::WebSocket::Response>
Low level WebSocket response parser and constructor.
-=head2 L<Protocol::WebSocket::URL>
+=head3 L<Protocol::WebSocket::URL>
Low level WebSocket url parser and constructor.
@@ -104,13 +122,29 @@ Lee Aylward
Chia-liang Kao
+Atomer Ju
+
+Chuck Bredestege
+
+Matthew Lien (BlueT)
+
+Joao Orui
+
+Toshio Ito (debug-ito)
+
+Neil Bowers
+
+Michal Špaček
+
+Graham Ollis
+
=head1 AUTHOR
Viacheslav Tykhanovskyi, C<vti@cpan.org>.
=head1 COPYRIGHT
-Copyright (C) 2010-2011, Viacheslav Tykhanovskyi.
+Copyright (C) 2010-2014, Viacheslav Tykhanovskyi.
This program is free software, you can redistribute it and/or modify it under
the same terms as Perl 5.10.
@@ -0,0 +1 @@
+name = "Protocol-WebSocket"
@@ -0,0 +1,105 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More;
+use IO::Handle;
+use Protocol::WebSocket::Handshake::Server;
+
+use_ok 'Protocol::WebSocket::Client';
+
+subtest 'write handshake on connect' => sub {
+ my $client = Protocol::WebSocket::Client->new(url => 'ws://localhost:8080');
+
+ my $written = '';
+ $client->on(write => sub { $written .= $_[1] });
+
+ $client->connect;
+
+ like $written, qr/Upgrade: WebSocket/;
+};
+
+subtest 'call on_connect on connect' => sub {
+ my $client = Protocol::WebSocket::Client->new(url => 'ws://localhost:8080');
+
+ $client->on(write => sub { });
+
+ my $connected;
+ $client->on(
+ connect => sub {
+ $connected++;
+ }
+ );
+
+ $client->connect;
+
+ _recv_server_handshake($client);
+
+ ok $connected;
+};
+
+subtest 'call on_read on new data' => sub {
+ my $client = Protocol::WebSocket::Client->new(url => 'ws://localhost:8080');
+
+ my $read = '';
+ $client->on(write => sub { });
+ $client->on(read => sub { $read .= $_[1] });
+
+ $client->connect;
+
+ _recv_server_handshake($client);
+
+ my $frame = Protocol::WebSocket::Frame->new(
+ version => $client->version,
+ buffer => 'hello'
+ );
+ $client->read($frame->to_bytes);
+
+ is $read, 'hello';
+};
+
+subtest 'write close frame on disconnect' => sub {
+ my $client = Protocol::WebSocket::Client->new(url => 'ws://localhost:8080');
+
+ my $written = '';
+ $client->on(write => sub { $written .= $_[1] });
+
+ $client->disconnect;
+
+ is $written, "\x88\x00";
+};
+
+subtest 'call on_write on write' => sub {
+ my $client = Protocol::WebSocket::Client->new(url => 'ws://localhost:8080');
+
+ my $written = '';
+ $client->on(write => sub { $written .= $_[1] });
+
+ $client->write('foobar');
+
+ isnt $written, '';
+};
+
+sub _recv_server_handshake {
+ my ($client) = @_;
+
+ open my $fh, '<', \'' or die $!;
+ my $io = IO::Handle->new;
+ $io->fdopen(fileno($fh), "r");
+ my $hs = Protocol::WebSocket::Handshake::Server->new_from_psgi(
+ SCRIPT_NAME => '',
+ PATH_INFO => '/chat',
+ HTTP_UPGRADE => 'websocket',
+ HTTP_CONNECTION => 'Upgrade',
+ HTTP_HOST => 'server.example.com',
+ HTTP_SEC_WEBSOCKET_ORIGIN => 'http://example.com',
+ HTTP_SEC_WEBSOCKET_KEY => 'dGhlIHNhbXBsZSBub25jZQ==',
+ HTTP_SEC_WEBSOCKET_VERSION => 13,
+ );
+ $hs->parse($io);
+
+ $client->read($hs->to_string);
+}
+
+done_testing;
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 29;
+use Test::More;
use_ok 'Protocol::WebSocket::Cookie';
use_ok 'Protocol::WebSocket::Cookie::Response';
@@ -83,3 +83,15 @@ is $cookies->[0]->path => '/';
is $cookies->[1]->name => 'bar';
is $cookies->[1]->value => 'baz';
is $cookies->[1]->domain => '.example.com';
+
+subtest 'parse when no version is available' => sub {
+ $cookie = Protocol::WebSocket::Cookie::Request->new;
+ $cookies = $cookie->parse('foo=bar; $Path=/; $Domain=.example.com');
+ is $cookies->[0]->name => 'foo';
+ is $cookies->[0]->value => 'bar';
+ is $cookies->[0]->version => 1;
+ is $cookies->[0]->path => '/';
+ is $cookies->[0]->domain => '.example.com';
+};
+
+done_testing;
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 104;
+use Test::More tests => 110;
use IO::Handle;
@@ -25,15 +25,18 @@ ok $req->parse("Connection: Upgrade\x0d\x0a");
is $req->state => 'fields';
ok $req->parse("Host: example.com\x0d\x0a");
is $req->state => 'fields';
+ok $req->parse("Cookie: foo=bar;alice=bob\x0d\x0a");
+is $req->state => 'fields';
ok $req->parse("Origin: http://example.com\x0d\x0a");
is $req->state => 'fields';
ok $req->parse("\x0d\x0a");
is $req->state => 'done';
-is $req->version => 'draft-hixie-75';
-is $req->resource_name => '/demo';
-is $req->host => 'example.com';
-is $req->origin => 'http://example.com';
+is $req->version => 'draft-hixie-75';
+is $req->resource_name => '/demo';
+is $req->host => 'example.com';
+is $req->cookies->to_string => 'foo=bar; alice=bob';
+is $req->origin => 'http://example.com';
$req = Protocol::WebSocket::Request->new;
ok $req->parse("GET /demo HTTP/1.1\x0d\x0a");
@@ -91,9 +94,12 @@ ok $req->parse("Cookie: \$Version=1; foo=bar; \$Path=/\x0d\x0a");
ok $req->parse("\x0d\x0a");
ok $req->is_done;
-is $req->cookies->[0]->version => 1;
-is $req->cookies->[0]->name => 'foo';
-is $req->cookies->[0]->value => 'bar';
+is $req->cookies->pairs->[0][0] => '$Version';
+is $req->cookies->pairs->[0][1] => '1';
+is $req->cookies->pairs->[1][0] => 'foo';
+is $req->cookies->pairs->[1][1] => 'bar';
+is $req->cookies->pairs->[2][0] => '$Path';
+is $req->cookies->pairs->[2][1] => '/';
$req = Protocol::WebSocket::Request->new;
$req->parse("GET /demo HTTP/1.1\x0d\x0a");
@@ -119,12 +125,14 @@ ok $req->secure;
$req = Protocol::WebSocket::Request->new(
version => 'draft-hixie-75',
host => 'example.com',
+ cookies => Protocol::WebSocket::Cookie->new->parse('foo=bar; alice=bob'),
resource_name => '/demo'
);
is $req->to_string => "GET /demo HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Origin: http://example.com\x0d\x0a"
. "\x0d\x0a";
@@ -16,11 +16,13 @@ $h->url('wss://example.com/demo');
$h->req->key1("18x 6]8vM;54 *(5: { U1]8 z [ 8");
$h->req->key2("1_ tx7X d < nw 334J702) 7]o}` 0");
$h->req->challenge("Tm[K T2u");
+$h->req->cookies('foo=bar; alice=bob');
is $h->to_string => "GET /demo HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Origin: https://example.com\x0d\x0a"
. "Sec-WebSocket-Key1: 18x 6]8vM;54 *(5: { U1]8 z [ 8\x0d\x0a"
. "Sec-WebSocket-Key2: 1_ tx7X d < nw 334J702) 7]o}` 0\x0d\x0a"
@@ -16,11 +16,13 @@ $h->url('ws://example.com/demo');
$h->req->key1("18x 6]8vM;54 *(5: { U1]8 z [ 8");
$h->req->key2("1_ tx7X d < nw 334J702) 7]o}` 0");
$h->req->challenge("Tm[K T2u");
+$h->req->cookies('foo=bar; alice=bob');
is $h->to_string => "GET /demo HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Origin: http://example.com\x0d\x0a"
. "Sec-WebSocket-Key1: 18x 6]8vM;54 *(5: { U1]8 z [ 8\x0d\x0a"
. "Sec-WebSocket-Key2: 1_ tx7X d < nw 334J702) 7]o}` 0\x0d\x0a"
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 59;
+use Test::More tests => 64;
use IO::Handle;
@@ -24,6 +24,8 @@ ok $req->parse("Connection: Upgrade\x0d\x0a");
is $req->state => 'fields';
ok $req->parse("Host: example.com\x0d\x0a");
is $req->state => 'fields';
+ok $req->parse("Cookie: foo=bar;alice=bob\x0d\x0a");
+is $req->state => 'fields';
ok $req->parse("Origin: http://example.com\x0d\x0a");
is $req->state => 'fields';
ok $req->parse(
@@ -37,11 +39,26 @@ is $req->number1 => '155712099';
is $req->number2 => '173347027';
is $req->challenge => 'Tm[K T2u';
-is $req->version => 'draft-ietf-hybi-00';
-is $req->resource_name => '/demo';
-is $req->host => 'example.com';
-is $req->origin => 'http://example.com';
-is $req->checksum => 'fQJ,fN/4F4!~K~MH';
+is $req->version => 'draft-ietf-hybi-00';
+is $req->resource_name => '/demo';
+is $req->host => 'example.com';
+is $req->origin => 'http://example.com';
+is $req->checksum => 'fQJ,fN/4F4!~K~MH';
+is $req->cookies->to_string => 'foo=bar; alice=bob';
+
+$req = Protocol::WebSocket::Request->new;
+$req->parse("GET /demo HTTP/1.1\x0d\x0a");
+$req->parse("Upgrade: WebSocket\x0d\x0a");
+$req->parse("Connection: Upgrade\x0d\x0a");
+$req->parse("Host: example.com\x0d\x0a");
+$req->parse("Origin: http://example.com\x0d\x0a");
+$req->parse("Sec-WebSocket-Protocol: sample\x0d\x0a");
+$req->parse(
+ "Sec-WebSocket-Key1: 18x 6]8vM;54 *(5: { U1]8 z [ 8\x0d\x0a");
+$req->parse(
+ "Sec-WebSocket-Key2: 1_ tx7X d < nw 334J702) 7]o}` 0\x0d\x0a");
+$req->parse("\x0d\x0a");
+is $req->version, 'draft-ietf-hybi-00';
$req = Protocol::WebSocket::Request->new;
ok $req->parse("GET /demo HTTP/1.1\x0d\x0a");
@@ -61,6 +78,7 @@ is $req->subprotocol => 'sample';
$req = Protocol::WebSocket::Request->new(
version => 'draft-ietf-hybi-00',
host => 'example.com',
+ cookies => Protocol::WebSocket::Cookie->new->parse('foo=bar; alice=bob'),
resource_name => '/demo',
key1 => '18x 6]8vM;54 *(5: { U1]8 z [ 8',
key2 => '1_ tx7X d < nw 334J702) 7]o}` 0',
@@ -70,6 +88,7 @@ is $req->to_string => "GET /demo HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Origin: http://example.com\x0d\x0a"
. "Sec-WebSocket-Key1: 18x 6]8vM;54 *(5: { U1]8 z [ 8\x0d\x0a"
. "Sec-WebSocket-Key2: 1_ tx7X d < nw 334J702) 7]o}` 0\x0d\x0a"
@@ -134,6 +153,7 @@ $req = Protocol::WebSocket::Request->new_from_psgi(
HTTP_UPGRADE => 'WebSocket',
HTTP_CONNECTION => 'Upgrade',
HTTP_HOST => 'example.com',
+ HTTP_COOKIE => 'foo=bar',
HTTP_ORIGIN => 'http://example.com',
HTTP_SEC_WEBSOCKET_PROTOCOL => 'sample',
HTTP_SEC_WEBSOCKET_KEY1 => '18x 6]8vM;54 *(5: { U1]8 z [ 8',
@@ -142,13 +162,14 @@ $req = Protocol::WebSocket::Request->new_from_psgi(
}
);
$req->parse($io);
-is $req->resource_name => '/demo?foo=bar';
-is $req->subprotocol => 'sample';
-is $req->upgrade => 'WebSocket';
-is $req->connection => 'Upgrade';
-is $req->host => 'example.com';
-is $req->origin => 'http://example.com';
-is $req->key1 => '18x 6]8vM;54 *(5: { U1]8 z [ 8';
-is $req->key2 => '1_ tx7X d < nw 334J702) 7]o}` 0';
+is $req->resource_name => '/demo?foo=bar';
+is $req->subprotocol => 'sample';
+is $req->upgrade => 'WebSocket';
+is $req->connection => 'Upgrade';
+is $req->host => 'example.com';
+is $req->cookies->to_string => 'foo=bar';
+is $req->origin => 'http://example.com';
+is $req->key1 => '18x 6]8vM;54 *(5: { U1]8 z [ 8';
+is $req->key2 => '1_ tx7X d < nw 334J702) 7]o}` 0';
ok $req->is_done;
is $req->version => 'draft-ietf-hybi-00';
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 20;
+use Test::More tests => 33;
use_ok 'Protocol::WebSocket::Handshake::Server';
@@ -34,6 +34,31 @@ is $h->to_string => "HTTP/1.1 101 WebSocket Protocol Handshake\x0d\x0a"
. "\x0d\x0a"
. "fQJ,fN/4F4!~K~MH";
+$h = Protocol::WebSocket::Handshake::Server->new;
+ok $h->parse("GET /demo HTTP/1.1\x0d\x0a");
+ok $h->parse("Upgrade: WebSocket\x0d\x0a");
+ok $h->parse("Connection: Upgrade\x0d\x0a");
+ok $h->parse("Host: example.com\x0d\x0a");
+ok $h->parse("Origin: http://example.com\x0d\x0a");
+ok $h->parse(
+ "Sec-WebSocket-Key1: 18x 6]8vM;54 *(5: { U1]8 z [ 8\x0d\x0a");
+ok $h->parse(
+ "Sec-WebSocket-Key2: 1_ tx7X d < nw 334J702) 7]o}` 0\x0d\x0a");
+ok $h->parse("\x0d\x0a");
+ok $h->is_body;
+
+is $h->to_string => "HTTP/1.1 101 WebSocket Protocol Handshake\x0d\x0a"
+ . "Upgrade: WebSocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Sec-WebSocket-Origin: http://example.com\x0d\x0a"
+ . "Sec-WebSocket-Location: ws://example.com/demo\x0d\x0a"
+ . "\x0d\x0a";
+
+ok $h->parse("Tm[K T2u");
+ok $h->is_done;
+
+is $h->to_string => "fQJ,fN/4F4!~K~MH";
+
my $message = "GET /demo HTTP/1.1\x0d\x0a";
$h = Protocol::WebSocket::Handshake::Server->new;
ok $h->parse($message);
@@ -12,11 +12,13 @@ $h->url('ws://example.com/demo');
# Mocking
$h->req->key("dGhlIHNhbXBsZSBub25jZQ==");
+$h->req->cookies('foo=bar; alice=bob');
is $h->to_string => "GET /demo HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Sec-WebSocket-Origin: http://example.com\x0d\x0a"
. "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a"
. "Sec-WebSocket-Version: 8\x0d\x0a"
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 48;
+use Test::More tests => 52;
use IO::Handle;
@@ -26,6 +26,8 @@ ok $req->parse("Upgrade: websocket\x0d\x0a");
is $req->state => 'fields';
ok $req->parse("Connection: Upgrade\x0d\x0a");
is $req->state => 'fields';
+ok $req->parse("Cookie: foo=bar; alice=bob\x0d\x0a");
+is $req->state => 'fields';
ok $req->parse("Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a");
ok $req->parse("Sec-WebSocket-Origin: http://example.com\x0d\x0a");
ok $req->parse("Sec-WebSocket-Protocol: chat, superchat\x0d\x0a");
@@ -33,11 +35,12 @@ ok $req->parse("Sec-WebSocket-Version: 8\x0d\x0a\x0d\x0a");
is $req->state => 'done';
is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
-is $req->version => 'draft-ietf-hybi-10';
-is $req->subprotocol => 'chat, superchat';
-is $req->resource_name => '/chat';
-is $req->host => 'server.example.com';
-is $req->origin => 'http://example.com';
+is $req->version => 'draft-ietf-hybi-10';
+is $req->subprotocol => 'chat, superchat';
+is $req->resource_name => '/chat';
+is $req->host => 'server.example.com';
+is $req->origin => 'http://example.com';
+is $req->cookies->to_string => 'foo=bar; alice=bob';
$req = Protocol::WebSocket::Request->new;
@@ -61,6 +64,7 @@ $req = Protocol::WebSocket::Request->new(
version => 'draft-ietf-hybi-10',
host => 'server.example.com',
origin => 'http://example.com',
+ cookies => Protocol::WebSocket::Cookie->new->parse('foo=bar; alice=bob'),
subprotocol => 'chat, superchat',
resource_name => '/chat',
key => 'dGhlIHNhbXBsZSBub25jZQ=='
@@ -69,6 +73,7 @@ is $req->to_string => "GET /chat HTTP/1.1\x0d\x0a"
. "Upgrade: WebSocket\x0d\x0a"
. "Connection: Upgrade\x0d\x0a"
. "Host: server.example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
. "Sec-WebSocket-Origin: http://example.com\x0d\x0a"
. "Sec-WebSocket-Protocol: chat, superchat\x0d\x0a"
. "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a"
@@ -85,6 +90,7 @@ $req = Protocol::WebSocket::Request->new_from_psgi(
HTTP_UPGRADE => 'websocket',
HTTP_CONNECTION => 'Upgrade',
HTTP_HOST => 'server.example.com',
+ HTTP_COOKIE => 'foo=bar',
HTTP_SEC_WEBSOCKET_ORIGIN => 'http://example.com',
HTTP_SEC_WEBSOCKET_PROTOCOL => 'chat, superchat',
HTTP_SEC_WEBSOCKET_KEY => 'dGhlIHNhbXBsZSBub25jZQ==',
@@ -92,12 +98,13 @@ $req = Protocol::WebSocket::Request->new_from_psgi(
}
);
$req->parse($io);
-is $req->resource_name => '/chat?foo=bar';
-is $req->subprotocol => 'chat, superchat';
-is $req->upgrade => 'websocket';
-is $req->connection => 'Upgrade';
-is $req->host => 'server.example.com';
-is $req->origin => 'http://example.com';
-is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
+is $req->resource_name => '/chat?foo=bar';
+is $req->subprotocol => 'chat, superchat';
+is $req->upgrade => 'websocket';
+is $req->connection => 'Upgrade';
+is $req->host => 'server.example.com';
+is $req->cookies->to_string => 'foo=bar';
+is $req->origin => 'http://example.com';
+is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
ok $req->is_done;
is $req->version => 'draft-ietf-hybi-10';
@@ -0,0 +1,37 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More tests => 8;
+
+use_ok 'Protocol::WebSocket::Handshake::Client';
+
+my $h = Protocol::WebSocket::Handshake::Client->new;
+$h->url('ws://example.com/demo');
+
+# Mocking
+$h->req->key("dGhlIHNhbXBsZSBub25jZQ==");
+$h->req->cookies('foo=bar; alice=bob');
+
+is $h->to_string => "GET /demo HTTP/1.1\x0d\x0a"
+ . "Upgrade: WebSocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Host: example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
+ . "Origin: http://example.com\x0d\x0a"
+ . "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a"
+ . "Sec-WebSocket-Version: 13\x0d\x0a"
+ . "\x0d\x0a";
+
+ok !$h->is_done;
+ok $h->parse;
+ok $h->parse('');
+
+ok $h->parse("HTTP/1.1 101 Switching Protocols\x0d\x0a"
+ . "Upgrade: websocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\x0d\x0a"
+ . "\x0d\x0a");
+ok !$h->error;
+ok $h->is_done;
@@ -0,0 +1,252 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use utf8;
+
+use Test::More;
+
+use Encode;
+
+use_ok 'Protocol::WebSocket::Frame';
+
+my $f = Protocol::WebSocket::Frame->new;
+
+is $f->version, 'draft-ietf-hybi-17';
+
+$f->append;
+ok not defined $f->next;
+$f->append('');
+ok not defined $f->next;
+
+# Not masked
+$f->append(pack('H*', "810548656c6c6f"));
+is $f->next_bytes, 'Hello';
+is $f->opcode => 1;
+ok $f->is_text;
+
+# Multi
+$f->append(pack('H*', "810548656c6c6f") . pack('H*', "810548656c6c6f"));
+is $f->next_bytes, 'Hello';
+is $f->next_bytes, 'Hello';
+
+# Masked
+$f->append(pack('H*', "818537fa213d7f9f4d5158"));
+is $f->next_bytes, 'Hello';
+is $f->opcode => 1;
+
+# Fragments
+$f->append(pack('H*', "010348656c"));
+ok not defined $f->next_bytes;
+$f->append(pack('H*', "80026c6f"));
+is $f->next_bytes, 'Hello';
+is $f->opcode => 1;
+
+# Multi fragments
+$f->append(pack('H*', "010348656c") . pack('H*', "80026c6f"));
+is $f->next_bytes, 'Hello';
+is $f->opcode => 1;
+
+# Injected control frame (1 fragment, ping, 2 fragment)
+$f->append(pack('H*', "010348656c"));
+$f->append(pack('H*', "890548656c6c6f"));
+$f->append(pack('H*', "80026c6f"));
+is $f->next_bytes, 'Hello';
+is $f->opcode => 9;
+is $f->next_bytes, 'Hello';
+is $f->opcode => 1;
+
+# Too many fragments
+$f->append(pack('H*', "010348656c")) for 1 .. 129;
+eval { $f->next_bytes };
+ok $@;
+
+# Ping request
+$f = Protocol::WebSocket::Frame->new;
+$f->append(pack('H*', "890548656c6c6f"));
+is $f->next_bytes => 'Hello';
+is $f->opcode => 9;
+ok $f->is_ping;
+
+# Ping response
+$f->append(pack('H*', "8a0548656c6c6f"));
+is $f->next_bytes => 'Hello';
+is $f->opcode => 10;
+ok $f->is_pong;
+
+# 256 bytes
+$f->append(pack('H*', "827E0100" . ('05' x 256)));
+is(length $f->next_bytes, 256);
+is $f->opcode => 2;
+ok $f->is_binary;
+
+# 64KiB
+$f->append(pack('H*', "827F0000000000010000" . ('05' x 65536)));
+is(length $f->next_bytes, 65536);
+is $f->opcode => 2;
+
+# Too big frame
+$f->append(pack('H*', "827F0000000000100000" . ('05' x (65536 + 1))));
+eval { $f->next_bytes };
+ok $@;
+
+$f = Protocol::WebSocket::Frame->new('Hello');
+is $f->to_bytes => pack('H*', "810548656c6c6f");
+
+$f = Protocol::WebSocket::Frame->new(
+ buffer => 'Hello',
+ masked => 1,
+ mask => '939139389'
+);
+is $f->to_bytes, pack('H*', "818537fa213d7f9f4d5158");
+
+# Ping
+$f = Protocol::WebSocket::Frame->new(buffer => 'Hello', type => 'ping');
+is $f->to_bytes => pack('H*', "890548656c6c6f");
+
+# 256 bytes
+$f = Protocol::WebSocket::Frame->new(
+ buffer => pack('H*', ('05' x 256)),
+ type => 'binary'
+);
+is $f->to_bytes => pack('H*', "827E0100" . ('05' x 256));
+
+# 64KiB bytes
+$f = Protocol::WebSocket::Frame->new(
+ buffer => pack('H*', ('05' x 65536)),
+ type => 'binary'
+);
+is $f->to_bytes => pack('H*', "827F0000000000010000" . ('05' x 65536));
+
+$f = Protocol::WebSocket::Frame->new;
+$f->append(Protocol::WebSocket::Frame->new('привет')->to_bytes);
+is $f->next => 'привет';
+
+# Too big
+$f = Protocol::WebSocket::Frame->new(
+ buffer => pack('H*', ('05' x (65536 + 1))),
+ type => 'binary'
+);
+eval { $f->to_bytes };
+ok $@;
+
+# initialize fin flag to zero
+$f = Protocol::WebSocket::Frame->new(buffer => 'Hello', fin => 0);
+is $f->to_bytes => pack('H*', "010548656c6c6f");
+
+# continuation frame
+$f = Protocol::WebSocket::Frame->new(buffer => "Hello", type => "continuation");
+is $f->to_bytes => pack('H*', "800548656c6c6f");
+
+# generate fragmented frames
+$f = Protocol::WebSocket::Frame->new();
+$f->append(
+ Protocol::WebSocket::Frame->new(
+ buffer => "Hello",
+ type => "binary",
+ fin => 0
+ )->to_bytes
+);
+is $f->next_bytes => undef;
+$f->append(
+ Protocol::WebSocket::Frame->new(
+ buffer => ", ",
+ type => "continuation",
+ fin => 0
+ )->to_bytes
+);
+is $f->next_bytes => undef;
+$f->append(
+ Protocol::WebSocket::Frame->new(
+ buffer => "World!",
+ type => "continuation",
+ fin => 1
+ )->to_bytes
+);
+is $f->next_bytes => "Hello, World!";
+is $f->opcode => 2;
+
+subtest 'constructor type values and is_$type are consistent' => sub {
+ my @types = qw(continuation text binary ping pong close);
+ foreach my $type (@types) {
+ my $f = Protocol::WebSocket::Frame->new(type => $type);
+ foreach my $test_type (@types) {
+ my $method = "is_$test_type";
+ if ($type eq $test_type) {
+ ok $f->$method, "type $type $method";
+ }
+ else {
+ ok !$f->$method, "type $type not $method";
+ }
+ }
+ }
+};
+
+subtest 'opcode accessor/mutator' => sub {
+ my $f = Protocol::WebSocket::Frame->new("Hello");
+ is $f->opcode => 1;
+ is $f->to_bytes => pack('H*', "810548656c6c6f");
+
+ $f->opcode(2);
+ is $f->opcode => 2;
+ is $f->to_bytes => pack('H*', "820548656c6c6f");
+
+ $f->opcode(0);
+ is $f->opcode => 0;
+ is $f->to_bytes => pack('H*', "800548656c6c6f");
+};
+
+subtest 'opcode immediately available' => sub {
+ my $f = Protocol::WebSocket::Frame->new(buffer => "Hello", opcode => 8);
+
+ is $f->opcode => 8;
+ is $f->to_bytes => pack('H*', "880548656c6c6f");
+};
+
+subtest 'if both type and opcode are specified in new(), type wins' => sub {
+ my $f = Protocol::WebSocket::Frame->new(
+ buffer => "Hello",
+ type => "ping",
+ opcode => 2
+ );
+
+ is $f->opcode => 9;
+ is $f->to_bytes => pack('H*', "890548656c6c6f");
+};
+
+subtest 'mask frame' => sub {
+ foreach my $test_case (
+ {label => "foobar", opcode => 9, buffer => "Foobar"},
+ {label => "empty", opcode => 1, buffer => ""},
+ {label => "character zero", opcode => 2, buffer => "0"},
+ {label => "number zero", opcode => 2, buffer => 0},
+ {label => "number 123", opcode => 1, buffer => 123},
+ ) {
+ my $f = Protocol::WebSocket::Frame->new(
+ buffer => $test_case->{buffer},
+ opcode => $test_case->{opcode},
+ masked => 1
+ );
+ my $frame_bytestring = $f->to_bytes;
+ my @frame_bytes = unpack("C*", $frame_bytestring);
+ ok $frame_bytes[1] & 0x80, "$test_case->{label}: MASK bit is set";
+
+ my $p = Protocol::WebSocket::Frame->new();
+ $p->append($frame_bytestring);
+ my $message = $p->next_bytes;
+ is $message => $test_case->{buffer}, "$test_case->{label}: parse buffer OK";
+ is $p->opcode => $test_case->{opcode}, "$test_case->{label}: parse opcode OK";
+ }
+};
+
+subtest 'append is destructive' => sub {
+ my $f = Protocol::WebSocket::Frame->new();
+
+ my $chunk = pack('H*', "810548656c6c6f");
+ $f->append($chunk);
+
+ is $chunk => "", "append() is destructive";
+};
+
+done_testing;
@@ -0,0 +1,95 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More tests => 57;
+
+use_ok 'Protocol::WebSocket::Request';
+
+my $req;
+
+$req = Protocol::WebSocket::Request->new;
+
+ok !$req->is_done;
+ok $req->parse;
+ok $req->parse('');
+ok $req->parse("GET /chat HTTP/1.1\x0d\x0a");
+is $req->state => 'fields';
+
+ok $req->parse("Host: server.example.com\x0d\x0a");
+is $req->state => 'fields';
+ok $req->parse("Cookie: foo=bar;alice=bob\x0d\x0a");
+is $req->state => 'fields';
+ok $req->parse("Upgrade: websocket\x0d\x0a");
+is $req->state => 'fields';
+ok $req->parse("Connection: Upgrade\x0d\x0a");
+is $req->state => 'fields';
+ok $req->parse("Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a");
+ok $req->parse("Origin: http://example.com\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Protocol: chat, superchat\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Version: 13\x0d\x0a\x0d\x0a");
+is $req->state => 'done';
+is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
+
+is $req->version => 'draft-ietf-hybi-17';
+is $req->subprotocol => 'chat, superchat';
+is $req->resource_name => '/chat';
+is $req->host => 'server.example.com';
+is $req->origin => 'http://example.com';
+is $req->cookies->to_string => 'foo=bar; alice=bob';
+
+$req = Protocol::WebSocket::Request->new;
+
+ok $req->parse("GET /chat HTTP/1.1\x0d\x0a");
+ok $req->parse("Host: server.example.com\x0d\x0a");
+ok $req->parse("Upgrade: websocket\x0d\x0a");
+ok $req->parse("Connection:keep-alive, Upgrade\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a");
+ok $req->parse("Origin: http://example.com\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Protocol: chat, superchat\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Version: 13\x0d\x0a\x0d\x0a");
+is $req->state => 'done';
+is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
+is $req->version => 'draft-ietf-hybi-17';
+is $req->subprotocol => 'chat, superchat';
+is $req->resource_name => '/chat';
+is $req->host => 'server.example.com';
+is $req->origin => 'http://example.com';
+
+$req = Protocol::WebSocket::Request->new;
+
+ok $req->parse("GET /chat HTTP/1.1\x0d\x0a");
+ok $req->parse("Host: server.example.com\x0d\x0a");
+ok $req->parse("Upgrade: websocket\x0d\x0a");
+ok $req->parse("Connection:keep-alive, Upgrade\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Origin: http://example.com\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Protocol: chat, superchat\x0d\x0a");
+ok $req->parse("Sec-WebSocket-Version: 13\x0d\x0a\x0d\x0a");
+is $req->state => 'done';
+is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
+is $req->version => 'draft-ietf-hybi-17';
+is $req->subprotocol => 'chat, superchat';
+is $req->resource_name => '/chat';
+is $req->host => 'server.example.com';
+is $req->origin => 'http://example.com';
+
+$req = Protocol::WebSocket::Request->new(
+ host => 'server.example.com',
+ origin => 'http://example.com',
+ cookies => Protocol::WebSocket::Cookie->new->parse('foo=bar; alice=bob'),
+ subprotocol => 'chat, superchat',
+ resource_name => '/chat',
+ key => 'dGhlIHNhbXBsZSBub25jZQ=='
+);
+is $req->to_string => "GET /chat HTTP/1.1\x0d\x0a"
+ . "Upgrade: WebSocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Host: server.example.com\x0d\x0a"
+ . "Cookie: foo=bar; alice=bob\x0d\x0a"
+ . "Origin: http://example.com\x0d\x0a"
+ . "Sec-WebSocket-Protocol: chat, superchat\x0d\x0a"
+ . "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a"
+ . "Sec-WebSocket-Version: 13\x0d\x0a"
+ . "\x0d\x0a";
@@ -0,0 +1,43 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More tests => 11;
+
+use IO::Handle;
+
+use_ok 'Protocol::WebSocket::Request';
+
+my $req;
+
+$req = Protocol::WebSocket::Request->new;
+
+open my $fh, '<', \'' or die $!;
+my $io = IO::Handle->new;
+$io->fdopen(fileno($fh), "r");
+$req = Protocol::WebSocket::Request->new_from_psgi(
+ { SCRIPT_NAME => '',
+ PATH_INFO => '/chat',
+ QUERY_STRING => 'foo=bar',
+ HTTP_UPGRADE => 'websocket',
+ HTTP_CONNECTION => 'Upgrade',
+ HTTP_HOST => 'server.example.com',
+ HTTP_COOKIE => 'foo=bar',
+ HTTP_SEC_WEBSOCKET_ORIGIN => 'http://example.com',
+ HTTP_SEC_WEBSOCKET_PROTOCOL => 'chat, superchat',
+ HTTP_SEC_WEBSOCKET_KEY => 'dGhlIHNhbXBsZSBub25jZQ==',
+ HTTP_SEC_WEBSOCKET_VERSION => 13
+ }
+);
+$req->parse($io);
+is $req->resource_name => '/chat?foo=bar';
+is $req->subprotocol => 'chat, superchat';
+is $req->upgrade => 'websocket';
+is $req->connection => 'Upgrade';
+is $req->host => 'server.example.com';
+is $req->cookies->to_string => 'foo=bar';
+is $req->origin => 'http://example.com';
+is $req->key => 'dGhlIHNhbXBsZSBub25jZQ==';
+ok $req->is_done;
+is $req->version => 'draft-ietf-hybi-17';
@@ -0,0 +1,32 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More tests => 11;
+
+use_ok 'Protocol::WebSocket::Response';
+
+my $res;
+
+$res = Protocol::WebSocket::Response->new;
+ok $res->parse("HTTP/1.1 101 Switching Protocols\x0d\x0a");
+ok $res->parse("Upgrade: websocket\x0d\x0a");
+ok $res->parse("Connection: Upgrade\x0d\x0a");
+ok $res->parse("Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\x0d\x0a");
+ok $res->parse("Sec-WebSocket-Protocol: chat\x0d\x0a");
+ok $res->parse("\x0d\x0a");
+ok $res->is_done;
+ok !$res->secure;
+is $res->subprotocol => 'chat';
+
+$res = Protocol::WebSocket::Response->new(
+ key => 'dGhlIHNhbXBsZSBub25jZQ==',
+ subprotocol => 'chat'
+);
+is $res->to_string => "HTTP/1.1 101 WebSocket Protocol Handshake\x0d\x0a"
+ . "Upgrade: WebSocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\x0d\x0a"
+ . "Sec-WebSocket-Protocol: chat\x0d\x0a"
+ . "\x0d\x0a";
@@ -0,0 +1,31 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use Test::More tests => 15;
+
+use_ok 'Protocol::WebSocket::Handshake::Server';
+
+my $h = Protocol::WebSocket::Handshake::Server->new;
+
+ok !$h->is_done;
+ok $h->parse;
+ok $h->parse('');
+
+ok $h->parse("GET /demo HTTP/1.1\x0d\x0a");
+ok $h->parse("Upgrade: websocket\x0d\x0a");
+ok $h->parse("Connection: Upgrade\x0d\x0a");
+ok $h->parse("Host: example.com\x0d\x0a");
+ok $h->parse("Origin: http://example.com\x0d\x0a");
+ok $h->parse("Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\x0d\x0a");
+ok $h->parse("Sec-WebSocket-Version: 13\x0d\x0a");
+ok $h->parse("\x0d\x0a");
+ok !$h->error;
+ok $h->is_done;
+
+is $h->to_string => "HTTP/1.1 101 WebSocket Protocol Handshake\x0d\x0a"
+ . "Upgrade: WebSocket\x0d\x0a"
+ . "Connection: Upgrade\x0d\x0a"
+ . "Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\x0d\x0a"
+ . "\x0d\x0a";
@@ -3,7 +3,7 @@
use strict;
use warnings;
-use Test::More tests => 30;
+use Test::More tests => 36;
use_ok 'Protocol::WebSocket::URL';
@@ -11,6 +11,7 @@ my $url = Protocol::WebSocket::URL->new;
ok $url->parse('ws://example.com');
ok !$url->secure;
is $url->host => 'example.com';
+is $url->port => '80';
is $url->resource_name => '/';
$url = Protocol::WebSocket::URL->new;
@@ -36,7 +37,14 @@ $url = Protocol::WebSocket::URL->new;
ok $url->parse('ws://example.com/demo?foo=bar');
ok !$url->secure;
is $url->host => 'example.com';
-is $url->resource_name => '/demo';
+is $url->resource_name => '/demo?foo=bar';
+
+$url = Protocol::WebSocket::URL->new;
+ok $url->parse('wss://example.com');
+ok $url->secure;
+is $url->host => 'example.com';
+is $url->port => '443';
+is $url->resource_name => '/';
$url = Protocol::WebSocket::URL->new;
ok $url->parse('wss://example.com:3000');
@@ -0,0 +1,102 @@
+#!/usr/bin/env perl
+
+use strict;
+use warnings;
+
+use lib 'lib';
+
+use Devel::Hexdump ();
+use AnyEvent;
+use AnyEvent::Socket;
+use AnyEvent::Handle;
+use Protocol::WebSocket::Client;
+
+$|++;
+
+sub debug { warn "$_[0]\n" }
+
+sub debug_hex {
+ debug('v' x 10);
+ debug(Devel::Hexdump::xd($_[0]));
+ debug('^' x 10);
+}
+
+my $cv = AnyEvent->condvar;
+
+my ($url, $version) = @ARGV;
+die "Usage: $0 <url> <version>" unless $url;
+
+my $client = Protocol::WebSocket::Client->new(url => $url, version => $version);
+my $ws_handle;
+
+debug("! Using version '$version'");
+
+debug(
+ "! Connecting to '" . $client->url->host . ':' . $client->url->port . "'");
+my ($host, $port) = ($client->url->host, $client->url->port);
+tcp_connect $host, $port, sub {
+ my ($fh) = @_ or return $cv->send("Connect failed: $!");
+
+ debug("! Connected");
+
+ $ws_handle = AnyEvent::Handle->new(
+ fh => $fh,
+ on_eof => sub {
+ debug("! Server disconnected");
+ $cv->send;
+ },
+ on_error => sub {
+ debug("! Error: " . $_[1]);
+ $cv->send;
+ },
+ on_read => sub {
+ my ($handle) = @_;
+
+ my $buf = delete $handle->{rbuf};
+
+ debug("< Reading");
+ debug_hex($buf);
+
+ $client->read($buf);
+ }
+ );
+
+ $client->on(
+ write => sub {
+ my $client = shift;
+ my ($buf) = @_;
+
+ debug("> Writing");
+ debug_hex($buf);
+
+ $ws_handle->push_write($buf);
+ }
+ );
+ $client->on(
+ read => sub {
+ my $self = shift;
+ my ($buf) = @_;
+
+ }
+ );
+ $client->connect;
+};
+
+my $stdin = AnyEvent::Handle->new(
+ fh => \*STDIN,
+ on_read => sub {
+ my $handle = shift;
+
+ my $buf = delete $handle->{rbuf};
+
+ $client->write($buf);
+ },
+ on_eof => sub {
+ $client->disconnect;
+
+ $ws_handle->destroy;
+ $cv->send;
+ }
+);
+
+$cv->wait;