blob: 566ac18e8b783dd96c241aca95af3f3d8d077925 [file] [log] [blame]
Joey Armstrong28eddda2023-01-10 03:09:34 -05001# -*- makefile -*-
2# -----------------------------------------------------------------------
3# Copyright 2017-2023 Open Networking Foundation (ONF) and the ONF Contributors
4#
Joey Armstrong980e37f2023-02-28 18:57:41 -05005# Licensed under the Apache License, Version 2.0 (the "License")
Joey Armstrong28eddda2023-01-10 03:09:34 -05006# you may not use this file except in compliance with the License.
7# You may obtain a copy of the License at
8#
9# http://www.apache.org/licenses/LICENSE-2.0
10#
11# Unless required by applicable law or agreed to in writing, software
12# distributed under the License is distributed on an "AS IS" BASIS,
13# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14# See the License for the specific language governing permissions and
15# limitations under the License.
16# -----------------------------------------------------------------------
17
Joey Armstrong980e37f2023-02-28 18:57:41 -050018$(if $(DEBUG),$(warning ENTER))
Joey Armstrong28eddda2023-01-10 03:09:34 -050019
Joey Armstrong980e37f2023-02-28 18:57:41 -050020##-------------------##
21##---] GLOBALS [---##
22##-------------------##
23.PHONY: lint-yaml lint-yaml-all lint-yaml-modified
Joey Armstrong28eddda2023-01-10 03:09:34 -050024
Joey Armstrong980e37f2023-02-28 18:57:41 -050025have-yaml-files := $(if $(strip $(YAML_FILES)),true)
26YAML_FILES ?= $(error YAML_FILES= is required)
Joey Armstrong28eddda2023-01-10 03:09:34 -050027
Joey Armstrong980e37f2023-02-28 18:57:41 -050028## -----------------------------------------------------------------------
29## Intent: Use the yaml command to perform syntax checking.
30## o If UNSTABLE=1 syntax check all sources
31## o else only check sources modified by the developer.
32## Usage:
33## % make lint UNSTABLE=1
34## % make lint-yaml-all
35## -----------------------------------------------------------------------
36ifndef NO-LINT-YAML
37 lint-yaml-mode := $(if $(have-yaml-files),modified,all)
38 lint : lint-yaml-$(lint-yaml-mode)
39endif# NO-LINT-YAML
Joey Armstrong28eddda2023-01-10 03:09:34 -050040
Joey Armstrong980e37f2023-02-28 18:57:41 -050041## -----------------------------------------------------------------------
42## Intent: exhaustive yaml syntax checking
43## -----------------------------------------------------------------------
44lint-yaml-all:
45 $(HIDE)$(MAKE) --no-print-directory lint-yaml-install
46
47 find . \( -iname '*.yaml' -o -iname '*.yml' \) -print0 \
48 | $(xargs-n1-clean) yamllint --strict
49
50## -----------------------------------------------------------------------
51## Intent: check deps for format and python3 cleanliness
52## Note:
53## yaml --py3k option no longer supported
54## -----------------------------------------------------------------------
55lint-yaml-modified:
56 $(HIDE)$(MAKE) --no-print-directory lint-yaml-install
57 yamllint -s $(YAML_FILES)
58
59## -----------------------------------------------------------------------
60## Intent:
61## -----------------------------------------------------------------------
62lint-yaml-install:
63 @echo
64 @echo "** -----------------------------------------------------------------------"
65 @echo "** yaml syntax checking"
66 @echo "** -----------------------------------------------------------------------"
67 yamllint --version
68 @echo
69
70## -----------------------------------------------------------------------
71## Intent: Display command usage
72## -----------------------------------------------------------------------
Joey Armstrong28eddda2023-01-10 03:09:34 -050073help::
Joey Armstrong980e37f2023-02-28 18:57:41 -050074 @echo ' lint-yaml Syntax check python using the yaml command'
75 ifdef VERBOSE
76 @echo ' lint-yaml-all yaml checking: exhaustive'
77 @echo ' lint-yaml-modified yaml checking: only modified'
78 endif
79
80$(if $(DEBUG),$(warning LEAVE))
Joey Armstrong28eddda2023-01-10 03:09:34 -050081
82# [EOF]