Support preserving folder structure (recursive)

[sindresorhus]

This would fix: #30, #10, #40, #60
(If you want to take on this issue, ensure you read those issue threads too, for context)

And see #32 for a previous attempt.

This tasks also includes adding support for it in https://github.com/sindresorhus/cpy-cli.

This tasks also requires you to write a lot of tests.

And some inspiration from other tools:

• https://github.com/shelljs/shelljs#cpoptions-source_array-dest
• https://github.com/apexearth/copy
• https://github.com/jprichardson/node-fs-extra/blob/master/docs/copy.md
• https://github.com/mysticatea/cpx
• More: https://npms.io/search?q=copy+files

Question: Should it be recursive by default? Why? Why not? Include reasoning.

---

Note: This is not an easy issue. It requires you to have good JavaScript and Node.js experience. I expect you to do a good job. Instead of asking to many questions, present solutions. The point of a issue bounty is to give me less work, not more. 🙌

---

IssueHunt Summary

idered has been rewarded.

Backers (Total: $120.00)

• issuehunt ($120.00)

Submitted pull Requests

• #77 Implement recursive and flat copy

---

Tips

• Checkout the Issuehunt explorer to discover more funded issues.
• Need some help from other developers? Add your repositories on IssueHunt to raise funds.

[IssueHuntBot]

@issuehunt has funded $120.00 to this issue.

---

• Submit pull request via IssueHunt to receive this reward.
• Want to contribute? Chip in to this issue via IssueHunt.
• Checkout the IssueHunt Issue Explorer to see more funded issues.
• Need help from developers? Add your repository on IssueHunt to raise funds.

[friendlyanon]

Hello, I'm interested in solving this issue for you, however I would like to inquire about some details to clear a few things up for me.
What would this recursive option do differently than the parent: true option? Omit the leading segments in the destination path? (Is that what #40 is about?)
As far as I can tell doing cpy("b", "a", { parents: true }) on b/c/d.js will result in a/b/c/d.js, since globby does a recursive listing already.
What is a clear example where cpy currently doesn't behave as expected and what would the expected outcome be?
Thank you for your time.

[sindresorhus]

The reason there's a fairly large bounty on this issue is that I don't have all the answers. It's up to the submitter to come up with a good solution. Many of the deficiencies of the current behavior is documented in the linked issues.

[chrispcode]

Just an opinion, I think what people are looking for is reproducing this behavior:

In this kind of API:

Or something similar...

[issuehunt-oss]

@sindresorhus has rewarded $108.00 to @idered. See it on IssueHunt

• 💰 Total deposit: $120.00
• 🎉 Repository reward(0%): $0.00
• 🔧 Service fee(10%): $12.00