2017-03-05 12:23:00 -05:00
|
|
|
// Copyright 2017-present 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 media
|
|
|
|
|
|
|
|
import (
|
|
|
|
"testing"
|
|
|
|
|
|
|
|
"github.com/stretchr/testify/require"
|
|
|
|
)
|
|
|
|
|
|
|
|
func TestDefaultTypes(t *testing.T) {
|
2017-03-27 18:09:25 -04:00
|
|
|
for _, test := range []struct {
|
|
|
|
tp Type
|
|
|
|
expectedMainType string
|
|
|
|
expectedSubType string
|
|
|
|
expectedSuffix string
|
|
|
|
expectedType string
|
|
|
|
expectedString string
|
|
|
|
}{
|
2018-07-10 05:55:22 -04:00
|
|
|
{CalendarType, "text", "calendar", "ics", "text/calendar", "text/calendar"},
|
|
|
|
{CSSType, "text", "css", "css", "text/css", "text/css"},
|
|
|
|
{SCSSType, "text", "x-scss", "scss", "text/x-scss", "text/x-scss"},
|
|
|
|
{CSVType, "text", "csv", "csv", "text/csv", "text/csv"},
|
|
|
|
{HTMLType, "text", "html", "html", "text/html", "text/html"},
|
|
|
|
{JavascriptType, "application", "javascript", "js", "application/javascript", "application/javascript"},
|
|
|
|
{JSONType, "application", "json", "json", "application/json", "application/json"},
|
|
|
|
{RSSType, "application", "rss", "xml", "application/rss+xml", "application/rss+xml"},
|
|
|
|
{SVGType, "image", "svg", "svg", "image/svg+xml", "image/svg+xml"},
|
|
|
|
{TextType, "text", "plain", "txt", "text/plain", "text/plain"},
|
|
|
|
{XMLType, "application", "xml", "xml", "application/xml", "application/xml"},
|
2017-03-27 18:09:25 -04:00
|
|
|
} {
|
|
|
|
require.Equal(t, test.expectedMainType, test.tp.MainType)
|
|
|
|
require.Equal(t, test.expectedSubType, test.tp.SubType)
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, test.expectedSuffix, test.tp.Suffix(), test.tp.String())
|
2017-06-20 02:45:52 -04:00
|
|
|
require.Equal(t, defaultDelimiter, test.tp.Delimiter)
|
2017-03-27 18:09:25 -04:00
|
|
|
|
|
|
|
require.Equal(t, test.expectedType, test.tp.Type())
|
|
|
|
require.Equal(t, test.expectedString, test.tp.String())
|
|
|
|
|
|
|
|
}
|
2017-03-05 12:23:00 -05:00
|
|
|
|
|
|
|
}
|
2017-04-03 11:00:23 -04:00
|
|
|
|
|
|
|
func TestGetByType(t *testing.T) {
|
|
|
|
types := Types{HTMLType, RSSType}
|
|
|
|
|
|
|
|
mt, found := types.GetByType("text/HTML")
|
|
|
|
require.True(t, found)
|
|
|
|
require.Equal(t, mt, HTMLType)
|
|
|
|
|
|
|
|
_, found = types.GetByType("text/nono")
|
|
|
|
require.False(t, found)
|
2018-07-10 05:55:22 -04:00
|
|
|
|
|
|
|
mt, found = types.GetByType("application/rss+xml")
|
|
|
|
require.True(t, found)
|
|
|
|
require.Equal(t, mt, RSSType)
|
|
|
|
|
|
|
|
mt, found = types.GetByType("application/rss")
|
|
|
|
require.True(t, found)
|
|
|
|
require.Equal(t, mt, RSSType)
|
|
|
|
}
|
|
|
|
|
|
|
|
func TestGetByMainSubType(t *testing.T) {
|
|
|
|
assert := require.New(t)
|
|
|
|
f, found := DefaultTypes.GetByMainSubType("text", "plain")
|
|
|
|
assert.True(found)
|
|
|
|
assert.Equal(f, TextType)
|
|
|
|
_, found = DefaultTypes.GetByMainSubType("foo", "plain")
|
|
|
|
assert.False(found)
|
2017-04-03 11:00:23 -04:00
|
|
|
}
|
2017-04-03 16:39:37 -04:00
|
|
|
|
2018-08-28 08:18:12 -04:00
|
|
|
func TestBySuffix(t *testing.T) {
|
|
|
|
assert := require.New(t)
|
|
|
|
formats := DefaultTypes.BySuffix("xml")
|
|
|
|
assert.Equal(2, len(formats))
|
|
|
|
assert.Equal("rss", formats[0].SubType)
|
|
|
|
assert.Equal("xml", formats[1].SubType)
|
|
|
|
}
|
|
|
|
|
Add Hugo Piper with SCSS support and much more
Before this commit, you would have to use page bundles to do image processing etc. in Hugo.
This commit adds
* A new `/assets` top-level project or theme dir (configurable via `assetDir`)
* A new template func, `resources.Get` which can be used to "get a resource" that can be further processed.
This means that you can now do this in your templates (or shortcodes):
```bash
{{ $sunset := (resources.Get "images/sunset.jpg").Fill "300x200" }}
```
This also adds a new `extended` build tag that enables powerful SCSS/SASS support with source maps. To compile this from source, you will also need a C compiler installed:
```
HUGO_BUILD_TAGS=extended mage install
```
Note that you can use output of the SCSS processing later in a non-SCSSS-enabled Hugo.
The `SCSS` processor is a _Resource transformation step_ and it can be chained with the many others in a pipeline:
```bash
{{ $css := resources.Get "styles.scss" | resources.ToCSS | resources.PostCSS | resources.Minify | resources.Fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
The transformation funcs above have aliases, so it can be shortened to:
```bash
{{ $css := resources.Get "styles.scss" | toCSS | postCSS | minify | fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
A quick tip would be to avoid the fingerprinting part, and possibly also the not-superfast `postCSS` when you're doing development, as it allows Hugo to be smarter about the rebuilding.
Documentation will follow, but have a look at the demo repo in https://github.com/bep/hugo-sass-test
New functions to create `Resource` objects:
* `resources.Get` (see above)
* `resources.FromString`: Create a Resource from a string.
New `Resource` transformation funcs:
* `resources.ToCSS`: Compile `SCSS` or `SASS` into `CSS`.
* `resources.PostCSS`: Process your CSS with PostCSS. Config file support (project or theme or passed as an option).
* `resources.Minify`: Currently supports `css`, `js`, `json`, `html`, `svg`, `xml`.
* `resources.Fingerprint`: Creates a fingerprinted version of the given Resource with Subresource Integrity..
* `resources.Concat`: Concatenates a list of Resource objects. Think of this as a poor man's bundler.
* `resources.ExecuteAsTemplate`: Parses and executes the given Resource and data context (e.g. .Site) as a Go template.
Fixes #4381
Fixes #4903
Fixes #4858
2018-02-20 04:02:14 -05:00
|
|
|
func TestGetFirstBySuffix(t *testing.T) {
|
|
|
|
assert := require.New(t)
|
|
|
|
f, found := DefaultTypes.GetFirstBySuffix("xml")
|
|
|
|
assert.True(found)
|
2018-08-28 08:18:12 -04:00
|
|
|
assert.Equal(Type{MainType: "application", SubType: "rss", mimeSuffix: "xml", Delimiter: ".", Suffixes: []string{"xml"}, fileSuffix: "xml"}, f)
|
Add Hugo Piper with SCSS support and much more
Before this commit, you would have to use page bundles to do image processing etc. in Hugo.
This commit adds
* A new `/assets` top-level project or theme dir (configurable via `assetDir`)
* A new template func, `resources.Get` which can be used to "get a resource" that can be further processed.
This means that you can now do this in your templates (or shortcodes):
```bash
{{ $sunset := (resources.Get "images/sunset.jpg").Fill "300x200" }}
```
This also adds a new `extended` build tag that enables powerful SCSS/SASS support with source maps. To compile this from source, you will also need a C compiler installed:
```
HUGO_BUILD_TAGS=extended mage install
```
Note that you can use output of the SCSS processing later in a non-SCSSS-enabled Hugo.
The `SCSS` processor is a _Resource transformation step_ and it can be chained with the many others in a pipeline:
```bash
{{ $css := resources.Get "styles.scss" | resources.ToCSS | resources.PostCSS | resources.Minify | resources.Fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
The transformation funcs above have aliases, so it can be shortened to:
```bash
{{ $css := resources.Get "styles.scss" | toCSS | postCSS | minify | fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
A quick tip would be to avoid the fingerprinting part, and possibly also the not-superfast `postCSS` when you're doing development, as it allows Hugo to be smarter about the rebuilding.
Documentation will follow, but have a look at the demo repo in https://github.com/bep/hugo-sass-test
New functions to create `Resource` objects:
* `resources.Get` (see above)
* `resources.FromString`: Create a Resource from a string.
New `Resource` transformation funcs:
* `resources.ToCSS`: Compile `SCSS` or `SASS` into `CSS`.
* `resources.PostCSS`: Process your CSS with PostCSS. Config file support (project or theme or passed as an option).
* `resources.Minify`: Currently supports `css`, `js`, `json`, `html`, `svg`, `xml`.
* `resources.Fingerprint`: Creates a fingerprinted version of the given Resource with Subresource Integrity..
* `resources.Concat`: Concatenates a list of Resource objects. Think of this as a poor man's bundler.
* `resources.ExecuteAsTemplate`: Parses and executes the given Resource and data context (e.g. .Site) as a Go template.
Fixes #4381
Fixes #4903
Fixes #4858
2018-02-20 04:02:14 -05:00
|
|
|
}
|
|
|
|
|
2017-04-03 16:39:37 -04:00
|
|
|
func TestFromTypeString(t *testing.T) {
|
2018-07-10 05:55:22 -04:00
|
|
|
f, err := fromString("text/html")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.NoError(t, err)
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, HTMLType.Type(), f.Type())
|
2017-04-03 16:39:37 -04:00
|
|
|
|
2018-07-10 05:55:22 -04:00
|
|
|
f, err = fromString("application/custom")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.NoError(t, err)
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, Type{MainType: "application", SubType: "custom", mimeSuffix: "", fileSuffix: ""}, f)
|
2017-04-03 16:39:37 -04:00
|
|
|
|
2018-07-10 05:55:22 -04:00
|
|
|
f, err = fromString("application/custom+sfx")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.NoError(t, err)
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, Type{MainType: "application", SubType: "custom", mimeSuffix: "sfx"}, f)
|
2017-04-03 16:39:37 -04:00
|
|
|
|
2018-07-10 05:55:22 -04:00
|
|
|
_, err = fromString("noslash")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.Error(t, err)
|
|
|
|
|
2018-07-10 05:55:22 -04:00
|
|
|
f, err = fromString("text/xml; charset=utf-8")
|
Add Hugo Piper with SCSS support and much more
Before this commit, you would have to use page bundles to do image processing etc. in Hugo.
This commit adds
* A new `/assets` top-level project or theme dir (configurable via `assetDir`)
* A new template func, `resources.Get` which can be used to "get a resource" that can be further processed.
This means that you can now do this in your templates (or shortcodes):
```bash
{{ $sunset := (resources.Get "images/sunset.jpg").Fill "300x200" }}
```
This also adds a new `extended` build tag that enables powerful SCSS/SASS support with source maps. To compile this from source, you will also need a C compiler installed:
```
HUGO_BUILD_TAGS=extended mage install
```
Note that you can use output of the SCSS processing later in a non-SCSSS-enabled Hugo.
The `SCSS` processor is a _Resource transformation step_ and it can be chained with the many others in a pipeline:
```bash
{{ $css := resources.Get "styles.scss" | resources.ToCSS | resources.PostCSS | resources.Minify | resources.Fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
The transformation funcs above have aliases, so it can be shortened to:
```bash
{{ $css := resources.Get "styles.scss" | toCSS | postCSS | minify | fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
A quick tip would be to avoid the fingerprinting part, and possibly also the not-superfast `postCSS` when you're doing development, as it allows Hugo to be smarter about the rebuilding.
Documentation will follow, but have a look at the demo repo in https://github.com/bep/hugo-sass-test
New functions to create `Resource` objects:
* `resources.Get` (see above)
* `resources.FromString`: Create a Resource from a string.
New `Resource` transformation funcs:
* `resources.ToCSS`: Compile `SCSS` or `SASS` into `CSS`.
* `resources.PostCSS`: Process your CSS with PostCSS. Config file support (project or theme or passed as an option).
* `resources.Minify`: Currently supports `css`, `js`, `json`, `html`, `svg`, `xml`.
* `resources.Fingerprint`: Creates a fingerprinted version of the given Resource with Subresource Integrity..
* `resources.Concat`: Concatenates a list of Resource objects. Think of this as a poor man's bundler.
* `resources.ExecuteAsTemplate`: Parses and executes the given Resource and data context (e.g. .Site) as a Go template.
Fixes #4381
Fixes #4903
Fixes #4858
2018-02-20 04:02:14 -05:00
|
|
|
require.NoError(t, err)
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, Type{MainType: "text", SubType: "xml", mimeSuffix: ""}, f)
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, "", f.Suffix())
|
|
|
|
}
|
|
|
|
|
|
|
|
// Add a test for the SVG case
|
|
|
|
// https://github.com/gohugoio/hugo/issues/4920
|
|
|
|
func TestFromExtensionMultipleSuffixes(t *testing.T) {
|
|
|
|
assert := require.New(t)
|
|
|
|
tp, found := DefaultTypes.GetBySuffix("svg")
|
|
|
|
assert.True(found)
|
|
|
|
assert.Equal("image/svg+xml", tp.String())
|
|
|
|
assert.Equal("svg", tp.fileSuffix)
|
|
|
|
assert.Equal(".svg", tp.FullSuffix())
|
|
|
|
tp, found = DefaultTypes.GetByType("image/svg+xml")
|
|
|
|
assert.True(found)
|
|
|
|
assert.Equal("image/svg+xml", tp.String())
|
|
|
|
assert.True(found)
|
|
|
|
assert.Equal(".svg", tp.FullSuffix())
|
Add Hugo Piper with SCSS support and much more
Before this commit, you would have to use page bundles to do image processing etc. in Hugo.
This commit adds
* A new `/assets` top-level project or theme dir (configurable via `assetDir`)
* A new template func, `resources.Get` which can be used to "get a resource" that can be further processed.
This means that you can now do this in your templates (or shortcodes):
```bash
{{ $sunset := (resources.Get "images/sunset.jpg").Fill "300x200" }}
```
This also adds a new `extended` build tag that enables powerful SCSS/SASS support with source maps. To compile this from source, you will also need a C compiler installed:
```
HUGO_BUILD_TAGS=extended mage install
```
Note that you can use output of the SCSS processing later in a non-SCSSS-enabled Hugo.
The `SCSS` processor is a _Resource transformation step_ and it can be chained with the many others in a pipeline:
```bash
{{ $css := resources.Get "styles.scss" | resources.ToCSS | resources.PostCSS | resources.Minify | resources.Fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
The transformation funcs above have aliases, so it can be shortened to:
```bash
{{ $css := resources.Get "styles.scss" | toCSS | postCSS | minify | fingerprint }}
<link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Digest }}" media="screen">
```
A quick tip would be to avoid the fingerprinting part, and possibly also the not-superfast `postCSS` when you're doing development, as it allows Hugo to be smarter about the rebuilding.
Documentation will follow, but have a look at the demo repo in https://github.com/bep/hugo-sass-test
New functions to create `Resource` objects:
* `resources.Get` (see above)
* `resources.FromString`: Create a Resource from a string.
New `Resource` transformation funcs:
* `resources.ToCSS`: Compile `SCSS` or `SASS` into `CSS`.
* `resources.PostCSS`: Process your CSS with PostCSS. Config file support (project or theme or passed as an option).
* `resources.Minify`: Currently supports `css`, `js`, `json`, `html`, `svg`, `xml`.
* `resources.Fingerprint`: Creates a fingerprinted version of the given Resource with Subresource Integrity..
* `resources.Concat`: Concatenates a list of Resource objects. Think of this as a poor man's bundler.
* `resources.ExecuteAsTemplate`: Parses and executes the given Resource and data context (e.g. .Site) as a Go template.
Fixes #4381
Fixes #4903
Fixes #4858
2018-02-20 04:02:14 -05:00
|
|
|
|
2017-04-03 16:39:37 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
func TestDecodeTypes(t *testing.T) {
|
|
|
|
|
|
|
|
var tests = []struct {
|
|
|
|
name string
|
|
|
|
maps []map[string]interface{}
|
|
|
|
shouldError bool
|
|
|
|
assert func(t *testing.T, name string, tt Types)
|
|
|
|
}{
|
|
|
|
{
|
|
|
|
"Redefine JSON",
|
|
|
|
[]map[string]interface{}{
|
2017-08-07 14:03:15 -04:00
|
|
|
{
|
2017-04-03 16:39:37 -04:00
|
|
|
"application/json": map[string]interface{}{
|
2018-07-10 05:55:22 -04:00
|
|
|
"suffixes": []string{"jasn"}}}},
|
2017-04-03 16:39:37 -04:00
|
|
|
false,
|
|
|
|
func(t *testing.T, name string, tt Types) {
|
|
|
|
require.Len(t, tt, len(DefaultTypes))
|
2018-07-10 05:55:22 -04:00
|
|
|
json, found := tt.GetBySuffix("jasn")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.True(t, found)
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, "application/json", json.String(), name)
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, ".jasn", json.FullSuffix())
|
2018-07-10 05:55:22 -04:00
|
|
|
}},
|
|
|
|
{
|
2018-08-28 08:18:12 -04:00
|
|
|
"MIME suffix in key, multiple file suffixes, custom delimiter",
|
2018-07-10 05:55:22 -04:00
|
|
|
[]map[string]interface{}{
|
|
|
|
{
|
|
|
|
"application/hugo+hg": map[string]interface{}{
|
2018-08-28 08:18:12 -04:00
|
|
|
"suffixes": []string{"hg1", "hg2"},
|
|
|
|
"Delimiter": "_",
|
2018-07-10 05:55:22 -04:00
|
|
|
}}},
|
|
|
|
false,
|
|
|
|
func(t *testing.T, name string, tt Types) {
|
|
|
|
require.Len(t, tt, len(DefaultTypes)+1)
|
2018-08-28 08:18:12 -04:00
|
|
|
hg, found := tt.GetBySuffix("hg2")
|
2018-07-10 05:55:22 -04:00
|
|
|
require.True(t, found)
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, "hg", hg.mimeSuffix)
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, "hg2", hg.Suffix())
|
2018-08-28 08:18:12 -04:00
|
|
|
require.Equal(t, "_hg2", hg.FullSuffix())
|
2018-07-10 05:55:22 -04:00
|
|
|
require.Equal(t, "application/hugo+hg", hg.String(), name)
|
|
|
|
|
|
|
|
hg, found = tt.GetByType("application/hugo+hg")
|
|
|
|
require.True(t, found)
|
|
|
|
|
2017-04-03 16:39:37 -04:00
|
|
|
}},
|
|
|
|
{
|
|
|
|
"Add custom media type",
|
|
|
|
[]map[string]interface{}{
|
2017-08-07 14:03:15 -04:00
|
|
|
{
|
2018-08-28 08:18:12 -04:00
|
|
|
"text/hugo+hgo": map[string]interface{}{
|
|
|
|
"Suffixes": []string{"hgo2"}}}},
|
2017-04-03 16:39:37 -04:00
|
|
|
false,
|
|
|
|
func(t *testing.T, name string, tt Types) {
|
|
|
|
require.Len(t, tt, len(DefaultTypes)+1)
|
|
|
|
// Make sure we have not broken the default config.
|
2018-07-10 05:55:22 -04:00
|
|
|
|
2017-04-03 16:39:37 -04:00
|
|
|
_, found := tt.GetBySuffix("json")
|
|
|
|
require.True(t, found)
|
|
|
|
|
2018-08-28 08:18:12 -04:00
|
|
|
hugo, found := tt.GetBySuffix("hgo2")
|
2017-04-03 16:39:37 -04:00
|
|
|
require.True(t, found)
|
|
|
|
require.Equal(t, "text/hugo+hgo", hugo.String(), name)
|
|
|
|
}},
|
|
|
|
}
|
|
|
|
|
|
|
|
for _, test := range tests {
|
|
|
|
result, err := DecodeTypes(test.maps...)
|
|
|
|
if test.shouldError {
|
|
|
|
require.Error(t, err, test.name)
|
|
|
|
} else {
|
|
|
|
require.NoError(t, err, test.name)
|
|
|
|
test.assert(t, test.name, result)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|