Test-Smoke

Changes for version 1.79_02 - 2022-08-18

(Abe Timmerman, Thu, 18 Aug 2022 20:47:54 +0200) Autocommit for distribution Test::Smoke 1.79_02 (test)

Changes for version 1.79_01 - 2022-08-17

(Abe Timmerman, Wed, 17 Aug 2022 08:59:35 +0200) Autocommit for distribution Test::Smoke 1.79_01 (test)
(Bram, Mon, 15 Aug 2022 21:07:39 +0200) Include custom hostname in smoke report
In commit 5920e4cbcef17d7b00206d52dddd5b8ba33aafea
Author: abeltje <abeltje@test-smoke.org>
Date: Fri Apr 20 22:38:11 2018 +0200
Solve https://github.com/abeltje/Test-Smoke/pull/37
I don't like using ENVironment vars for legitimate settings in the
software, so I'd rather use the configfile for that.
Add a question in configsmoke.pl
The option was added to set a custom hostname in the configfile.
In that commit the custom hostname is used when sending the report to
the smokedb (that is: in `Test::Smoke::Reporter::smokedb_data`).
But the hostname is also used in the preamble of the report and that
code was left unchanged so the real hostname still leaked in the report.
Fix this and (also) use the custom hostname in the `preamble` function.
(+ add a test for it, test file is based on t/report-usernote.t)
(Note: commit 5920e4c was based on a PR and in the original commit
the preamble function was also updated. That part of the
change got lost when converting it to a config option.)
(Bram, Mon, 15 Aug 2022 21:24:06 +0200) Use `done_testing()` in t/report-usernote.t
The test file was added in commit 792da5b7176f3141f5c45e54e16a4fa1d0b34230
Author: Abe Timmerman <abeltje@diefenbaker.local>
Date: Mon Apr 15 00:27:00 2013 +0200
Implement variable position for the user_note:
- un_position == 'top' => at the start of the report
- un_position == <!top> => at the end of the report
My guess: `done_testing()` was commented support older perls (with an
oder versions of Test::More which lacked support for it).
Today: plenty of other files in the repo are using `done_testing()` so
there is no reason why t/report-usernote.t shouldn't be using it.
(Bram, Thu, 18 Aug 2022 16:00:55 +0200) Skip tests with git when `git init fails`
When `git init` failed then the test would continue which is undesirable.
When running `make test` in the Test-Smoke git repo I observed:
- `git init` failed (because of the '-b' option, unknown in my git version)
- there was a test failure since it checks the exit code
- it continues running git commands, including `git commit`
Result: changes were committed to the Test-Smoke git repo and *not* to the
test repo that is normally used inside the test.
Fix this by skipping the git tests when `git init` fails.
(Bram, Thu, 18 Aug 2022 16:07:57 +0200) Silence default branch name warning
On a more recent version of git there is a warning about the
default branch name. The warning can be silenced by
- using the '-b' option to set a (different) default branch name
- using the '-q' option
In commit 0f7ceb8c4aa1f2f64a14b86f2fcbef32c7981787 the '-b' option
was added to `git init` but that breaks compatibility with older git
versions. These do not know the '-b' option and thus fail.
To preserve backwards and future compatibility:
- use the '-q' option to silence the warning
- use `git -c init.defaultBranch=master init` to ensure the default branch
name is master for the test repo.
(Older git versions use 'master' by default, newer versions currently
use 'master' but that may change in the future. So git-upstream decides
to change default name then the '-c' should do the trick to keep it as
'master')
(Abe Timmerman, Thu, 18 Aug 2022 17:21:50 +0200) Merge branch 'bram-perl-bram/git-init'
https://github.com/abeltje/Test-Smoke/pull/61
(Abe Timmerman, Thu, 18 Aug 2022 17:32:32 +0200) Merge branch 'bram/custom-hostname' of https://github.com/bram-perl/Test-Smoke into bram-perl-bram/custom-hostname
https://github.com/abeltje/Test-Smoke/pull/58
(Abe Timmerman, Thu, 18 Aug 2022 17:36:54 +0200) Merge branch 'bram-perl-bram/custom-hostname' into bugfixes/by-bram
https://github.com/abeltje/Test-Smoke/pull/58
(Abe Timmerman, Thu, 18 Aug 2022 17:38:30 +0200) Merge branch 'bram/usernote-done-testing' of https://github.com/bram-perl/Test-Smoke into bram-perl-bram/usernote-done-testing
(Abe Timmerman, Thu, 18 Aug 2022 17:39:06 +0200) Merge branch 'bram-perl-bram/usernote-done-testing' into bugfixes/by-bram
https://github.com/abeltje/Test-Smoke/pull/59
(Abe Timmerman, Thu, 18 Aug 2022 18:17:52 +0200) Make sure all filehandles are AUTOFLUSH during smoke
Inspired by: https://github.com/abeltje/Test-Smoke/pull/60
It appears that Windows likes it better if the filehandles are on
autoflush during the actual smoke.
(Abe Timmerman, Thu, 18 Aug 2022 18:21:19 +0200) Merge branch 'bugfixes/by-bram'
Merge work by Bram:
- fix on Tux's fix for the git-defaultBranch (#61)
- autoflush for filehandles used during the actual smoke (not #60)
- fix forgotten `done_testing()` (#59(
- fix leak of actual hostname in the smoke-report (#58)
(Bram, Thu, 18 Aug 2022 19:00:23 +0200) Cache `$daemon->sockhost` in t/poster-post.t
On my Windows 10 system 't/poster-post.t' was stuck.
Debugging showed that this *apparently* happened when it tried to get
the value of `$daemon->sockhost` for the test with 'HTTP::Tiny'.
Earlier calls for `$daemon->sockhost` (for the curl test) did succeed
and did behave as expected...
Sample output of a run that was stuck:
# HTTP::Daemon (6.12): IPv6 (::1)
# Temporary daemon at: http://[::1]:57965/
ok 1 - An object of class 'Test::Smoke::Poster::LWP_UserAgent' isa 'Test::Smoke::Poster::LWP_UserAgent'
ok 2 - write_json
[2022-08-18 16:47:15Z] Posting to http://[::1]:57965/report via LWP::UserAgent.
[2022-08-18 16:47:15Z] Reading from (C:\Perl\Test-Smoke\t\testsuite.jsn)
[2022-08-18 16:47:15Z] Report data: {"sysinfo":"MSWin32"}
[2022-08-18 16:47:15Z] [CoreSmokeDB] {"id":42}
ok 3 - Got id (LWP::Useragent: http://[::1]:57965/report)
ok 4 - An object of class 'Test::Smoke::Poster::Curl' isa 'Test::Smoke::Poster::Curl'
ok 5 - write_json
[2022-08-18 16:47:15Z] Posting to "http://[::1]:57965/report" via curl.
[2022-08-18 16:47:15Z] Reading from (C:\Perl\Test-Smoke\t\testsuite.jsn)
[2022-08-18 16:47:15Z] Report data: {"sysinfo":"MSWin32"}
[2022-08-18 16:47:15Z] In pwd(C:/Perl/Test-Smoke) running:
[2022-08-18 16:47:15Z] qx[C:\Windows\system32\curl.EXE --globoff -A "Test::Smoke/1.79_01 (Test::Smoke::Poster::Curl)" -d json=%7B%22sysinfo%22%3A%22MSWin32%22%7D "http://[::1]:57965/report"]
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 49 100 9 100 40 522 2322 --:--:-- --:--:-- --:--:-- 3062
[2022-08-18 16:47:15Z] [CoreSmokeDB] {"id":42}
ok 6 - Got id (curl: http://[::1]:57965/report)
And then it kept on waiting..
Caching the value of `$daemon->sockhost` appears to fix it..
(I've got no idea why tho)
With this patch applied and re-running the test it continues:
ok 7 - An object of class 'Test::Smoke::Poster::HTTP_Tiny' isa 'Test::Smoke::Poster::HTTP_Tiny'
ok 8 - write_json
[2022-08-18 16:56:15Z] Posting to http://[::1]:57990/report via HTTP::Tiny.
[2022-08-18 16:56:15Z] Reading from (C:\Perl\Test-Smoke\t\testsuite.jsn)
[2022-08-18 16:56:15Z] Report data: {"sysinfo":"MSWin32"}
[2022-08-18 16:56:15Z] [CoreSmokeDB] {"id":42}
ok 9 - Got id (HTTP::Tiny: http://[::1]:57990/report
ok 10 - no warnings
1..10
(Abe Timmerman, Thu, 18 Aug 2022 19:20:38 +0200) Merge branch 'bram/windows-poster_post.t' of https://github.com/bram-perl/Test-Smoke into bram-perl-bram/windows-poster_post.t
(Abe Timmerman, Thu, 18 Aug 2022 19:21:05 +0200) Merge branch 'bram-perl-bram/windows-poster_post.t' into bugfixes/by-bram
https://github.com/abeltje/Test-Smoke/pull/63
(Abe Timmerman, Thu, 18 Aug 2022 20:24:53 +0200) Add a target to the makefile to run the xt/ tests
No convention but on IRC#smoke:
17:41:14 Bram | Is there a make target to run the tests in xt/?
19:26:26 abeltje | no make target for running tests in xt/; is there a convention for that?
19:29:36 ilmari | dzil has an `xtest` command to run them
So I named it 'xtest' and used XTEST_FILES to select files to run:
make xtest TEST_VERBOSE=1 XTEST_FILES=xt/0*.t
but this also works:
make xtest
(Abe Timmerman, Thu, 18 Aug 2022 20:41:55 +0200) Merge branch 'feature/xtest-make-target'

Documentation

README

ReleaseNotes

These are the Release Notes for 1.30

W32Configure.pl

Configure a Makefile for the Windows port of perl

archiverpt.pl

Patch the sourcetree

chkbcfg.pl

Check the buildconfigfile specified on the commandline

configsmoke.pl

Create a configuration for tssmokeperl.pl

mailrpt.pl

Send the smoke report by mail

patchtree.pl

Patch the sourcetree

runsmoke.pl

Configure, build and test bleading edge perl

sendrpt.pl

Send the smoke report by protocol

smokeperl.pl

The perl Test::Smoke suite

smokestatus.pl

Check the status of a running smoke

synctree.pl

Cleanup and sync the perl-current source-tree

FAQ

Test::Smoke frequently asked questions

Modules

Test::Smoke

The Perl core test smoke suite

Test::Smoke::App::AppOption

Object that represents an Application Option.

Test::Smoke::App::AppOptionCollection

A collection of AppOption objects.

Test::Smoke::App::Archiver

The tsarchive.pl application.

Test::Smoke::App::Base

Baseclass for Test::Smoke::App::* applications.

Test::Smoke::App::Options

A collection of application configs and config options.

Test::Smoke::App::Reporter

The tsreport.pl application.

Test::Smoke::App::RunSmoke

The tsrunsmoke.pl application.

Test::Smoke::App::SendReport

Implementation for tssendrpt.pl

Test::Smoke::App::SmokePerl

The tssmokeperl.pl application.

Test::Smoke::App::SyncTree

Synchronise the perl source tree from a source.

Test::Smoke::Archiver

Archive the smoke files.

Test::Smoke::BuildCFG

OO interface for handling build configurations

Test::Smoke::FTPClient

Implement a mirror like object

Test::Smoke::LogMixin

"Role" that adds logging methods to "traditional" objects.

Test::Smoke::Mailer

Factory for objects to send the report.

Test::Smoke::Mailer::Base

baseclass for Mailers

Test::Smoke::ObjectBase

Base class for objects (AUTOLOADed accessors)

Test::Smoke::Patcher

OO interface to help patching the source-tree

Test::Smoke::Policy

OO interface to handle the Policy.sh stuff.

Test::Smoke::Poster

Factory for poster objects.

Test::Smoke::Poster::Base

Base class for the posters to CoreSmokeDB.

Test::Smoke::Poster::Curl

Poster subclass using curl.

Test::Smoke::Poster::HTTP_Tiny

Poster subclass using HTTP::Tiny.

Test::Smoke::Poster::LWP_UserAgent

Poster subclass using LWP::UserAgent.

Test::Smoke::Reporter

OO interface for handling the testresults (mktest.out)

Test::Smoke::Smoker

OO interface to do one smoke cycle.

Test::Smoke::SourceTree

Manipulate the perl source-tree

Test::Smoke::Syncer

Factory for syncer objects.

Test::Smoke::Util

Take out some of the functions of the smoke suite.

Test::Smoke::Util::Execute

Run a command and return its output.

Test::Smoke::Util::FindHelpers

Functions to help find Helpers (modules/bins)

Test::Smoke::Util::LoadAJSON

A JSON:PP/JSON::XS Factory Class

Test::Smoke::Util::Serialise

Serialise (stringify) values, a bit like Data::Dumper.

Test::Smoke::Util::Win32ErrorMode

Utility function to switch off the error-popup for the current process.

Provides

Test::Smoke::BuildCFG::Config

in lib/Test/Smoke/BuildCFG.pm

Test::Smoke::Logger

in lib/Test/Smoke/LogMixin.pm

Test::Smoke::Mailer::MIME_Lite

in lib/Test/Smoke/Mailer/MIME_Lite.pm

Test::Smoke::Mailer::Mail_Sendmail

in lib/Test/Smoke/Mailer/Mail_Sendmail.pm

Test::Smoke::Mailer::Mail_X

in lib/Test/Smoke/Mailer/Mail_X.pm

Test::Smoke::Mailer::SendEmail

in lib/Test/Smoke/Mailer/SendEmail.pm

Test::Smoke::Mailer::Sendmail

in lib/Test/Smoke/Mailer/Sendmail.pm

Test::Smoke::Syncer::Base

in lib/Test/Smoke/Syncer/Base.pm

Test::Smoke::Syncer::Copy

in lib/Test/Smoke/Syncer/Copy.pm

Test::Smoke::Syncer::FTP

in lib/Test/Smoke/Syncer/FTP.pm

Test::Smoke::Syncer::Forest

in lib/Test/Smoke/Syncer/Forest.pm

Test::Smoke::Syncer::Git

in lib/Test/Smoke/Syncer/Git.pm

Test::Smoke::Syncer::Hardlink

in lib/Test/Smoke/Syncer/Hardlink.pm

Test::Smoke::Syncer::Rsync

in lib/Test/Smoke/Syncer/Rsync.pm

Test::Smoke::Syncer::Snapshot

in lib/Test/Smoke/Syncer/Snapshot.pm

Other files

To install Test::Smoke, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Test::Smoke

CPAN shell

perl -MCPAN -e shell
install Test::Smoke

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)