view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN

Crypt::SecretBuffer
-------------------

### About

This module provides a buffer object which attempts to prevent the Perl core
from accidentally retaining copies of its data.  It is similar in purpose to
SecureString of the .NET framework.  It also provides some utilities for
loading and exporting the data without the value getting copied into a scalar.

### Installing

When distributed, all you should need to do is run

    perl Makefile.PL
    make install

or better,

    cpanm Crypt-SecretBuffer-0.xxx.tar.gz

or from CPAN:

    cpanm Crypt::SecretBuffer

### Developing

However, if you're trying to build from a fresh Git checkout, you'll need
the Dist::Zilla tool (and many plugins) to create the Makefile.PL.

    cpanm Dist::Zilla
    dzil authordeps --missing | cpanm
    dzil build

While Dist::Zilla takes the busywork and mistakes out of module authorship,
it fails to address the need of XS authors to easily compile XS projects
and run single test cases rather than the whole test suite.  For this, you
might find the following script handy:

    ./dzil-prove t/01-ctor.t  # or any other test case

which runs "dzil build" to get a clean dist, then enters the build directory
and runs "perl Makefile.PL" to compile the XS, then "prove -lvb t/01-ctor.t".

### Copyright

This software is copyright (c) 2025-2026 by Michael Conrad

This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.