Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Hide csv param #1279

Merged
merged 5 commits into from
Feb 8, 2023
Merged

Hide csv param #1279

merged 5 commits into from
Feb 8, 2023

Conversation

koebi
Copy link
Collaborator

@koebi koebi commented Feb 8, 2023

Pull Request Checklist

  • 1. I have rebased the latest version of the master branch into my feature branch and all conflicts
    have been resolved.
  • 2. I have added information about the change/addition to functionality to the CHANGELOG.md file under the
    [Unreleased] heading.
  • 3. I have documented my code using JDocs tags.
  • 4. I have removed unnecessary commented out code, imports and System.out.println statements.
  • 5. I have written JUnit tests for any new methods/classes and ensured that they pass.
  • 6. I have created API tests for any new functionality exposed to the API.
  • 7. If changes/additions are made to the ors-config.json file, I have added these to the ors config documentation
    along with a short description of what it is for, and documented this in the Pull Request (below).
  • 8. I have built graphs with my code of the Heidelberg.osm.gz file and run the api-tests with all test passing
  • 9. I have referenced the Issue Number in the Pull Request (if the changes were from an issue).
  • 10. For new features or changes involving building of graphs, I have tested on a larger dataset
    (at least Germany), and the graphs build without problems (i.e. no out-of-memory errors).
  • 11. For new features or changes involving the graphbuilding process (i.e. changing encoders, updating the
    importer etc.), I have generated longer distance routes for the affected profiles with different options
    (avoid features, max weight etc.) and compared these with the routes of the same parameters and start/end
    points generated from the current live ORS.
    If there are differences then the reasoning for these MUST be documented in the pull request.
  • 12. I have written in the Pull Request information about the changes made including their intended usage
    and why the change was needed.
  • 13. For changes touching the API documentation, I have tested that the API playground renders correctly.

Information about the changes

Hides the csv_factor and csv_column parameters.
Explanation is found in the commit messages.

Examples and reasons for differences between live ORS routes, and those generated from this pull request

Required changes to ors config (if applicable)

These two parameters are not intended to be used by the public yet, so they
shouldn't show up in the public API documentation.
Swagger seems to generate API parameters from getter and setter names.
Corresponding to the csv_column API parameter, getters and setters are
called getCsvColumn and setCsvColumn. This generates an API parameter
called csvColumn, that isn't there.

Renaming the variable "links" the variable and getters/setters, and the
csvColumn parameter vanishes.
@takb takb added this to To do in ors general Feb 8, 2023
@takb takb moved this from To do to Review in ors general Feb 8, 2023
koebi and others added 2 commits February 8, 2023 10:50
While it shouldn't show up in the docs, csv is needed for all API tests
to pass.
allowableValues on the ApiModelProperty using the Enum doesn't seem to
work, so csv will show up in the docs.
Copy link
Contributor

@takb takb left a comment

Choose a reason for hiding this comment

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

lgtm

@takb takb merged commit e95b8b5 into master Feb 8, 2023
ors general automation moved this from Review to Awaiting release Feb 8, 2023
@takb takb deleted the hide-csv-param branch February 8, 2023 12:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
ors general
  
Awaiting release
Development

Successfully merging this pull request may close these issues.

None yet

2 participants