Does anyone know if there exists a code generator for Paw which will export to Swagger definitions? I couldn't find one in the list of generators and was wondering how such a popular format could be left out.
Thanks for your time.
It's coming next week :D
We have been working hard on an API conversion tool, on which the Swagger exporter will be based (it's open source on GitHub: https://github.com/luckymarmot/API-Flow, but still not officially released).
Also, there's already a Swagger importer if that can help you: https://paw.cloud/extensions/SwaggerImporter
Related
Hydra provides a way to dynamically create a hierarchical configuration by composition and override it through config files and the command line, leveraging OmegaConf. I look for a recommended way to document the parameters but I could not find (a documented) one. What are best practices for that? Coming from argparse, I like the way of documenting the parameter inline, i.e. close to the code.
Excellent question! The answer is: parameter-by-parameter documentation is not yet implemented (as of Hydra v1.1, OmegaConf v2.1).
The future plans are:
in OmegaConf, expose an API allowing users to attach documentation (and other metadata) to each field of a structured config. See this open OmegaConf issue.
Once the above is complete, implement a Hydra feature allowing a parameter-specific help messages to be printed based on the parameter's metadata. See this open Hydra issue.
For now, the best we can do is to customize the general application help message (i.e. the --help command line flag).
I tried to use the OpenAPI Service Ref in Visual Studio 2019 to import the HERE Routing API Specification file into my Solution. But this didn't work. (obscure error code -1) As I tried to figure it out, I used a couple of other API tools, and found out that the reference on line 272 seemed wrogly formatted.
I changed this:
LineString: "../shared/common.yaml#/components/schemas/LineString" to LineString: "#/components/schemas/LineString"
The file is now imported and the classes are created. But now I am also having build errors because class Price isn't defined...
I have a feeling that this yaml file has a few hickups ;)
Hope you guys get it resolved.
The development team is looking at this issue and I will keep updated here.
Update: This issue has been addressed and worked on with priority by the development team. So far the OpenAOI Spec doesn't support code generating.
I need to export everything (sites, dashboard, users, groups ecc...) is under my Alfresco ed import all to another Alfresco installation.
I discovered this usefull tool https://github.com/atolcd/alfresco-share-import-export but seems to me that it is good to create an .acp of a site for example but it's not enought for others stuff expecially users.
Please, what's an easy way to export everything from Alfresco ? And then how to import ? Thank you.
I used this Pynthon scripts github.com/wabson/share-import-export but no way an error on the python script execution : C:\Users\xxx\Desktop\Nuova cartella>python export-users.py file.json --username=xxx --password=xxx --url=localhost:8080/share/page/site/xxx/dashboard File "export-users.py", line 5 ^ SyntaxError: invalid syntax
I have Alfresco 5.1 and Pynthon 2.7.12
screenshot
Your url param is incorrect. Use the below one.
python export-users.py file.json --username=admin --password=admin --url=http://localhost:8080/share
This should work for you.
The Share URL should be, http://<IP or systemname>:<portnumber/share, but you've mentioned the one site dashboard url. Please change that.
You can also use alfresco OOTB replication service and replicate all the data from one alfresco instance to second one.
I am looking for reference docs for the Azure Resource Manager JSON templates. Does anyone know if there is reference material for these templates?
There is general reference for required parameters etc like at Create a template deployment.
I am basically looking for the full availability so I can correspond setup on the portal to the JSON template. Also availability of features with apiVersion releases. I remember there being a MSDN documentation for the changelog with api version releases but cannot find it now.
If you create a VM with the desired settings, extensions etc then you can view their json template via https://resources.azure.com/
This will give some visibility into the Classic* templates.
All of the ARM templates can be found on GitHub here: https://github.com/Azure/azure-resource-manager-schemas.
It includes preview templates and should provide all the information you're after to determine which features are present in which apiVersion release.
Microsoft has finally created what I was looking for 🎉: full documentation is now available at https://learn.microsoft.com/en-au/azure/templates/
After some digging I managed to get the following list of schemas:
http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json
http://schema.management.azure.com/schemas/2014-06-01/Microsoft.Web.json
http://schema.management.azure.com/schemas/2014-04-01-preview/Microsoft.Sql.json
http://schema.management.azure.com/schemas/2014-04-01/Microsoft.Insights.json
http://schema.management.azure.com/schemas/2014-02-26/microsoft.visualstudio.json
http://schema.management.azure.com/schemas/2014-04-01-preview/Microsoft.Cache.json
http://schema.management.azure.com/schemas/2014-04-01/Microsoft.BizTalkServices.json
http://schema.management.azure.com/schemas/2014-08-01/Microsoft.Scheduler.json
http://schema.management.azure.com/schemas/2014-04-01/SuccessBricks.ClearDB.json
http://schema.management.azure.com/schemas/2015-01-01/Microsoft.Resources.json
http://schema.management.azure.com/schemas/2015-01-01/Microsoft.Authorization.json
http://schema.management.azure.com/schemas/2014-10-01-preview/Microsoft.Authorization.json
This list notably excludes:
Microsoft.ClassicCompute
Microsoft.ClassicStorage
Microsoft.ClassicNetwork
So I guess we're left to figure stuff out from the templates on those
To my mind we can dig that way:
open the azure-resource-manager schemas
Look at the main form below:
If you open properties, you will find the format that we need to fill:
open parameters and look at the structure:
$ref: #/definitions/parameter invite us to look at the same documents in definitions.parameters where you will find some documentation (like value you can use etc):
finally, if you look to properties.resources, you will find a list of url like:
{ "$ref": "http://schema.management.azure.com/schemas/2015-07-01-preview/Microsoft.ServerManagement.json#/resourceDefinitions/node" }
{ "$ref": "http://schema.management.azure.com/schemas/2015-07-01-preview/Microsoft.ServerManagement.json#/resourceDefinitions/gateway" }
if you open one of these url, you will find the JSON format you are looking for (here is a part of the first one):
There is not much available...
Azure Resource Manager Template Language
https://azure.microsoft.com/en-us/documentation/articles/resource-group-authoring-templates/
And then you can look at the different json.schemas that I have managed to find
deploymentTemplate
http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json
visualstudio
http://schema.management.azure.com/schemas/2014-02-26/microsoft.visualstudio.json
Sql
http://schema.management.azure.com/schemas/2014-06-01/2014-04-01-preview/Microsoft.Sql.json
Web
http://schema.management.azure.com/schemas/2014-06-01/Microsoft.Web.json
deploymentParameters
http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentParameters.json
If you use Visual Studio to edit the json-template file you get intellisense (sometimes) which help a bit. But the lack of documentation is really annoying...for example I have no clue if the schemas listed above are the most recent or not, and I have no idea where to find which one is the most resent.
Edit:
I came across the list of additions and changes to the Service Management APIs. Seems to be a bit outdated, 2015-01-01 is the current version and it's not there.
Edit2:
With the Iaas updates at Build 2015, there seems to also be a lot of Azure Quickstart Templates. At minimum, they have the particular cases I was looking for with storage accounts.
I am getting "Uncaught TypeError" while using Google Map API V3 Javascript Library. I am not able to find the function due to which this error is coming. Do we have a uncompressed Javascript library for Google MAP API. If not please provide your suggestion to debug it.
Thank you
Regards,
Dinesh
There is no uncompressed library. All the API methods are accessed according to the published documentation, so there doesn't need to be an uncompressed version. Follow the documentation and it will work.
To debug, use something like Firebug in Firefox. When it breaks on error, step back through the call stack until you reach your Javascript code. That will tell you what it's trying to execute.
It may be something as simple as providing a string value instead of a number.
As mentioned, there isn't a way to get the original version with real (helpful) variable and comments
But! There's a new(ish?) feature in Google Chrome Dev Tools where you can de-minify code ("make minified code human readable")
https://developers.google.com/web/tools/chrome-devtools/javascript/reference#format
should at least help a bit with debugging