Mercurial > hg > thermostat-ng
view common/src/main/java/com/redhat/thermostat/common/swaggercombine/SwaggerCombineContext.java @ 28:00540d33ce40 version 0.1.1
Changes to SwaggerCombine for web-gateway schema API
This patch modifies the thermostat-common module by upgrading the
functionality of SwaggerCombine and the YAML parser (which is NOT a full
YAML parser, but only the subset we use) to handle the use cases
about to be implemented in the web-gateway.
- better parsing of YAML arrays
- output and @atfile support in SwaggerCombine
- misc bug fixes
The version number is also ungraded to 0.1.1
Reviewed-by: sgehwolf
Review-thread: http://icedtea.classpath.org/pipermail/thermostat/2017-October/025364.html
author | Simon Tooke <stooke@redhat.com> |
---|---|
date | Wed, 18 Oct 2017 10:28:09 -0400 |
parents | 33cf0b946e3d |
children | 9af3b8b15804 |
line wrap: on
line source
/* * Copyright 2012-2017 Red Hat, Inc. * * This file is part of Thermostat. * * Thermostat is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published * by the Free Software Foundation; either version 2, or (at your * option) any later version. * * Thermostat is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with Thermostat; see the file COPYING. If not see * <http://www.gnu.org/licenses/>. * * Linking this code with other modules is making a combined work * based on this code. Thus, the terms and conditions of the GNU * General Public License cover the whole combination. * * As a special exception, the copyright holders of this code give * you permission to link this code with independent modules to * produce an executable, regardless of the license terms of these * independent modules, and to copy and distribute the resulting * executable under terms of your choice, provided that you also * meet, for each linked independent module, the terms and conditions * of the license of that module. An independent module is a module * which is not derived from or based on this code. If you modify * this code, you may extend this exception to your version of the * library, but you are not obligated to do so. If you do not wish * to do so, delete this exception statement from your version. */ package com.redhat.thermostat.common.swaggercombine; import java.io.File; import java.io.IOException; import java.util.ArrayList; import java.util.List; /** * Utility class containing execution context for SwaggerCombine * (not modified by SwaggerCombine) */ public class SwaggerCombineContext { public enum OutputFormat { NONE, YAML, JSON }; private OutputFormat fmt = OutputFormat.NONE; private boolean pretty = false; private boolean quiet = false; private boolean useTemplate = false; private boolean lint = true; private boolean printUsage = false; private String outputFile= null; private final List<MicroAPI> apiList = new ArrayList<>(); // potential extra args to allow for when building arg array private static final int EXTRA_ARG_COUNT = 5; public static class MicroAPI { public enum InputFormat { FILE, YAML_STRING, JSON_STRING }; private final InputFormat fmt; private final String data; private final File infile; private MicroAPI(InputFormat fmt, String data) { this.fmt = fmt; this.data = data; this.infile = null; } private MicroAPI(InputFormat fmt, File in) { this.fmt = fmt; this.data = null; this.infile = in; } static MicroAPI createFromYaml(String yaml) { return new MicroAPI(InputFormat.YAML_STRING, yaml); } static MicroAPI createFromJson(String json) { return new MicroAPI(InputFormat.JSON_STRING, json); } static MicroAPI createFromFile(File fn) { return new MicroAPI(InputFormat.FILE, fn); } InputFormat getFormat() { return fmt; } String getData() { return data; } File getInFile() { return infile; } } public SwaggerCombineContext() { } public String getOutputFile() { return outputFile; } /** * set an output file (defaults to stdout) * @param outputFile name of file (null or '-' for stdout) */ public void setOutputFile(String outputFile) { this.outputFile = outputFile; } /** * define the output format * @param fmt one of OutputFormat.YAML | JSON or NONE * @return this */ public SwaggerCombineContext produce(OutputFormat fmt) { this.fmt = fmt; return this; } /** * set pretty printing on or off * @param pp true to set pretty printing on * @return this */ public SwaggerCombineContext prettyPrint(boolean pp) { this.pretty = pp; return this; } /** * set quiet mode * @param pp troue to set quiet mode (no progress messages) * @return this */ public SwaggerCombineContext quiet(boolean pp) { this.quiet = pp; return this; } /** * set initial document to built in template * @param pp true to use built in template as initial document * If not used, the root elements (version, title, etc) of the first document specified are used. * @return this */ public SwaggerCombineContext useTemplate(boolean pp) { this.useTemplate = pp; return this; } /** * run basic tests on input documents * @param pp true to run initial tests * @return this */ public SwaggerCombineContext lint(boolean pp) { this.lint = pp; return this; } /** * add an input file (representing a microAPI defined by Swagger) * @param fin input micro API definitions * @return this * @throws IOException if an I/O error occurred */ public SwaggerCombineContext addMicroAPI(File fin) throws IOException { final MicroAPI api = MicroAPI.createFromFile(fin); this.getAPIList().add(api); return this; } /** * add an input file (representing a microAPI defined by Swagger) * @param spec input micro API definitions * @param isYaml true if format of input file is YAML, false if gormat is JSON * @return this * @throws IOException if an I/O error occurred */ public SwaggerCombineContext addMicroAPI(String spec, boolean isYaml) throws IOException { final MicroAPI api = isYaml ? MicroAPI.createFromYaml(spec) : MicroAPI.createFromJson(spec); this.getAPIList().add(api); return this; } /** * set quiet mode * @param pp troue to set quiet mode (no progress messages) * @return this */ public SwaggerCombineContext usage(boolean pp) { this.printUsage = pp; return this; } public static int getExtraArgCount() { return EXTRA_ARG_COUNT; } public OutputFormat getFmt() { return fmt; } public boolean isPretty() { return pretty; } public boolean isQuiet() { return quiet; } public boolean isUseTemplate() { return useTemplate; } public boolean isLint() { return lint; } public boolean printUsage() { return printUsage; } public List<MicroAPI> getAPIList() { return apiList; } }