Add trashbin:restore occ command

[cahogan]

Adds feature requested in #18921 and #20781 to allow trashed file restoration with occ.

Close #18921
Close #20781

[szaimen]

Hey, thank you very much for creating this PR and sry for the late answer!

[icewind1991]

rebased, fixed code style issues and changed output to be a bit more concise

[PVince81]

👍

[cahogan]

I think this will also potentially:
Close #30074

[szaimen]

Looks like this is ready to go?

[Grunthos]

Looking forward to this going live, but would be nice if it had the option if restoring a specific file based on path or id.

[cahogan]

@Grunthos I think it would be fairly easy to add that in an inelegant way -- restoreDeletedFiles already handles the individual files it restores by $filename, so you could accept an optional input list of filenames to restore, then check for membership. I am sure there is a faster and better way to accomplish this, though.

@szaimen as far as I am concerned yes :)

[Grunthos]

@cahogan I was just thinking of something based on internal object IDs from the database; in many cases where accidental deletions have occurred they are pretty easy to find. If a path was specifiable, then a wildcard recursive path would be nice ;-).

[PVince81]

/rebase

[PVince81]

seems our bot likely cannot rebase on forks

I've retriggered CI to get an up to date result

[szaimen]

I rebased manually. Lets see what CI says

[szaimen]

I think the failures are unrelated.
cc @PVince81 if we can merge this

[welcome]

Thanks for your first pull request and welcome to the community! Feel free to keep them coming! If you are looking for issues to tackle then have a look at this selection: https://github.com/nextcloud/server/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22

[PVince81]

@cahogan can you update the documentation as well ? https://docs.nextcloud.com/server/stable/admin_manual/configuration_server/occ_command.html?highlight=occ#trashbin-label

the repo is here: https://github.com/nextcloud/documentation/tree/master/admin_manual/configuration_server

[PVince81]

@cahogan ping, can you add the docs as per my previous comment ?
let me know if you can't so someone else can take care.
thanks!

[allinappliadmin]

seems the documentation is not yet updated: https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html#trashbin

[PVince81]

nextcloud/documentation#9521

[cahogan]

Hi all, my apologies -- I didn't receive notifications from this thread. Thank you very much for adding documentation -- is there any additional info that I could help with at this point, or is the PR complete?

[PVince81]

@cahogan it is complete now. thanks!