Add module.replacements

Fixes #7904
Fixes #7908
This commit is contained in:
Bjørn Erik Pedersen 2020-10-29 17:14:04 +01:00
parent 8a1c637c44
commit 173187e263
No known key found for this signature in database
GPG key ID: 330E6E2BD4859D8F
5 changed files with 146 additions and 25 deletions

View file

@ -613,6 +613,15 @@ func (c *Client) shouldVendor(path string) bool {
return c.noVendor == nil || !c.noVendor.Match(path) return c.noVendor == nil || !c.noVendor.Match(path)
} }
func (c *Client) createThemeDirname(modulePath string, isProjectMod bool) (string, error) {
modulePath = filepath.Clean(modulePath)
moduleDir := filepath.Join(c.ccfg.ThemesDir, modulePath)
if !isProjectMod && !strings.HasPrefix(moduleDir, c.ccfg.ThemesDir) {
return "", errors.Errorf("invalid module path %q; must be relative to themesDir when defined outside of the project", modulePath)
}
return moduleDir, nil
}
// ClientConfig configures the module Client. // ClientConfig configures the module Client.
type ClientConfig struct { type ClientConfig struct {
Fs afero.Fs Fs afero.Fs

View file

@ -15,6 +15,8 @@ package modules
import ( import (
"bytes" "bytes"
"os"
"path/filepath"
"testing" "testing"
"github.com/gohugoio/hugo/hugofs/glob" "github.com/gohugoio/hugo/hugofs/glob"
@ -41,10 +43,14 @@ github.com/gohugoio/hugoTestModules1_darwin/modh2_2@v1.4.0 github.com/gohugoio/h
workingDir, clean, err := htesting.CreateTempDir(hugofs.Os, modName) workingDir, clean, err := htesting.CreateTempDir(hugofs.Os, modName)
c.Assert(err, qt.IsNil) c.Assert(err, qt.IsNil)
themesDir := filepath.Join(workingDir, "themes")
err = os.Mkdir(themesDir, 0777)
c.Assert(err, qt.IsNil)
ccfg := ClientConfig{ ccfg := ClientConfig{
Fs: hugofs.Os, Fs: hugofs.Os,
WorkingDir: workingDir, WorkingDir: workingDir,
ThemesDir: themesDir,
} }
withConfig(&ccfg) withConfig(&ccfg)
@ -131,6 +137,28 @@ project github.com/gohugoio/hugoTestModules1_darwin/modh2_2_2@v1.3.0+vendor
c.Assert(graphb.String(), qt.Equals, expect) c.Assert(graphb.String(), qt.Equals, expect)
}) })
// https://github.com/gohugoio/hugo/issues/7908
c.Run("createThemeDirname", func(c *qt.C) {
mcfg := DefaultModuleConfig
client, clean := newClient(
c, func(cfg *ClientConfig) {
cfg.ModuleConfig = mcfg
})
defer clean()
dirname, err := client.createThemeDirname("foo", false)
c.Assert(err, qt.IsNil)
c.Assert(dirname, qt.Equals, filepath.Join(client.ccfg.ThemesDir, "foo"))
dirname, err = client.createThemeDirname("../../foo", true)
c.Assert(err, qt.IsNil)
c.Assert(dirname, qt.Equals, filepath.Join(client.ccfg.ThemesDir, "../../foo"))
dirname, err = client.createThemeDirname("../../foo", false)
c.Assert(err, qt.Not(qt.IsNil))
})
} }
var globAll, _ = glob.GetGlob("**") var globAll, _ = glob.GetGlob("**")

View file

@ -274,10 +274,14 @@ func (c *collector) add(owner *moduleAdapter, moduleImport Import, disabled bool
} }
} }
// Fall back to /themes/<mymodule> // Fall back to project/themes/<mymodule>
if moduleDir == "" { if moduleDir == "" {
moduleDir = filepath.Join(c.ccfg.ThemesDir, modulePath) var err error
moduleDir, err = c.createThemeDirname(modulePath, owner.projectMod)
if err != nil {
c.err = err
return nil, nil
}
if found, _ := afero.Exists(c.fs, moduleDir); !found { if found, _ := afero.Exists(c.fs, moduleDir); !found {
c.err = c.wrapModuleNotFound(errors.Errorf(`module %q not found; either add it as a Hugo Module or store it in %q.`, modulePath, c.ccfg.ThemesDir)) c.err = c.wrapModuleNotFound(errors.Errorf(`module %q not found; either add it as a Hugo Module or store it in %q.`, modulePath, c.ccfg.ThemesDir))
return nil, nil return nil, nil
@ -441,7 +445,7 @@ func (c *collector) applyThemeConfig(tc *moduleAdapter) error {
tc.cfg = cfg tc.cfg = cfg
} }
config, err := DecodeConfig(cfg) config, err := decodeConfig(cfg, c.moduleConfig.replacementsMap)
if err != nil { if err != nil {
return err return err
} }
@ -605,7 +609,6 @@ func (c *collector) normalizeMounts(owner *moduleAdapter, mounts []Mount) ([]Mou
mnt.Source = filepath.Clean(mnt.Source) mnt.Source = filepath.Clean(mnt.Source)
mnt.Target = filepath.Clean(mnt.Target) mnt.Target = filepath.Clean(mnt.Target)
var sourceDir string var sourceDir string
if owner.projectMod && filepath.IsAbs(mnt.Source) { if owner.projectMod && filepath.IsAbs(mnt.Source) {

View file

@ -18,6 +18,8 @@ import (
"path/filepath" "path/filepath"
"strings" "strings"
"github.com/pkg/errors"
"github.com/gohugoio/hugo/common/hugo" "github.com/gohugoio/hugo/common/hugo"
"github.com/gohugoio/hugo/config" "github.com/gohugoio/hugo/config"
@ -40,6 +42,14 @@ var DefaultModuleConfig = Config{
// Comma separated glob list matching paths that should be // Comma separated glob list matching paths that should be
// treated as private. // treated as private.
Private: "*.*", Private: "*.*",
// A list of replacement directives mapping a module path to a directory
// or a theme component in the themes folder.
// Note that this will turn the component into a traditional theme component
// that does not partake in vendoring etc.
// The syntax is the similar to the replacement directives used in go.mod, e.g:
// github.com/mod1 -> ../mod1,github.com/mod2 -> ../mod2
Replacements: nil,
} }
// ApplyProjectConfigDefaults applies default/missing module configuration for // ApplyProjectConfigDefaults applies default/missing module configuration for
@ -182,7 +192,12 @@ func ApplyProjectConfigDefaults(cfg config.Provider, mod Module) error {
// DecodeConfig creates a modules Config from a given Hugo configuration. // DecodeConfig creates a modules Config from a given Hugo configuration.
func DecodeConfig(cfg config.Provider) (Config, error) { func DecodeConfig(cfg config.Provider) (Config, error) {
return decodeConfig(cfg, nil)
}
func decodeConfig(cfg config.Provider, pathReplacements map[string]string) (Config, error) {
c := DefaultModuleConfig c := DefaultModuleConfig
c.replacementsMap = pathReplacements
if cfg == nil { if cfg == nil {
return c, nil return c, nil
@ -197,6 +212,37 @@ func DecodeConfig(cfg config.Provider) (Config, error) {
return c, err return c, err
} }
if c.replacementsMap == nil {
if len(c.Replacements) == 1 {
c.Replacements = strings.Split(c.Replacements[0], ",")
}
for i, repl := range c.Replacements {
c.Replacements[i] = strings.TrimSpace(repl)
}
c.replacementsMap = make(map[string]string)
for _, repl := range c.Replacements {
parts := strings.Split(repl, "->")
if len(parts) != 2 {
return c, errors.Errorf(`invalid module.replacements: %q; configure replacement pairs on the form "oldpath->newpath" `, repl)
}
c.replacementsMap[strings.TrimSpace(parts[0])] = strings.TrimSpace(parts[1])
}
}
if c.replacementsMap != nil && c.Imports != nil {
for i, imp := range c.Imports {
if newImp, found := c.replacementsMap[imp.Path]; found {
imp.Path = newImp
c.Imports[i] = imp
}
}
}
for i, mnt := range c.Mounts { for i, mnt := range c.Mounts {
mnt.Source = filepath.Clean(mnt.Source) mnt.Source = filepath.Clean(mnt.Source)
mnt.Target = filepath.Clean(mnt.Target) mnt.Target = filepath.Clean(mnt.Target)
@ -233,6 +279,9 @@ type Config struct {
// "github.com/**". // "github.com/**".
NoVendor string NoVendor string
Replacements []string
replacementsMap map[string]string
// Configures GOPROXY. // Configures GOPROXY.
Proxy string Proxy string
// Configures GONOPROXY. // Configures GONOPROXY.

View file

@ -41,6 +41,8 @@ func TestConfigHugoVersionIsValid(t *testing.T) {
func TestDecodeConfig(t *testing.T) { func TestDecodeConfig(t *testing.T) {
c := qt.New(t) c := qt.New(t)
c.Run("Basic", func(c *qt.C) {
tomlConfig := ` tomlConfig := `
[module] [module]
@ -88,6 +90,36 @@ lang="en"
c.Assert(imp.Mounts[1].Source, qt.Equals, "src/markdown/blog") c.Assert(imp.Mounts[1].Source, qt.Equals, "src/markdown/blog")
c.Assert(imp.Mounts[1].Target, qt.Equals, "content/blog") c.Assert(imp.Mounts[1].Target, qt.Equals, "content/blog")
c.Assert(imp.Mounts[1].Lang, qt.Equals, "en") c.Assert(imp.Mounts[1].Lang, qt.Equals, "en")
})
c.Run("Replacements", func(c *qt.C) {
for _, tomlConfig := range []string{`
[module]
replacements="a->b,github.com/bep/mycomponent->c"
[[module.imports]]
path="github.com/bep/mycomponent"
`, `
[module]
replacements=["a->b","github.com/bep/mycomponent->c"]
[[module.imports]]
path="github.com/bep/mycomponent"
`} {
cfg, err := config.FromConfigString(tomlConfig, "toml")
c.Assert(err, qt.IsNil)
mcfg, err := DecodeConfig(cfg)
c.Assert(err, qt.IsNil)
c.Assert(mcfg.Replacements, qt.DeepEquals, []string{"a->b", "github.com/bep/mycomponent->c"})
c.Assert(mcfg.replacementsMap, qt.DeepEquals, map[string]string{
"a": "b",
"github.com/bep/mycomponent": "c",
})
c.Assert(mcfg.Imports[0].Path, qt.Equals, "c")
}
})
} }