Post-processing

警告

A post-processing script (if used) will be invoked each time releng-tool reaches the final stage of a build.

Prospect

At this time, releng-tool support only post-build scripts. It is planned to introduced support for some image-related helpers (i.e. package helpers). This may introduce a reserved releng-post-image script in future releases.

After each package has been processed, a project has the ability to perform post-processing. Post-processing allows a developer to cleanup the target directory, build an archive/package from generated results and more. If a project contains a releng-post-build inside the root directory, the post-processing script will be invoked in the final stage of a build.

A developer may start out with the following post-processing script <root>/releng-post-build:

└── my-releng-tool-project/
    ├── package/
    │   └── ...
    ├── releng
    └── releng-post-build             <----

With the contents:

print('post processing...')

The above script will output the newly inserted print message at the end of a build process:

$ releng-tool
...
generating license information...
post processing...
(success) completed (0:01:30)

A developer can take advantage of environment variables and script helpers for additional support.

It is important to note that post-processing scripts will be invoked each time a releng-tool invoke reaches the final stage of a build. A developer should attempt to implement the post-processing scripts in a way that it can be invoked multiple times. For example, if a developer decides to move a file out of the target directory into an interim directory when building an archive, it is most likely that a subsequent request to build may fail since the file can no longer be found inside the target directory.