package backup import ( "github.com/alcionai/clues" "github.com/spf13/cobra" "github.com/spf13/pflag" "github.com/alcionai/corso/src/cli/flags" . "github.com/alcionai/corso/src/cli/print" "github.com/alcionai/corso/src/cli/utils" "github.com/alcionai/corso/src/pkg/fault" "github.com/alcionai/corso/src/pkg/path" "github.com/alcionai/corso/src/pkg/selectors" ) // ------------------------------------------------------------------------------------------------ // setup and globals // ------------------------------------------------------------------------------------------------ const ( oneDriveServiceCommand = "onedrive" oneDriveServiceCommandCreateUseSuffix = "--user | '" + flags.Wildcard + "'" oneDriveServiceCommandDeleteUseSuffix = "--backups " oneDriveServiceCommandDetailsUseSuffix = "--backup " ) const ( oneDriveServiceCommandCreateExamples = `# Backup OneDrive data for Alice corso backup create onedrive --user alice@example.com # Backup OneDrive for Alice and Bob corso backup create onedrive --user alice@example.com,bob@example.com # Backup all OneDrive data for all M365 users corso backup create onedrive --user '*'` oneDriveServiceCommandDeleteExamples = `# Delete OneDrive backup with ID 1234abcd-12ab-cd34-56de-1234abcd \ and 1234abcd-12ab-cd34-56de-1234abce corso backup delete onedrive --backups 1234abcd-12ab-cd34-56de-1234abcd,1234abcd-12ab-cd34-56de-1234abce` oneDriveServiceCommandDetailsExamples = `# Explore items in Bob's latest backup (1234abcd...) corso backup details onedrive --backup 1234abcd-12ab-cd34-56de-1234abcd # Explore files in the folder "Reports" named "Fiscal 22" corso backup details onedrive --backup 1234abcd-12ab-cd34-56de-1234abcd \ --file-name "Fiscal 22" --folder "Reports" # Explore files created before the end of 2015 corso backup details onedrive --backup 1234abcd-12ab-cd34-56de-1234abcd \ --file-created-before 2015-01-01T00:00:00` ) // called by backup.go to map subcommands to provider-specific handling. func addOneDriveCommands(cmd *cobra.Command) *cobra.Command { var ( c *cobra.Command fs *pflag.FlagSet ) switch cmd.Use { case createCommand: c, fs = utils.AddCommand(cmd, oneDriveCreateCmd()) c.Use = c.Use + " " + oneDriveServiceCommandCreateUseSuffix c.Example = oneDriveServiceCommandCreateExamples flags.AddUserFlag(c) flags.AddGenericBackupFlags(c) fs.BoolVar( &flags.UseDeltaTreeFV, flags.UseDeltaTreeFN, false, "process backups using the delta tree instead of standard enumeration") cobra.CheckErr(fs.MarkHidden(flags.UseDeltaTreeFN)) case listCommand: c, _ = utils.AddCommand(cmd, oneDriveListCmd()) flags.AddBackupIDFlag(c, false) flags.AddAllBackupListFlags(c) case detailsCommand: c, _ = utils.AddCommand(cmd, oneDriveDetailsCmd()) c.Use = c.Use + " " + oneDriveServiceCommandDetailsUseSuffix c.Example = oneDriveServiceCommandDetailsExamples flags.AddSkipReduceFlag(c) flags.AddBackupIDFlag(c, true) flags.AddOneDriveDetailsAndRestoreFlags(c) case deleteCommand: c, _ = utils.AddCommand(cmd, oneDriveDeleteCmd()) c.Use = c.Use + " " + oneDriveServiceCommandDeleteUseSuffix c.Example = oneDriveServiceCommandDeleteExamples flags.AddMultipleBackupIDsFlag(c, false) flags.AddBackupIDFlag(c, false) } return c } // ------------------------------------------------------------------------------------------------ // backup create // ------------------------------------------------------------------------------------------------ // `corso backup create onedrive [...]` func oneDriveCreateCmd() *cobra.Command { return &cobra.Command{ Use: oneDriveServiceCommand, Short: "Backup M365 OneDrive service data", RunE: createOneDriveCmd, Args: cobra.NoArgs, Example: oneDriveServiceCommandCreateExamples, } } // processes an onedrive service backup. func createOneDriveCmd(cmd *cobra.Command, args []string) error { ctx := cmd.Context() if utils.HasNoFlagsAndShownHelp(cmd) { return nil } if flags.RunModeFV == flags.RunModeFlagTest { return nil } if err := validateOneDriveBackupCreateFlags(flags.UserFV); err != nil { return err } r, acct, err := utils.AccountConnectAndWriteRepoConfig( ctx, cmd, path.OneDriveService) if err != nil { return Only(ctx, err) } defer utils.CloseRepo(ctx, r) sel := oneDriveBackupCreateSelectors(flags.UserFV) ins, err := utils.UsersMap( ctx, *acct, utils.Control(), r.Counter(), fault.New(true)) if err != nil { return Only(ctx, clues.Wrap(err, "Failed to retrieve M365 users")) } selectorSet := []selectors.Selector{} for _, discSel := range sel.SplitByResourceOwner(ins.IDs()) { selectorSet = append(selectorSet, discSel.Selector) } return genericCreateCommand( ctx, r, "OneDrive", selectorSet, ins) } func validateOneDriveBackupCreateFlags(users []string) error { if len(users) == 0 { return clues.New("requires one or more --user ids or the wildcard --user *") } return nil } func oneDriveBackupCreateSelectors(users []string) *selectors.OneDriveBackup { sel := selectors.NewOneDriveBackup(users) sel.Include(sel.AllData()) return sel } // ------------------------------------------------------------------------------------------------ // backup list // ------------------------------------------------------------------------------------------------ // `corso backup list onedrive [...]` func oneDriveListCmd() *cobra.Command { return &cobra.Command{ Use: oneDriveServiceCommand, Short: "List the history of M365 OneDrive service backups", RunE: listOneDriveCmd, Args: cobra.NoArgs, } } // lists the history of backup operations func listOneDriveCmd(cmd *cobra.Command, args []string) error { return genericListCommand(cmd, flags.BackupIDFV, path.OneDriveService, args) } // ------------------------------------------------------------------------------------------------ // backup details // ------------------------------------------------------------------------------------------------ // `corso backup details onedrive [...]` func oneDriveDetailsCmd() *cobra.Command { return &cobra.Command{ Use: oneDriveServiceCommand, Short: "Shows the details of a M365 OneDrive service backup", RunE: detailsOneDriveCmd, Args: cobra.NoArgs, Example: oneDriveServiceCommandDetailsExamples, } } // prints the item details for a given backup func detailsOneDriveCmd(cmd *cobra.Command, args []string) error { if utils.HasNoFlagsAndShownHelp(cmd) { return nil } if flags.RunModeFV == flags.RunModeFlagTest { return nil } return runDetailsOneDriveCmd(cmd) } func runDetailsOneDriveCmd(cmd *cobra.Command) error { ctx := cmd.Context() opts := utils.MakeOneDriveOpts(cmd) sel := utils.IncludeOneDriveRestoreDataSelectors(opts) sel.Configure(selectors.Config{OnlyMatchItemNames: true}) utils.FilterOneDriveRestoreInfoSelectors(sel, opts) ds, err := genericDetailsCommand(cmd, flags.BackupIDFV, sel.Selector) if err != nil { return Only(ctx, err) } if len(ds.Entries) > 0 { ds.PrintEntries(ctx) } else { Info(ctx, selectors.ErrorNoMatchingItems) } return nil } // `corso backup delete onedrive [...]` func oneDriveDeleteCmd() *cobra.Command { return &cobra.Command{ Use: oneDriveServiceCommand, Short: "Delete backed-up M365 OneDrive service data", RunE: deleteOneDriveCmd, Args: cobra.NoArgs, Example: oneDriveServiceCommandDeleteExamples, } } // deletes a oneDrive service backup. func deleteOneDriveCmd(cmd *cobra.Command, args []string) error { backupIDValue := []string{} if len(flags.BackupIDsFV) > 0 { backupIDValue = flags.BackupIDsFV } else if len(flags.BackupIDFV) > 0 { backupIDValue = append(backupIDValue, flags.BackupIDFV) } else { return clues.New("either --backup or --backups flag is required") } return genericDeleteCommand(cmd, path.OneDriveService, "OneDrive", backupIDValue, args) }