aboutsummaryrefslogtreecommitdiffstats
path: root/binapigen/vppapi/parser.go
blob: 312dd0e50f6b53f04f27705448d9770265ec36dc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
//  Copyright (c) 2020 Cisco and/or its affiliates.
//
//  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 vppapi

import (
	"fmt"
	"io/ioutil"
	"path/filepath"
	"strings"

	"github.com/sirupsen/logrus"
)

const (
	DefaultAPIDir = "/usr/share/vpp/api"
)

const apifileSuffixJson = ".api.json"

// FindFiles returns all input files located in specified directory
func FindFiles(dir string, deep int) (paths []string, err error) {
	entries, err := ioutil.ReadDir(dir)
	if err != nil {
		return nil, fmt.Errorf("reading directory %s failed: %v", dir, err)
	}
	for _, e := range entries {
		if e.IsDir() && deep > 0 {
			nestedDir := filepath.Join(dir, e.Name())
			if nested, err := FindFiles(nestedDir, deep-1); err != nil {
				return nil, err
			} else {
				paths = append(paths, nested...)
			}
		} else if strings.HasSuffix(e.Name(), apifileSuffixJson) {
			paths = append(paths, filepath.Join(dir, e.Name()))
		}
	}
	return paths, nil
}

func Parse() ([]*File, error) {
	return ParseDir(DefaultAPIDir)
}

func ParseDir(apidir string) ([]*File, error) {
	files, err := FindFiles(apidir, 1)
	if err != nil {
		return nil, err
	}

	logrus.Infof("found %d files in API dir %q", len(files), apidir)

	var modules []*File

	for _, file := range files {
		module, err := ParseFile(file)
		if err != nil {
			return nil, err
		}
		modules = append(modules, module)
	}

	return modules, nil
}

// ParseFile parses API file contents and returns File.
func ParseFile(apifile string) (*File, error) {
	if !strings.HasSuffix(apifile, apifileSuffixJson) {
		return nil, fmt.Errorf("unsupported file format: %q", apifile)
	}

	data, err := ioutil.ReadFile(apifile)
	if err != nil {
		return nil, fmt.Errorf("reading file %s failed: %v", apifile, err)
	}

	base := filepath.Base(apifile)
	name := base[:strings.Index(base, ".")]

	logf("parsing file %q", base)

	module, err := ParseRaw(data)
	if err != nil {
		return nil, fmt.Errorf("parsing file %s failed: %v", base, err)
	}
	module.Name = name
	module.Path = apifile

	return module, nil
}

func ParseRaw(data []byte) (file *File, err error) {
	file, err = parseJSON(data)
	if err != nil {
		return nil, err
	}

	return file, nil
}