v2 individual endpoint docs (#96)

* Moves path generation out of the python client into default layers

* Fixes java call sites

* petstore regenerated

* Removes paths with old names

* Removes old autogen tests

* Fixes deprecated method usage, removes unused imports

* Samples regenerated

* templates renamed

* Adds pathEndpointTemplateFiles and uses it

* Adds general code to generate path request bodies and parameters

* Adds pathEndpointResponseTemplateFiles + pathEndpointResponseHeaderTemplateFiles

* Further refactoring, adds pathEndpointTestTemplateFiles

* Finishes generateEndpoints refactor

* Petstore sample regenerated

* Adds java code to generate endpoint docs

* petstore regenerated, per endpoint docs exist

* api docs updated

* FIxes link to endpoint files

* Moves endpoind docs into the tags folder

* Creates and uses CodegenTag to store api module and classname info

* Endpoint docs generated in correct location, tag and tags used in templates

* Removes operationId prefix from endpoint_doc anchors in template

* Petstore regen

* Fixes anchor links, adds anchorContainsPeriod=true

* Updates links in endpoiint files

* Endpoint doc links updated

* Fixes API link

* Fixes api_doc links

* Fixes host and exception info in endpoint docs

* Updates readme endpoints

* Adds request bodies

* Samples regenerated

* Fixes docs dor request bodies, omitted when not present

* Fixes java tsts

Author: spacether

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/CodegenConfig.java

@@ -128,6 +128,8 @@ public interface CodegenConfig {
 
     String getOutputDir();
 
+    String packagePath();
+
     void setOutputDir(String dir);
 
     CodegenModel fromModel(String name, Schema schema);
@@ -156,12 +158,28 @@ public interface CodegenConfig {
 
     Map<String, String> apiTemplateFiles();
 
+    Map<String, String> apiXToApiTemplateFiles();
+
     Map<String, String> modelTemplateFiles();
 
     Map<String, String> requestBodyTemplateFiles();
 
     Map<String, String> requestBodyDocTemplateFiles();
 
+    Map<String, String> pathEndpointTemplateFiles();
+
+    Set<String> pathEndpointTestTemplateFiles();
+
+    Set<String> pathEndpointDocTemplateFiles();
+
+    Map<String, String> pathEndpointRequestBodyTemplateFiles();
+
+    Set<String> pathEndpointParameterTemplateFiles();
+
+    Map<String, String> pathEndpointResponseTemplateFiles();
+
+    Set<String> pathEndpointResponseHeaderTemplateFiles();
+
     Map<String, String> apiTestTemplateFiles();
 
     Map<String, String> modelTestTemplateFiles();
@@ -202,6 +220,10 @@ public interface CodegenConfig {
 
     String toRequestBodyDocFilename(String componentName);
 
+    String toPathFileName(String path);
+
+    String toParameterFileName(String baseName);
+
     String toModelImport(String refClass);
 
     Map<String, String> toModelImportMap(String name);

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/CodegenOperation.java

@@ -18,7 +18,6 @@
 package org.openapitools.codegen;
 
 import io.swagger.v3.oas.models.ExternalDocumentation;
-import io.swagger.v3.oas.models.tags.Tag;
 
 import java.util.*;
 import java.util.stream.Collectors;
@@ -50,7 +49,7 @@ public class CodegenOperation {
     public List<CodegenParameter> requiredParams = new ArrayList<CodegenParameter>();
     public List<CodegenParameter> optionalParams = new ArrayList<CodegenParameter>();
     public List<CodegenSecurity> authMethods;
-    public List<Tag> tags;
+    public Map<String, CodegenTag> tags;
     public List<CodegenResponse> responses = new ArrayList<CodegenResponse>();
     public CodegenResponse defaultResponse = null;
     public List<CodegenCallback> callbacks = new ArrayList<>();

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/CodegenTag.java

@@ -0,0 +1,23 @@
+package org.openapitools.codegen;
+import io.swagger.v3.oas.models.tags.Tag;
+
+public class CodegenTag extends Tag {
+    private String moduleName = null;
+    private String className = null;
+
+    public String getModuleName() {
+        return this.moduleName;
+    }
+
+    public void setModuleName(String moduleName) {
+        this.moduleName = moduleName;
+    }
+
+    public String getClassName() {
+        return this.className;
+    }
+
+    public void setClassName(String className) {
+        this.className = className;
+    }
+}

modules/openapi-json-schema-generator/src/main/java/org/openapitools/codegen/DefaultCodegen.java

@@ -26,6 +26,7 @@
 import com.samskivert.mustache.Mustache.Compiler;
 import com.samskivert.mustache.Mustache.Lambda;
 
+import io.swagger.v3.oas.models.tags.Tag;
 import org.apache.commons.lang3.ObjectUtils;
 import org.apache.commons.text.StringEscapeUtils;
 import org.apache.commons.lang3.StringUtils;
@@ -179,9 +180,17 @@ apiTemplateFiles are for API outputs only (controllers/handlers).
     API templates may be written multiple times; APIs are grouped by tag and the file is written once per tag group.
     */
     protected Map<String, String> apiTemplateFiles = new HashMap<>();
+    protected Map<String, String> apiXToApiTemplateFiles = new HashMap<>();
     protected Map<String, String> modelTemplateFiles = new HashMap<>();
     protected Map<String, String> requestBodyTemplateFiles = new HashMap<>();
     protected Map<String, String> requestBodyDocTemplateFiles = new HashMap();
+    protected Map<String, String> pathEndpointTemplateFiles = new HashMap();
+    protected Set<String> pathEndpointDocTemplateFiles = new HashSet<>();
+    protected Set<String> pathEndpointTestTemplateFiles = new HashSet<>();
+    protected Map<String, String> pathEndpointRequestBodyTemplateFiles = new HashMap<>();
+    protected Set<String> pathEndpointParameterTemplateFiles = new HashSet<>();
+    protected Map<String, String> pathEndpointResponseTemplateFiles = new HashMap<>();
+    protected Set<String> pathEndpointResponseHeaderTemplateFiles = new HashSet<>();
     protected Map<String, String> apiTestTemplateFiles = new HashMap<>();
     protected Map<String, String> modelTestTemplateFiles = new HashMap<>();
     protected Map<String, String> apiDocTemplateFiles = new HashMap<>();
@@ -539,6 +548,10 @@ public String packageName() {
         return packageName;
     }
 
+    public String packagePath() {
+        return packageName.replace('.', File.separatorChar);
+    }
+
     /**
      * Index all CodegenModels by model name.
      *
@@ -1187,6 +1200,9 @@ public Map<String, String> apiTemplateFiles() {
         return apiTemplateFiles;
     }
 
+    @Override
+    public Map<String, String> apiXToApiTemplateFiles() { return apiXToApiTemplateFiles; }
+
     @Override
     public Map<String, String> modelTemplateFiles() {
         return modelTemplateFiles;
@@ -1198,6 +1214,27 @@ public Map<String, String> modelTemplateFiles() {
     @Override
     public Map<String, String> requestBodyDocTemplateFiles() { return requestBodyDocTemplateFiles; }
 
+    @Override
+    public Map<String, String> pathEndpointTemplateFiles() { return pathEndpointTemplateFiles; }
+
+    @Override
+    public Set<String> pathEndpointDocTemplateFiles() { return pathEndpointDocTemplateFiles; }
+
+    @Override
+    public Set<String> pathEndpointTestTemplateFiles() { return pathEndpointTestTemplateFiles; }
+
+    @Override
+    public Map<String, String> pathEndpointRequestBodyTemplateFiles() { return pathEndpointRequestBodyTemplateFiles; }
+
+    @Override
+    public Set<String> pathEndpointParameterTemplateFiles() { return pathEndpointParameterTemplateFiles; }
+
+    @Override
+    public Map<String, String> pathEndpointResponseTemplateFiles() { return pathEndpointResponseTemplateFiles; }
+
+    @Override
+    public Set<String> pathEndpointResponseHeaderTemplateFiles() { return pathEndpointResponseHeaderTemplateFiles; }
+
     public String toRequestBodyFilename(String componentName) {
         return toModuleFilename(componentName);
     }
@@ -1477,6 +1514,14 @@ public String toModuleFilename(String name) {
         return camelize(name);
     }
 
+    public String toPathFileName(String name) {
+        return toModuleFilename(name);
+    }
+
+    @Override
+    public String toParameterFileName(String basename) {
+        return toModuleFilename(basename);
+    }
 
     /**
      * Return the capitalized file name of the model test
@@ -4189,6 +4234,27 @@ public CodegenOperation fromOperation(String path,
             op.servers = fromServers(servers);
         }
 
+        // tags
+        List<String> operationtTagNames = operation.getTags();
+        Map<String, CodegenTag> codegenTags = new HashMap<>();
+        if (operationtTagNames != null) {
+            for (String tagName: operation.getTags()) {
+                CodegenTag codegenTag = new CodegenTag();
+                codegenTag.setName(tagName);
+                codegenTag.setModuleName(toApiFilename(tagName));
+                codegenTag.setClassName(toApiName(tagName));
+                codegenTags.put(tagName, codegenTag);
+            }
+        } else {
+            String tagName = "default";
+            CodegenTag codegenTag = new CodegenTag();
+            codegenTag.setName(tagName);
+            codegenTag.setModuleName(toApiFilename(tagName));
+            codegenTag.setClassName(toApiName(tagName));
+            codegenTags.put(tagName, codegenTag);
+        }
+        op.tags = codegenTags;
+
         // store the original operationId for plug-in
         op.operationIdOriginal = operation.getOperationId();