swagger-api/swagger-codegen

Clojure: Unexpected namespace names for /api/v1 resource

Open

#2,381 opened on Mar 15, 2016

View on GitHub
 (1 comment) (0 reactions) (0 assignees)HTML (12,701 stars) (5,474 forks)batch import
Client: ClojureIssue: Bughelp wanted

Description

I am trying to build a client for the Kubernetes API, which is available at a /api/v1 resource:

{
  "swaggerVersion": "1.2",
  "apiVersion": "v1",
  "basePath": "https://...",
  "resourcePath": "/api/v1",
  ...
}

swagger-codegen generates following file:

; src/kubernetes/api/apiv.clj
(ns kubernetes.api.apiv
 ...

The filename (src/kubernetes/api/apiv.clj) and namespace name kubernetes.api.apiv are unexpected. I would rather expect swagger-codegen to generate src/kubernetes/api/v1.clj which contains the kubernetes.api.v1 namespace.

Contributor guide

Tech stack
None
Domain
toolingapi
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
familiarity with swagger codegen codebaseunderstanding of path to namespace conversion
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70
Research direction
Examine the Clojure code generation in swagger codegen, focusing on how the resource path (e.g., '/api/v1') is transformed into a namespace name. The issue is that version numbers like 'v1' are being stripped or incorrectly converted to 'apiv'. Look at the code that maps path segments to identifiers, particularly the handling of numbers. The fix likely involves ensuring that segments like 'v1' are preserved as is. Check the file that defines the namespace generation logic for Clojure.