~bigbes/confluence-md-utilities

ref: e0e81bc69b5622c2bd20261155fc36519a7621d8 confluence-md-utilities/cmd/mdcx/pull.go -rw-r--r-- 1.9 KiB
e0e81bc6 — Eugene Blikh chore: rename module to go.bigb.es/confluence-md-utilities a month ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
package main

import (
	"fmt"
	"os"

	"github.com/spf13/cobra"

	"go.bigb.es/confluence-md-utilities/api"
	"go.bigb.es/confluence-md-utilities/converter"
)

var (
	pullOutput string
	pullRaw    bool
)

var pullCmd = &cobra.Command{
	Use:   "pull <confluence-url>",
	Short: "Pull a page from Confluence and convert to Markdown",
	Long: `Fetch a Confluence page by URL, extract its storage format body,
and convert it to Markdown.

Supported URL formats:
  https://confluence.example.com/pages/viewpage.action?pageId=12345
  https://confluence.example.com/display/SPACE/Page+Title

Use --raw to get the Confluence storage XML without converting to Markdown.

Authentication via --token flag or CONFLUENCE_TOKEN environment variable.`,
	Args: cobra.ExactArgs(1),
	RunE: func(cmd *cobra.Command, args []string) error {
		token := resolveToken()
		if token == "" {
			return fmt.Errorf("Confluence token required: use --token flag or set CONFLUENCE_TOKEN env var")
		}

		ref, err := api.ParsePageURL(args[0])
		if err != nil {
			return err
		}

		client := api.NewClient(ref.BaseURL, token)
		page, err := client.GetPage(ref)
		if err != nil {
			return err
		}

		xmlBody := page.Body.Storage.Value
		fmt.Fprintf(os.Stderr, "Pulled page: %s (id=%s, version=%d)\n", page.Title, page.ID, page.Version.Number)

		var result string
		if pullRaw {
			result = xmlBody
		} else {
			result, err = converter.ConfluenceToMarkdown(xmlBody)
			if err != nil {
				return fmt.Errorf("converting to markdown: %w", err)
			}
		}

		if pullOutput != "" {
			if err := os.WriteFile(pullOutput, []byte(result), 0644); err != nil {
				return err
			}
			fmt.Fprintf(os.Stderr, "Written to %s\n", pullOutput)
			return nil
		}
		fmt.Print(result)
		return nil
	},
}

func init() {
	pullCmd.Flags().StringVarP(&pullOutput, "output", "o", "", "Output file (default: stdout)")
	pullCmd.Flags().BoolVar(&pullRaw, "raw", false, "Output raw Confluence storage XML instead of Markdown")
	rootCmd.AddCommand(pullCmd)
}