######################################################################
    Acme::HashKeyOrderBrokenAgain 0.01
######################################################################

NAME
    Acme::HashKeyOrderBrokenAgain - Request reproducable hash keys order
    within a script and verify if Perl complies

SYNOPSIS
        use Acme::HashKeyOrderBrokenAgain

        if( Acme::HashKeyOrderBrokenAgain::hash_key_order_reproducable() ) {
            print "Whoa! PERL_PERTURB_KEYS=DETERMINISTIC doesn't work!\n";
        }

DESCRIPTION
    We all know that Perl's keys() function will return the keys of a hash
    in unpredictable order. However, for testing purposes, we sometimes need
    the keys by keys() to be returned in deterministic order, which means
    that although the order can't be predicted up front, subsequent calls to
    keys() within the same script should return the keys in the same order
    if (and only if)

        $ENV{ PERL_PERTURB_KEYS } = "DETERMINISTIC"

    is set.

    This module checks if the feature actually works, and will hopefully
    alert Perl Porters via automatic CPAN smoke tests if it's broken. If the
    above assumption is incorrect, please drop me a message, I'll adapt this
    module accordingly.

    See

        http://perlmonks.org/?node_id=1056280

    and

       https://github.com/mschilli/php-httpbuildquery-perl/pull/3

    for details on this issue.

LEGALESE
    Copyright 2014 by Mike Schilli, all rights reserved. This program is
    free software, you can redistribute it and/or modify it under the same
    terms as Perl itself.

AUTHOR
    2014, Mike Schilli <m@perlmeister.com>

