[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

[R] Enum R6Class Support, closes #3367 - #5728

Merged
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum
Jul 1, 2020
Merged

[R] Enum R6Class Support, closes #3367#5728
wing328 merged 40 commits into
OpenAPITools:masterfrom
LiNk-NY:enum

Conversation

@LiNk-NY

@LiNk-NYLiNk-NY commented Mar 27, 2020

Copy link
Copy Markdown
Contributor

Hi all,

We've (@mtmorgan, @dvantwisk) provided an R6 class based on guidelines in issue #3367.

This PR includes:

  • modelEnum.mustache
  • changes to methods within R6Class: fromJSONString, fromJSON, etc.
  • removal of stray commas: function(, ...) to function(...)
  • use of httr::content(resp) instead of apiResponse$content
  • updates to the petstore API by running ./bin/r-petstore.sh

Diff of the changes: master...LiNk-NY:enum

Example implementation from the HCAMatrix Service:

v1_ComparisonFilterOperator:
description: 'Comparison operators allowed in matrix filters.'type: stringenum:
- '='
- '!='
- '>'
- '<'
- '>='
- '<='
- 'in'
# HCA Matrix Service## Human Cell Atlas Matrix Service API## The version of the OpenAPI document: 1.0.0## Generated by: https://openapi-generator.tech#' @docType class#' @title V1ComparisonFilterOperator#'#' @description V1ComparisonFilterOperator Class#'#' @format An \code{R6Class} generator object#'#' @importFrom R6 R6Class#' @importFrom jsonlite fromJSON toJSON# add to utils.R.parse_v1_ComparisonFilterOperator<-function(vals) {
res<- gsub("^\\[|\\]$", "",
"[=, !=, >, <, >=, <=, in]"
)
unlist(strsplit(res, ", "))
}
#' @exportV1ComparisonFilterOperator<-R6::R6Class(
"V1ComparisonFilterOperator",
public=list(
initialize=function(...) {
local.optional.var<-list(...)
val<- unlist(local.optional.var)
enumvec<- .parse_v1_ComparisonFilterOperator()
stopifnot(length(val) ==1L)
if (!val%in%enumvec)
stop("Use one of the valid values: ",
paste0(enumvec, collapse=", "))
private$value<-val
},
toJSON=function() {
jsonlite::toJSON(private$value, auto_unbox=TRUE)
},
fromJSON=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
},
toJSONString=function() {
as.character(jsonlite::toJSON(private$value,
auto_unbox=TRUE))
},
fromJSONString=function(V1ComparisonFilterOperatorJson) {
private$value<-jsonlite::fromJSON(V1ComparisonFilterOperatorJson,
simplifyVector=FALSE)
self
}
),
private=list(
value=NULL
)
)

PR checklist

  • Read the contribution guidelines.
  • If contributing template-only or documentation-only changes which will change sample output, build the project before.
  • Run the shell script(s) under ./bin/ (or Windows batch scripts under.\bin\windows) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the code or mustache templates for a language ({LANG}) (e.g. php, ruby, python, etc).
  • File the PR against the correct branch: master, 4.3.x, 5.0.x. Default: master.
  • Copy the technical committee to review the pull request if your PR is targeting a particular programming language.

Best regards,
Marcel

cc @Leo-Rutschmann@wing328@ramnov

To close#3367

LiNk-NYand others added 30 commits November 18, 2019 23:56
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328
Any updates on the PR? Thank you.

@wing328

Copy link
Copy Markdown
Member

Sorry too busy.

@Ramanth I wonder if you can review this PR when you've time. Thank you.

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Thanks Will.
Any updates @Ramanth ?

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Any updates on the PR? @wing328@Ramanth

@wing328

Copy link
Copy Markdown
Member

UPDATE: I've merged the latest master of the official repo into your branch. Let's see if that fixes the CircleCI, Travis CI build failures.

@wing328

Copy link
Copy Markdown
Member

CircleCI reports the following errors:

 All declared Imports should be used.
* checking S3 generic/method consistency ... OK
* checking replacement functions ... OK
* checking foreign function calls ... OK
* checking R code for possible problems ... OK
* checking for missing documentation entries ... WARNING
Undocumented code objects:
‘ApiClient’ ‘ApiResponse’ ‘Category’ ‘ModelApiResponse’ ‘Order’ ‘Pet’
‘PetApi’ ‘StoreApi’ ‘Tag’ ‘User’ ‘UserApi’
All user-level objects in a package should have documentation entries.
See chapter ‘Writing R documentation files’ in the ‘Writing R
Extensions’ manual.
* checking examples ... NONE
* checking for unstated dependencies in ‘tests’ ... OK
* checking tests ...
Running ‘testthat.R’
ERROR
Running the tests in ‘tests/testthat.R’ failed.
Last 13 lines of output:
── 2. Error: GetPetById (@test_petstore.R#45) ─────────────────────────────────
cannot unclass an environment
Backtrace:
1. testthat::expect_equal(...)
3. testthat:::compare.default(act$val, exp$val, ...)
5. base::all.equal.list(x, y, ...)
7. base::all.equal.list(...)
══ testthat results ═══════════════════════════════════════════════════════════
[ OK: 6 | SKIPPED: 48 | WARNINGS: 0 | FAILED: 2 ]
1. Failure: AddPet (@test_petstore.R#17) 2. Error: GetPetById (@test_petstore.R#45) Error: testthat unit tests failed
Execution halted
* DONE
Status: 1 ERROR, 2 WARNINGs, 1 NOTE
See
‘/home/circleci/OpenAPITools/openapi-generator/samples/client/petstore/R/petstore.Rcheck/00check.log’
for details.
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (nose-test) on project RPetstoreClientTests: Command execution failed. Process exited with an error: 1 (Exit value: 1) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] [ERROR] After correcting the problems, you can resume the build with the command
[ERROR] mvn <goals> -rf :RPetstoreClientTests

I wonder if you can take a look when you've time.

@wing328

Copy link
Copy Markdown
Member

For the Travis CI failure, I really have no clue as I don't see any changes to the python samples:

=============== 11 passed, 9 skipped, 1 warnings in 6.70 seconds ===============
___________________________________ summary ____________________________________
py3: commands succeeded
congratulations :)
petstore_api/:0:1: E902 FileNotFoundError: [Errno 2] No such file or directory: 'petstore_api/'
make: *** [test-all] Error 1
Makefile:20: recipe for target 'test-all' failed
[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:1.2.1:exec (test) on project PythonFlaskConnexionTests: Command execution failed. Process exited with an error: 2 (Exit value: 2) -> [Help 1]
[ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 

- export tag does not coincide with original model function
- move helper down so it does
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

Thank you for taking a look at it.

The enum functionality did not introduce any additional tests. I can look into why
it's breaking.

As a side note, based on what I have seen in the original implementation, I wouldn't
expect R CMD check to pass on the package. There are numerous issues with
the generation of the R client such as with the documentation and NAMESPACE.
I am working on these issues separately.
-Marcel

@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi Will, @wing328

I noticed that when running ./bin/r-petstore.sh, the tests in the tests directory for the R package do not get overwritten. I deleted the old test files and re-ran the ./bin/r-petstore.sh script.

Should overwriting be the default when generating the R client SDK? Perhaps, we could
make that change in the script file. Or at least make it an option.

Thanks,
Marcel

@LiNk-NY

LiNk-NY commented May 12, 2020

Copy link
Copy Markdown
ContributorAuthor

Something like:

diff --git a/bin/r-petstore.sh b/bin/r-petstore.sh
index 4decf28f72..abb7095109 100755
--- a/bin/r-petstore.sh+++ b/bin/r-petstore.sh@@ -25,8 +25,14 @@ then
mvn -B clean package
fi
+PET_PKG="samples/client/petstore/R"++if [ -d "${PET_PKG}" ]; then+ rm -rf ${PET_PKG}+fi+
# if you've executed sbt assembly previously it will use that instead.
export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
-ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o samples/client/petstore/R --additional-properties packageName=petstore $@"+ags="generate -t modules/openapi-generator/src/main/resources/r -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g r -o ${PET_PKG} --additional-properties packageName=petstore $@"
java $JAVA_OPTS -jar $executable $ags

@wing328

Copy link
Copy Markdown
Member

the tests in the tests directory for the R package do not get overwritten

That's by design as users may have manually written some tests.

Can you please restore those tests and update the tests to make it work with enum enhancement in this PR instead?

Comment threadmodules/openapi-generator/src/main/resources/r/api.mustache Outdated
Comment threadmodules/openapi-generator/src/main/resources/r/model.mustache Outdated
@LiNk-NY

Copy link
Copy Markdown
ContributorAuthor

Hi William, @wing328, Ramanth @Ramanth
I've made changes and updated the unit tests in the package. It's ready for another review.
Thanks.
-Marcel

@wing328wing328 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but I've not tested it locally.

@wing328

Copy link
Copy Markdown
Member

@LiNk-NY thanks for the contribution, which has been merged into master.

@wing328wing328 added this to the 5.0.0 milestone Jul 3, 2020
jimschubert added a commit that referenced this pull request Jul 3, 2020
* master: (142 commits)
update python samples
clarify direction of py client side validation flag (#6850)
fix erronous cmd arg example for docker in readme (#6846)
[BUG] [JAVA] Fix multiple files upload (#4803) (#6808)
[kotlin][client] fix retrofit dependencies (#6836)
[PowerShell] add more fields to be customized (#6835)
[Java][WebClient]remove the dead code from java ApiClient.mustache (#6556)
[PHP] Better handling of invalid data (array) (#6760)
Make ApiClient in retrofit2 be able to use own OkHttpClient (#6699)
mark python2 support in flask as deprecated (#6653)
update samples
[Java][jersey2] Add a getter for the User-Agent header value (#6831)
Provides a default nil value for optional init parameters (#6827)
[Java] Deprecate feignVersion option (#6824)
[R] Enum R6Class Support, closes#3367 (#5728)
[Rust][Client] Unify sync/async client structure (#6753)
[php-ze-ph] Set required PHP version to ^7.2 (#6763)
[Java][client][native][Gradle] Add missing jackson-databind-nullable (#6802)
Improve sttpOpenApiClient generator (#6684)
Update docker-tag-latest-release.yml
...
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG][R] Generating R enums results in empty class with no values

3 participants

@LiNk-NY@wing328@Ramanth