package main import ( "bytes" "fmt" "io/ioutil" "os" "path/filepath" "github.com/docopt/docopt-go" "github.com/kovetskiy/lorg" "github.com/kovetskiy/mark/pkg/confluence" "github.com/kovetskiy/mark/pkg/mark" "github.com/kovetskiy/mark/pkg/mark/includes" "github.com/kovetskiy/mark/pkg/mark/macro" "github.com/kovetskiy/mark/pkg/mark/stdlib" "github.com/reconquest/karma-go" "github.com/reconquest/pkg/log" ) type markFlags struct { fileGlobPatten string compileOnly bool dryRun bool editLock bool dropH1 bool minorEdit bool color string } const ( usage = `mark - a tool for updating Atlassian Confluence pages from markdown. Docs: https://github.com/kovetskiy/mark Usage: mark [options] [-u ] [-p ] [-k] [-l ] -f mark [options] [-u ] [-p ] [-k] [-b ] -f mark -v | --version mark -h | --help Options: -u Use specified username for updating Confluence page. -p Use specified token for updating Confluence page. Specify - as password to read password from stdin. -l Edit specified Confluence page. If -l is not specified, file should contain metadata (see above). -b --base-url Base URL for Confluence. Alternative option for base_url config field. -f Use specified markdown file(s) for converting to html. Supports file globbing patterns (needs to be quoted). -k Lock page editing to current user only to prevent accidental manual edits over Confluence Web UI. --drop-h1 Don't include H1 headings in Confluence output. --dry-run Resolve page and ancestry, show resulting HTML and exit. --compile-only Show resulting HTML and don't update Confluence page content. --minor-edit Don't send notifications while updating Confluence page. --debug Enable debug logs. --trace Enable trace logs. --color Display logs in color. Possible values: auto, never. [default: auto] -h --help Show this screen and call 911. -v --version Show version. ` ) func main() { args, err := docopt.ParseArgs(usage, nil, "5.6") if err != nil { panic(err) } flags := &markFlags{ fileGlobPatten: args["-f"].(string), compileOnly: args["--compile-only"].(bool), dryRun: args["--dry-run"].(bool), editLock: args["-k"].(bool), dropH1: args["--drop-h1"].(bool), minorEdit: args["--minor-edit"].(bool), color: args["--color"].(string), } if args["--debug"].(bool) { log.SetLevel(lorg.LevelDebug) } if args["--trace"].(bool) { log.SetLevel(lorg.LevelTrace) } if flags.color == "never" { log.GetLogger().SetFormat( lorg.NewFormat( `${time:2006-01-02 15:04:05.000} ${level:%s:left:true} ${prefix}%s`, ), ) log.GetLogger().SetOutput(os.Stderr) } config, err := LoadConfig(filepath.Join(os.Getenv("HOME"), ".config/mark")) if err != nil { log.Fatal(err) } creds, err := GetCredentials(args, config) if err != nil { log.Fatal(err) } api := confluence.NewAPI(creds.BaseURL, creds.Username, creds.Password) files, err := filepath.Glob(flags.fileGlobPatten) if err != nil { log.Fatal(err) } if len(files) == 0 { log.Fatal("No files matched.") } // Loop through files matched by glob pattern for _, file := range files { log.Infof( nil, "Processing %s...", file, ) target := processFile(file, api, flags, creds.PageID, creds.Username) log.Infof( nil, "page successfully updated: %s", creds.BaseURL+target.Links.Full, ) fmt.Println( "Page available at:", creds.BaseURL+target.Links.Full, ) } } func processFile(file string, api *confluence.API, flags *markFlags, pageID string, username string) *confluence.PageInfo { markdown, err := ioutil.ReadFile(file) if err != nil { log.Fatal(err) } meta, markdown, err := mark.ExtractMeta(markdown) if err != nil { log.Fatal(err) } stdlib, err := stdlib.New(api) if err != nil { log.Fatal(err) } templates := stdlib.Templates var recurse bool for { templates, markdown, recurse, err = includes.ProcessIncludes( markdown, templates, ) if err != nil { log.Fatal(err) } if !recurse { break } } macros, markdown, err := macro.ExtractMacros(markdown, templates) if err != nil { log.Fatal(err) } macros = append(macros, stdlib.Macros...) for _, macro := range macros { markdown, err = macro.Apply(markdown) if err != nil { log.Fatal(err) } } links, err := mark.ResolveRelativeLinks(api, meta, markdown, ".") if err != nil { log.Fatalf(err, "unable to resolve relative links") } markdown = mark.SubstituteLinks(markdown, links) if flags.dryRun { flags.compileOnly = true _, _, err := mark.ResolvePage(flags.dryRun, api, meta) if err != nil { log.Fatalf(err, "unable to resolve page location") } } if flags.compileOnly { fmt.Println(mark.CompileMarkdown(markdown, stdlib)) os.Exit(0) } if pageID != "" && meta != nil { log.Warning( `specified file contains metadata, ` + `but it will be ignored due specified command line URL`, ) meta = nil } if pageID == "" && meta == nil { log.Fatal( `specified file doesn't contain metadata ` + `and URL is not specified via command line ` + `or doesn't contain pageId GET-parameter`, ) } var target *confluence.PageInfo if meta != nil { parent, page, err := mark.ResolvePage(flags.dryRun, api, meta) if err != nil { log.Fatalf( karma.Describe("title", meta.Title).Reason(err), "unable to resolve %s", meta.Type, ) } if page == nil { page, err = api.CreatePage(meta.Space, meta.Type, parent, meta.Title, ``) if err != nil { log.Fatalf( err, "can't create %s %q", meta.Type, meta.Title, ) } } target = page } else { if pageID == "" { log.Fatalf(nil, "URL should provide 'pageId' GET-parameter") } page, err := api.GetPageByID(pageID) if err != nil { log.Fatalf(err, "unable to retrieve page by id") } target = page } attaches, err := mark.ResolveAttachments(api, target, ".", meta.Attachments) if err != nil { log.Fatalf(err, "unable to create/update attachments") } markdown = mark.CompileAttachmentLinks(markdown, attaches) if flags.dropH1 { log.Info( "Leading H1 heading will be excluded from the Confluence output", ) markdown = mark.DropDocumentLeadingH1(markdown) } html := mark.CompileMarkdown(markdown, stdlib) { var buffer bytes.Buffer err := stdlib.Templates.ExecuteTemplate( &buffer, "ac:layout", struct { Layout string Body string }{ Layout: meta.Layout, Body: html, }, ) if err != nil { log.Fatal(err) } html = buffer.String() } err = api.UpdatePage(target, html, flags.minorEdit, meta.Labels) if err != nil { log.Fatal(err) } if flags.editLock { log.Infof( nil, `edit locked on page %q by user %q to prevent manual edits`, target.Title, username, ) err := api.RestrictPageUpdates( target, username, ) if err != nil { log.Fatal(err) } } return target }