/ 
Crypt-PostgreSQL-0.03
/ README_BUILD

Build and Release Scripts for Crypt-PostgreSQL

Documentation for generating CPAN package: https://metacpan.org/pod/Dist::Zilla::Starter

Debian/Ubuntu installation: sudo apt-get install libdist-zilla-perl

This project includes custom scripts to manage the custom plugin SyncVersionFromDist.

Available Scripts

Build Scripts

dzil_build.sh

Executes normal build for final distribution.

./dzil_build.sh

dzil_build.sh --trial

Executes trial build passing the --trial parameter.

./dzil_build.sh --trial

dzil_build_trial.sh

Executes trial build by calling dzil_build.sh --trial.

./dzil_build_trial.sh

Release Scripts

dzil_release_trial.sh

Executes complete release with --trial (build + test + upload to CPAN).

./dzil_release_trial.sh

dzil_release.sh

Executes normal release (build + test + upload to CPAN).

./dzil_release.sh

dzil_release.sh --trial

Executes trial release passing the --trial parameter.

./dzil_release.sh --trial

Why Use These Scripts?

These scripts are necessary because:

  • Custom Plugin: The project uses a custom Dist::Zilla plugin (SyncVersionFromDist)

  • PERL5LIB: The plugin is located in lib/Dist/Zilla/Plugin/ and must be available during build

  • Package Exclusion: The plugin and scripts are excluded from the final package via [PruneFiles]

Features

  • ✅ Automatically set PERL5LIB=lib

  • ✅ Execute build/release with Dist::Zilla

  • ✅ Verify operation success

  • ✅ Provide clear feedback on operation

  • ✅ Handle both normal and trial versions

Notes

  • Scripts are excluded from the final package

  • The SyncVersionFromDist plugin automatically synchronizes versions between Crypt::PostgreSQL and Crypt::TSD

  • No need to manually run PERL5LIB=lib dzil build

  • dzil release commands require interactive confirmation