mirror of
https://github.com/gohugoio/hugo.git
synced 2026-08-24 15:28:54 +00:00
Bjørn Erik Pedersen
f7aeaa6129
This commits reworks how file caching is performed in Hugo. Now there is only one way, and it can be configured. This is the default configuration: ```toml [caches] [caches.getjson] dir = ":cacheDir" maxAge = -1 [caches.getcsv] dir = ":cacheDir" maxAge = -1 [caches.images] dir = ":resourceDir/_gen" maxAge = -1 [caches.assets] dir = ":resourceDir/_gen" maxAge = -1 ``` You can override any of these cache setting in your own `config.toml`. The placeholders explained: `:cacheDir`: This is the value of the `cacheDir` config option if set (can also be set via OS env variable `HUGO_CACHEDIR`). It will fall back to `/opt/build/cache/hugo_cache/` on Netlify, or a `hugo_cache` directory below the OS temp dir for the others. `:resourceDir`: This is the value of the `resourceDir` config option. `maxAge` is the time in seconds before a cache entry will be evicted, -1 means forever and 0 effectively turns that particular cache off. This means that if you run your builds on Netlify, all caches configured with `:cacheDir` will be saved and restored on the next build. For other CI vendors, please read their documentation. For an CircleCI example, see https://github.com/bep/hugo-sass-test/blob/6c3960a8f4b90e8938228688bc49bdcdd6b2d99e/.circleci/config.yml Fixes #5404
77 lines
1.9 KiB
Go
77 lines
1.9 KiB
Go
// Copyright 2018 The Hugo Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package hugio
|
|
|
|
import (
|
|
"io"
|
|
"io/ioutil"
|
|
)
|
|
|
|
type multiWriteCloser struct {
|
|
io.Writer
|
|
closers []io.WriteCloser
|
|
}
|
|
|
|
func (m multiWriteCloser) Close() error {
|
|
var err error
|
|
for _, c := range m.closers {
|
|
if closeErr := c.Close(); err != nil {
|
|
err = closeErr
|
|
}
|
|
}
|
|
return err
|
|
}
|
|
|
|
// NewMultiWriteCloser creates a new io.WriteCloser that duplicates its writes to all the
|
|
// provided writers.
|
|
func NewMultiWriteCloser(writeClosers ...io.WriteCloser) io.WriteCloser {
|
|
writers := make([]io.Writer, len(writeClosers))
|
|
for i, w := range writeClosers {
|
|
writers[i] = w
|
|
}
|
|
return multiWriteCloser{Writer: io.MultiWriter(writers...), closers: writeClosers}
|
|
}
|
|
|
|
// ToWriteCloser creates an io.WriteCloser from the given io.Writer.
|
|
// If it's not already, one will be created with a Close method that does nothing.
|
|
func ToWriteCloser(w io.Writer) io.WriteCloser {
|
|
if rw, ok := w.(io.WriteCloser); ok {
|
|
return rw
|
|
}
|
|
|
|
return struct {
|
|
io.Writer
|
|
io.Closer
|
|
}{
|
|
w,
|
|
ioutil.NopCloser(nil),
|
|
}
|
|
}
|
|
|
|
// ToReadCloser creates an io.ReadCloser from the given io.Reader.
|
|
// If it's not already, one will be created with a Close method that does nothing.
|
|
func ToReadCloser(r io.Reader) io.ReadCloser {
|
|
if rc, ok := r.(io.ReadCloser); ok {
|
|
return rc
|
|
}
|
|
|
|
return struct {
|
|
io.Reader
|
|
io.Closer
|
|
}{
|
|
r,
|
|
ioutil.NopCloser(nil),
|
|
}
|
|
}
|