ModuleBuilder VS Stucco

I'm using the ModuleBuilder module to perform the build. This follows the "Public", and "Private" folder conventions, etc... It builds the module into one single `.psm1`, from all the files in the public and private folders. Any function files in the public folder are automatically added to the exported module functions in the module's `.psd1` manifest.

I recommend using this module. You organize your module to have a source folder with private and public folders containing your private and public functions in individual files. You can then invoke Build-Module and the module will put it all together into module. I recommend reading their readme for more information on how to set it up. https://github.com/PoshCode/ModuleBuilder

The closest to that is using something like ModuleBuilder and building a single psm1 as a build step. That's the closest to a supported way to do that.

I've always just used my own script for this so I can't tell you more than what you yourself can read here: https://github.com/PoshCode/ModuleBuilder

Link: https://github.com/PoshCode/ModuleBuilder

My team uses https://github.com/PoshCode/ModuleBuilder to do module building, but it's much along the same idea as what you're doing.

Used devblackops/Stucco: An opinionated Plaster template for high-quality PowerShell modules (github.com) to build the core module framework that has build capabilities and module dependencies built in, but still trying to understand the process from start to finish.

The stucco module offers a great starting place for building a module where the classes, private functions, and public functions are all kept in their own files and can be “compiled” into a single PSM1 at build time. I don’t think I’ve ever put everything in their own PSM1’s before. Instead, dot source the files you need in your root PSM1.

Like I did here : https://github.com/devblackops/Stucco/commit/21bce8c254e4578ec2bfebd29115af4f22d85348

I saw that the Stucco project has support for generating project files that can also generate Read The Docs sites but haven't tried it yet myself: devblackops/Stucco

You may also want to check out Stucco, which is my opinionated Plaster template for creating modules. It does most of the heavy lifting for you such as a decent Pester testing setup, psake tasks for local build/test automation, and your choice of CI. I'm also writing a book called Building PowerShell Modules on Leanpub which goes into all of this in detail.