Exclude files and directories in tarfile for CPAN upload

LanX has asked for the wisdom of the Perl Monks concerning the following question:

the title says it already, I have a project directory for a distribution which I want to tar.gz for CPAN.

But it contains backup files, a massive .git dir and a dir with dev stuff (experimental code, etc)

What's the easiest way to filter them out? Kind of similar to .gitignore?

...

Well while typing this post I found those promising exclude options and will test them out.

Posting this anyway as an info for the archives ... š

Cheers Rolf
_{(addicted to the Perl Programming Language :)

see Wikisyntax for the Monastery}

š) no pun intended :)

Comment on Exclude files and directories in tarfile for CPAN upload

Replies are listed 'Best First'.
Re: Exclude files and directories in tarfile for CPAN upload by SankoR (Prior) on Oct 24, 2024 at 23:22 UTC
Are you hand rolling dists? The classics (ExtUtils::MakeMaker, Module::Build, Dist::Zilla, and Minilla) all support `MANIFEST.SKIP`.	[reply] [d/l]
Re^2: Exclude files and directories in tarfile for CPAN upload by LanX (Saint) on Oct 25, 2024 at 10:11 UTC
I went canonical and read https://www.cpan.org/misc/cpan-faq.html#How_contribute_modules https://www.cpan.org/modules/04pause.html both don't really mention ExtUtils::MakeMaker, Module::Build, Dist::Zilla, and Minilla As a side note: Confusingly did Module::Starter create a README, but PAUSE says not to upload one... Cheers Rolf _{(addicted to the Perl Programming Language :) see Wikisyntax for the Monastery}	[reply]
Re^3: Exclude files and directories in tarfile for CPAN upload by Discipulus (Canon) on Oct 25, 2024 at 10:21 UTC
So do you used Module::Starter ? The short documentation of the module says: `The ignores_type is a new feature that allows one to create SCM-specif +ic ignore files. These are the mappings: ignores_type => 'generic' # default, creates 'ignore.txt' ignores_type => 'cvs' # creates .cvsignore ignores_type => 'git' # creates .gitignore ignores_type => 'hg' # creates .hgignore ignores_type => 'manifest' # creates MANIFEST.SKIP` [download] Go canonical and use my guide ;) L* PS the above module ships with the `module-starter` program inside `/bin` and this is the suggested method to follow. The program has the option --ignores=type the sets the above mentioned `ignores_type` internal option. It defaults to `txt` creating `ignore.txt` There are no rules, there are no thumbs.. Reinvent the wheel, then learn The Wheel; may be one day you reinvent one of THE WHEELS.	[reply] [d/l] [select]
Re^4: Exclude files and directories in tarfile for CPAN upload by LanX (Saint) on Oct 25, 2024 at 11:14 UTC
Re^5: Exclude files and directories in tarfile for CPAN upload by choroba (Cardinal) on Oct 25, 2024 at 13:07 UTC
Some notes below your chosen depth have not been shown here
Re^3: Exclude files and directories in tarfile for CPAN upload by hippo (Archbishop) on Oct 25, 2024 at 12:50 UTC
Confusingly did Module::Starter create a README, but PAUSE says not to upload one... The PAUSE document is advising you not to upload a separate README file individually outside of the distribution tarball. That's a totally different thing from including a README inside the tarball which you absolutely should do. 🦛	[reply]
Re^4: Exclude files and directories in tarfile for CPAN upload by choroba (Cardinal) on Oct 25, 2024 at 13:04 UTC
Re: Exclude files and directories in tarfile for CPAN upload by Discipulus (Canon) on Oct 25, 2024 at 06:55 UTC
Hello, I'm with SankoR and, for the archives, you can read about `MANIFEST.SKIP` in What are the files in a CPAN distribution? too. L* There are no rules, there are no thumbs.. Reinvent the wheel, then learn The Wheel; may be one day you reinvent one of THE WHEELS.	[reply] [d/l] [select]
Re: Exclude files and directories in tarfile for CPAN upload by stevieb (Canon) on Oct 25, 2024 at 07:55 UTC
I'm with my previously posting Monks... `MANIFEST.SKIP`. When first writing for the CPAN, it's easy to manually ensure. When you're to the point of maintaining multiple distributions, it's equally easy to automate.	[reply] [d/l]