fd9c431bea
<!-- PR description--> --- #### Does this PR need a docs update or release note? - [ ] ✅ Yes, it's included - [x] 🕐 Yes, but in a later PR - [ ] ⛔ No #### Type of change <!--- Please check the type of change your PR introduces: ---> - [x] 🌻 Feature - [ ] 🐛 Bugfix - [ ] 🗺️ Documentation - [ ] 🤖 Supportability/Tests - [ ] 💻 CI/Deployment - [ ] 🧹 Tech Debt/Cleanup #### Issue(s) <!-- Can reference multiple issues. Use one of the following "magic words" - "closes, fixes" to auto-close the Github issue. --> * https://github.com/alcionai/corso/issues/3893 #### Test Plan <!-- How will this be tested prior to merging.--> - [ ] 💪 Manual - [x] ⚡ Unit test - [ ] 💚 E2E
110 lines
3.0 KiB
Go
110 lines
3.0 KiB
Go
package export
|
|
|
|
import (
|
|
"github.com/pkg/errors"
|
|
"github.com/spf13/cobra"
|
|
"github.com/spf13/pflag"
|
|
|
|
"github.com/alcionai/corso/src/cli/flags"
|
|
"github.com/alcionai/corso/src/cli/utils"
|
|
)
|
|
|
|
// called by export.go to map subcommands to provider-specific handling.
|
|
func addExchangeCommands(cmd *cobra.Command) *cobra.Command {
|
|
var (
|
|
c *cobra.Command
|
|
fs *pflag.FlagSet
|
|
)
|
|
|
|
switch cmd.Use {
|
|
case exportCommand:
|
|
c, fs = utils.AddCommand(cmd, exchangeExportCmd())
|
|
|
|
c.Use = c.Use + " " + exchangeServiceCommandUseSuffix
|
|
|
|
// Flags addition ordering should follow the order we want them to appear in help and docs:
|
|
// More generic (ex: --user) and more frequently used flags take precedence.
|
|
fs.SortFlags = false
|
|
|
|
flags.AddBackupIDFlag(c, true)
|
|
flags.AddExchangeDetailsAndRestoreFlags(c, true)
|
|
flags.AddExportConfigFlags(c)
|
|
flags.AddFailFastFlag(c)
|
|
}
|
|
|
|
return c
|
|
}
|
|
|
|
const (
|
|
exchangeServiceCommand = "exchange"
|
|
exchangeServiceCommandUseSuffix = "<destination> --backup <backupId>"
|
|
|
|
// TODO(meain): remove message about only supporting email exports once others are added
|
|
//nolint:lll
|
|
exchangeServiceCommandExportExamples = `> Only email exports are supported as of now.
|
|
|
|
# Export emails with ID 98765abcdef and 12345abcdef from Alice's last backup (1234abcd...) to my-folder
|
|
corso export exchange my-folder --backup 1234abcd-12ab-cd34-56de-1234abcd --email 98765abcdef,12345abcdef
|
|
|
|
# Export emails with subject containing "Hello world" in the "Inbox" to my-folder
|
|
corso export exchange --backup 1234abcd-12ab-cd34-56de-1234abcd \
|
|
--email-subject "Hello world" --email-folder Inbox my-folder`
|
|
|
|
// TODO(meain): Uncomment once support for these are added
|
|
// `# Export an entire calendar to my-folder
|
|
// corso export exchange --backup 1234abcd-12ab-cd34-56de-1234abcd \
|
|
// --event-calendar Calendar my-folder
|
|
|
|
// # Export the contact with ID abdef0101 to my-folder
|
|
// corso export exchange --backup 1234abcd-12ab-cd34-56de-1234abcd --contact abdef0101 my-folder`
|
|
)
|
|
|
|
// `corso export exchange [<flag>...] <destination>`
|
|
func exchangeExportCmd() *cobra.Command {
|
|
return &cobra.Command{
|
|
Use: exchangeServiceCommand,
|
|
Short: "Export M365 Exchange service data",
|
|
RunE: exportExchangeCmd,
|
|
Args: func(cmd *cobra.Command, args []string) error {
|
|
if len(args) != 1 {
|
|
return errors.New("missing export destination")
|
|
}
|
|
|
|
return nil
|
|
},
|
|
Example: exchangeServiceCommandExportExamples,
|
|
}
|
|
}
|
|
|
|
// processes an exchange service export.
|
|
func exportExchangeCmd(cmd *cobra.Command, args []string) error {
|
|
ctx := cmd.Context()
|
|
|
|
if utils.HasNoFlagsAndShownHelp(cmd) {
|
|
return nil
|
|
}
|
|
|
|
opts := utils.MakeExchangeOpts(cmd)
|
|
|
|
if flags.RunModeFV == flags.RunModeFlagTest {
|
|
return nil
|
|
}
|
|
|
|
if err := utils.ValidateExchangeRestoreFlags(flags.BackupIDFV, opts); err != nil {
|
|
return err
|
|
}
|
|
|
|
sel := utils.IncludeExchangeRestoreDataSelectors(opts)
|
|
utils.FilterExchangeRestoreInfoSelectors(sel, opts)
|
|
|
|
return runExport(
|
|
ctx,
|
|
cmd,
|
|
args,
|
|
opts.ExportCfg,
|
|
sel.Selector,
|
|
flags.BackupIDFV,
|
|
"Exchange",
|
|
defaultAcceptedFormatTypes)
|
|
}
|