mirror of
				https://github.com/go-gitea/gitea
				synced 2025-10-31 11:28:24 +00:00 
			
		
		
		
	* Fix #33972 * Use consistent path resolving for links and medias. * No need to make the markup renders to resolve the paths, instead, the paths are all correctly resolved in the "post process" step. * Fix #33274 * Since 1.23, all paths starting with "/" are relative to current render context (for example: the current repo branch) * Introduce `/:root/path-relative-to-root`, then the path will be rendered as relative to "ROOT_URL"
		
			
				
	
	
		
			226 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
			
		
		
	
	
			226 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			Go
		
	
	
	
	
	
| // Copyright 2020 The Gitea Authors. All rights reserved.
 | |
| // SPDX-License-Identifier: MIT
 | |
| 
 | |
| package misc
 | |
| 
 | |
| import (
 | |
| 	go_context "context"
 | |
| 	"io"
 | |
| 	"net/http"
 | |
| 	"os"
 | |
| 	"path"
 | |
| 	"strings"
 | |
| 	"testing"
 | |
| 
 | |
| 	repo_model "code.gitea.io/gitea/models/repo"
 | |
| 	"code.gitea.io/gitea/models/unittest"
 | |
| 	"code.gitea.io/gitea/modules/markup"
 | |
| 	"code.gitea.io/gitea/modules/setting"
 | |
| 	api "code.gitea.io/gitea/modules/structs"
 | |
| 	"code.gitea.io/gitea/modules/test"
 | |
| 	"code.gitea.io/gitea/modules/web"
 | |
| 	context_service "code.gitea.io/gitea/services/context"
 | |
| 	"code.gitea.io/gitea/services/contexttest"
 | |
| 
 | |
| 	"github.com/stretchr/testify/assert"
 | |
| )
 | |
| 
 | |
| const AppURL = "http://localhost:3000/"
 | |
| 
 | |
| func TestMain(m *testing.M) {
 | |
| 	unittest.MainTest(m, &unittest.TestOptions{
 | |
| 		FixtureFiles: []string{"repository.yml", "user.yml"},
 | |
| 	})
 | |
| 	os.Exit(m.Run())
 | |
| }
 | |
| 
 | |
| func testRenderMarkup(t *testing.T, mode string, wiki bool, filePath, text, expectedBody string, expectedCode int) {
 | |
| 	setting.AppURL = AppURL
 | |
| 	defer test.MockVariableValue(&markup.RenderBehaviorForTesting.DisableAdditionalAttributes, true)()
 | |
| 	context := "/user2/repo1"
 | |
| 	if !wiki {
 | |
| 		context += path.Join("/src/branch/main", path.Dir(filePath))
 | |
| 	}
 | |
| 	options := api.MarkupOption{
 | |
| 		Mode:     mode,
 | |
| 		Text:     text,
 | |
| 		Context:  context,
 | |
| 		Wiki:     wiki,
 | |
| 		FilePath: filePath,
 | |
| 	}
 | |
| 	ctx, resp := contexttest.MockAPIContext(t, "POST /api/v1/markup")
 | |
| 	ctx.Repo = &context_service.Repository{}
 | |
| 	ctx.Repo.Repository = unittest.AssertExistsAndLoadBean(t, &repo_model.Repository{ID: 1})
 | |
| 	web.SetForm(ctx, &options)
 | |
| 	Markup(ctx)
 | |
| 	assert.Equal(t, expectedBody, resp.Body.String())
 | |
| 	assert.Equal(t, expectedCode, resp.Code)
 | |
| 	resp.Body.Reset()
 | |
| }
 | |
| 
 | |
| func testRenderMarkdown(t *testing.T, mode string, wiki bool, text, responseBody string, responseCode int) {
 | |
| 	defer test.MockVariableValue(&markup.RenderBehaviorForTesting.DisableAdditionalAttributes, true)()
 | |
| 	setting.AppURL = AppURL
 | |
| 	context := "/user2/repo1"
 | |
| 	if !wiki {
 | |
| 		context += "/src/branch/main"
 | |
| 	}
 | |
| 	options := api.MarkdownOption{
 | |
| 		Mode:    mode,
 | |
| 		Text:    text,
 | |
| 		Context: context,
 | |
| 		Wiki:    wiki,
 | |
| 	}
 | |
| 	ctx, resp := contexttest.MockAPIContext(t, "POST /api/v1/markdown")
 | |
| 	web.SetForm(ctx, &options)
 | |
| 	Markdown(ctx)
 | |
| 	assert.Equal(t, responseBody, resp.Body.String())
 | |
| 	assert.Equal(t, responseCode, resp.Code)
 | |
| 	resp.Body.Reset()
 | |
| }
 | |
| 
 | |
| func TestAPI_RenderGFM(t *testing.T) {
 | |
| 	unittest.PrepareTestEnv(t)
 | |
| 	markup.Init(&markup.RenderHelperFuncs{
 | |
| 		IsUsernameMentionable: func(ctx go_context.Context, username string) bool {
 | |
| 			return username == "r-lyeh"
 | |
| 		},
 | |
| 	})
 | |
| 
 | |
| 	testCasesWiki := []string{
 | |
| 		// dear imgui wiki markdown extract: special wiki syntax
 | |
| 		`Wiki! Enjoy :)
 | |
| - [[Links, Language bindings, Engine bindings|Links]]
 | |
| - [[Tips]]
 | |
| - Bezier widget (by @r-lyeh) https://github.com/ocornut/imgui/issues/786`,
 | |
| 		// rendered
 | |
| 		`<p>Wiki! Enjoy :)</p>
 | |
| <ul>
 | |
| <li><a href="http://localhost:3000/user2/repo1/wiki/Links" rel="nofollow">Links, Language bindings, Engine bindings</a></li>
 | |
| <li><a href="http://localhost:3000/user2/repo1/wiki/Tips" rel="nofollow">Tips</a></li>
 | |
| <li>Bezier widget (by <a href="http://localhost:3000/r-lyeh" rel="nofollow">@r-lyeh</a>) <a href="https://github.com/ocornut/imgui/issues/786" rel="nofollow">https://github.com/ocornut/imgui/issues/786</a></li>
 | |
| </ul>
 | |
| `,
 | |
| 		// Guard wiki sidebar: special syntax
 | |
| 		`[[Guardfile-DSL / Configuring-Guard|Guardfile-DSL---Configuring-Guard]]`,
 | |
| 		// rendered
 | |
| 		`<p><a href="http://localhost:3000/user2/repo1/wiki/Guardfile-DSL---Configuring-Guard" rel="nofollow">Guardfile-DSL / Configuring-Guard</a></p>
 | |
| `,
 | |
| 		// special syntax
 | |
| 		`[[Name|Link]]`,
 | |
| 		// rendered
 | |
| 		`<p><a href="http://localhost:3000/user2/repo1/wiki/Link" rel="nofollow">Name</a></p>
 | |
| `,
 | |
| 		// empty
 | |
| 		``,
 | |
| 		// rendered
 | |
| 		``,
 | |
| 	}
 | |
| 
 | |
| 	testCasesWikiDocument := []string{
 | |
| 		// wine-staging wiki home extract: special wiki syntax, images
 | |
| 		`## What is Wine Staging?
 | |
| **Wine Staging** on website [wine-staging.com](http://wine-staging.com).
 | |
| 
 | |
| ## Quick Links
 | |
| Here are some links to the most important topics. You can find the full list of pages at the sidebar.
 | |
| 
 | |
| [[Configuration]]
 | |
| [[images/icon-bug.png]]
 | |
| `,
 | |
| 		// rendered
 | |
| 		`<h2 id="user-content-what-is-wine-staging">What is Wine Staging?</h2>
 | |
| <p><strong>Wine Staging</strong> on website <a href="http://wine-staging.com" rel="nofollow">wine-staging.com</a>.</p>
 | |
| <h2 id="user-content-quick-links">Quick Links</h2>
 | |
| <p>Here are some links to the most important topics. You can find the full list of pages at the sidebar.</p>
 | |
| <p><a href="http://localhost:3000/user2/repo1/wiki/Configuration" rel="nofollow">Configuration</a>
 | |
| <a href="http://localhost:3000/user2/repo1/wiki/images/icon-bug.png" rel="nofollow"><img src="http://localhost:3000/user2/repo1/wiki/raw/images/icon-bug.png" title="icon-bug.png" alt="images/icon-bug.png"/></a></p>
 | |
| `,
 | |
| 	}
 | |
| 
 | |
| 	for i := 0; i < len(testCasesWiki); i += 2 {
 | |
| 		text := testCasesWiki[i]
 | |
| 		response := testCasesWiki[i+1]
 | |
| 		testRenderMarkdown(t, "gfm", true, text, response, http.StatusOK)
 | |
| 		testRenderMarkup(t, "gfm", true, "", text, response, http.StatusOK)
 | |
| 		testRenderMarkdown(t, "comment", true, text, response, http.StatusOK)
 | |
| 		testRenderMarkup(t, "comment", true, "", text, response, http.StatusOK)
 | |
| 		testRenderMarkup(t, "file", true, "path/test.md", text, response, http.StatusOK)
 | |
| 	}
 | |
| 
 | |
| 	for i := 0; i < len(testCasesWikiDocument); i += 2 {
 | |
| 		text := testCasesWikiDocument[i]
 | |
| 		response := testCasesWikiDocument[i+1]
 | |
| 		testRenderMarkdown(t, "gfm", true, text, response, http.StatusOK)
 | |
| 		testRenderMarkup(t, "gfm", true, "", text, response, http.StatusOK)
 | |
| 		testRenderMarkup(t, "file", true, "path/test.md", text, response, http.StatusOK)
 | |
| 	}
 | |
| 
 | |
| 	input := "[Link](test.md)\n"
 | |
| 	testRenderMarkdown(t, "gfm", false, input, `<p><a href="http://localhost:3000/user2/repo1/src/branch/main/test.md" rel="nofollow">Link</a>
 | |
| <a href="http://localhost:3000/user2/repo1/src/branch/main/image.png" target="_blank" rel="nofollow noopener"><img src="http://localhost:3000/user2/repo1/media/branch/main/image.png" alt="Image"/></a></p>
 | |
| `, http.StatusOK)
 | |
| 
 | |
| 	testRenderMarkdown(t, "gfm", false, input, `<p><a href="http://localhost:3000/user2/repo1/src/branch/main/test.md" rel="nofollow">Link</a>
 | |
| <a href="http://localhost:3000/user2/repo1/src/branch/main/image.png" target="_blank" rel="nofollow noopener"><img src="http://localhost:3000/user2/repo1/media/branch/main/image.png" alt="Image"/></a></p>
 | |
| `, http.StatusOK)
 | |
| 
 | |
| 	testRenderMarkup(t, "gfm", false, "", input, `<p><a href="http://localhost:3000/user2/repo1/src/branch/main/test.md" rel="nofollow">Link</a>
 | |
| <a href="http://localhost:3000/user2/repo1/src/branch/main/image.png" target="_blank" rel="nofollow noopener"><img src="http://localhost:3000/user2/repo1/media/branch/main/image.png" alt="Image"/></a></p>
 | |
| `, http.StatusOK)
 | |
| 
 | |
| 	testRenderMarkup(t, "file", false, "path/new-file.md", input, `<p><a href="http://localhost:3000/user2/repo1/src/branch/main/path/test.md" rel="nofollow">Link</a>
 | |
| <a href="http://localhost:3000/user2/repo1/src/branch/main/path/image.png" target="_blank" rel="nofollow noopener"><img src="http://localhost:3000/user2/repo1/media/branch/main/path/image.png" alt="Image"/></a></p>
 | |
| `, http.StatusOK)
 | |
| 
 | |
| 	testRenderMarkup(t, "file", false, "path/test.unknown", "## Test", "unsupported file to render: \"path/test.unknown\"\n", http.StatusUnprocessableEntity)
 | |
| 	testRenderMarkup(t, "unknown", false, "", "## Test", "Unknown mode: unknown\n", http.StatusUnprocessableEntity)
 | |
| }
 | |
| 
 | |
| var simpleCases = []string{
 | |
| 	// Guard wiki sidebar: special syntax
 | |
| 	`[[Guardfile-DSL / Configuring-Guard|Guardfile-DSL---Configuring-Guard]]`,
 | |
| 	// rendered
 | |
| 	`<p>[[Guardfile-DSL / Configuring-Guard|Guardfile-DSL---Configuring-Guard]]</p>
 | |
| `,
 | |
| 	// special syntax
 | |
| 	`[[Name|Link]]`,
 | |
| 	// rendered
 | |
| 	`<p>[[Name|Link]]</p>
 | |
| `,
 | |
| 	// empty
 | |
| 	``,
 | |
| 	// rendered
 | |
| 	``,
 | |
| }
 | |
| 
 | |
| func TestAPI_RenderSimple(t *testing.T) {
 | |
| 	setting.AppURL = AppURL
 | |
| 	markup.RenderBehaviorForTesting.DisableAdditionalAttributes = true
 | |
| 	options := api.MarkdownOption{
 | |
| 		Mode:    "markdown",
 | |
| 		Text:    "",
 | |
| 		Context: "/user2/repo1",
 | |
| 	}
 | |
| 	ctx, resp := contexttest.MockAPIContext(t, "POST /api/v1/markdown")
 | |
| 	for i := 0; i < len(simpleCases); i += 2 {
 | |
| 		options.Text = simpleCases[i]
 | |
| 		web.SetForm(ctx, &options)
 | |
| 		Markdown(ctx)
 | |
| 		assert.Equal(t, simpleCases[i+1], resp.Body.String())
 | |
| 		resp.Body.Reset()
 | |
| 	}
 | |
| }
 | |
| 
 | |
| func TestAPI_RenderRaw(t *testing.T) {
 | |
| 	setting.AppURL = AppURL
 | |
| 	markup.RenderBehaviorForTesting.DisableAdditionalAttributes = true
 | |
| 	ctx, resp := contexttest.MockAPIContext(t, "POST /api/v1/markdown")
 | |
| 	for i := 0; i < len(simpleCases); i += 2 {
 | |
| 		ctx.Req.Body = io.NopCloser(strings.NewReader(simpleCases[i]))
 | |
| 		MarkdownRaw(ctx)
 | |
| 		assert.Equal(t, simpleCases[i+1], resp.Body.String())
 | |
| 		resp.Body.Reset()
 | |
| 	}
 | |
| }
 |