Migration guide or helpers for PDK users

[bwitt]

As a user of PDK, it'd be nice to have some examples or helper aliases for how to use this, so I can migrate from PDK to this.

Maybe something like

• pdk validate -> validate
• pdk test unit -> test
• pdk bundle exec onceover show puppetfile -> --entrypoint onceover with show puppetfile task

[corporate-gadfly]

Some other common PDK commands.

Module Creation & Management

pdk new module - Create a new Puppet module
pdk new class - Add a new class to your module
pdk new defined_type - Create a new defined type
pdk new task - Create a new Puppet task

[rwaffen]

@trefzer added the evb script to the repo. with it in the path and be in in a module/control repo you can have shortcuts. for the first two from OP we got this. maybe we can add more there

https://github.com/voxpupuli/container-voxbox?tab=readme-ov-file#easyvoxbox-evb

$ sudo ln -s $PWD/evb /usr/local/bin/evb

$ evb validate
---> syntax:manifests
---> syntax:templates
---> syntax:hiera:yaml
Files                     5
Modules                   0 (0 undocumented)
Classes                   0 (0 undocumented)
Constants                 0 (0 undocumented)
Attributes                0 (0 undocumented)
Methods                   0 (0 undocumented)
Puppet Classes            4 (0 undocumented)
Puppet Data Types         0 (0 undocumented)
Puppet Data Type Aliases  0 (0 undocumented)
Puppet Defined Types      1 (0 undocumented)
Puppet Types              0 (0 undocumented)
Puppet Providers          0 (0 undocumented)
Puppet Functions          0 (0 undocumented)

[rwaffen]

Reminder for me. Document usage better.

[tuxmea]

Please also document required changes to Gemfile.
When using voxbox on a pdk repo the following error occurs:

docker run -it --rm -v $PWD:/repo:Z ghcr.io/voxpupuli/voxbox:8.24.2-latest spec
I, [2026-02-12T15:19:55.098821 #1]  INFO -- : Creating symlink /repo/spec/fixtures/modules/demo => /repo
/usr/local/bin/ruby -I/usr/local/bundle/gems/rspec-support-3.13.7/lib:/usr/local/bundle/gems/rspec-core-3.13.6/lib /usr/local/bundle/gems/rspec-core-3.13.6/exe/rspec --pattern spec/\{aliases,classes,defines,functions,hosts,integration,plans,tasks,type_aliases,types,unit\}/\*\*/\*_spec.rb

An error occurred while loading ./spec/classes/demo_spec.rb. - Did you mean?
                    rspec ./spec/classes/timesync_spec.rb
                    rspec ./spec/classes/users_spec.rb

Failure/Error: require 'puppetlabs_spec_helper/module_spec_helper'

LoadError:
  cannot load such file -- puppetlabs_spec_helper/module_spec_helper
# ./spec/spec_helper.rb:7:in `<top (required)>'
# ./spec/classes/demo_spec.rb:3:in `<top (required)>'

[rwaffen]

you mean to the ruby code (require gems/classes which are not used anymore)?
the Gemfile/Rakefile from the project itself shouldn't/isn't really used here.

[stephenCSE]

the Gemfile/Rakefile from the project itself shouldn't/isn't really used here.

The Gemfile and/or Gemfile.lock from PDK does cause errors with voxbox if it is present in the repo. Documentation or a warning from the evb script would help us switch from pdk.

I'm not a ruby developer and don't understand most of the stuff in the Gemfile. It took me far to long to realize I could delete the Gemfile and voxbox worked. Otherwise voxbox is really great. thanks.

[rwaffen]

sure thing, that could be put in the readme!