Unexpected keyword 'source' in OpenAPIV3DocumentationHandler.__init__() #11

Activity

1. RobertoPrevato commented on May 17, 2022

   

   RobertoPrevato

   on May 17, 2022

   Member

   More actions

   Hi @StarfallProjects,
   Please upgrade the essentials-openapi dependency using pip install -U, as I described in the other issue I closed a few days ago:

   pip install -U neoteroi-mkdocs essentials-openapi

   I needed to pass the source to the function that generates documentation to support your scenario, to recreate the full path to files when you use relative file paths to separate the OAD into different files.

   I should have pinned the dependency in neoteroi-mkdocs but for now I preferred to always keep the latest version

   Please let me know if this helps. 🙂
2. StarfallProjects commented on May 18, 2022

   

   StarfallProjects

   on May 18, 2022

   Last edited by StarfallProjects

   Author

   More actions

   I still get the error after updating (fairly sure I updated last time as prompted, but ran the command again just now in case I'd missed it)

   essentials==1.1.5
   essentials-openapi==1.0.0
   neoteroi-mkdocs==0.0.5

   Ok so running the command doesn't get me 1.0.2, possibly that is the problem . . . brb poking pip
3. StarfallProjects commented on May 18, 2022

   

   StarfallProjects

   on May 18, 2022

   Last edited by StarfallProjects

   Author

   More actions

   Ok new error:

   Error reading page 'api\api-reference-3.md': 'NoneType' object has no attribute 'keys'
   Traceback (most recent call last):
     File "C:\Users\debor\AppData\Local\Programs\Python\Python310\lib\runpy.py", line 196, in _run_module_as_main
       return _run_code(code, main_globals, None,
     File "C:\Users\debor\AppData\Local\Programs\Python\Python310\lib\runpy.py", line 86, in _run_code    
       exec(code, run_globals)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\Scripts\mkdocs.exe\__main__.py", line 7, in <module> 
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\click\core.py", line 1128, in __call__
       return self.main(*args, **kwargs)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\click\core.py", line 1053, in main 
       rv = self.invoke(ctx)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\click\core.py", line 1659, in invoke
       return _process_result(sub_ctx.command.invoke(sub_ctx))
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\click\core.py", line 1395, in invoke
       return ctx.invoke(self.callback, **ctx.params)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\click\core.py", line 754, in invoke    return __callback(*args, **kwargs)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\__main__.py", line 181, in serve_command
       serve.serve(dev_addr=dev_addr, livereload=livereload, watch=watch, **kwargs)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\commands\serve.py", line 63, in serve
       config = builder()
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\commands\serve.py", line 58, in builder
       build(config, live_server=live_server, dirty=dirty)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\commands\build.py", line 292, in build
       _populate_page(file.page, config, files, dirty)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\commands\build.py", line 170, in _populate_page
       page.markdown = config['plugins'].run_event(
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\mkdocs\plugins.py", line 102, in run_event
       result = method(item, **kwargs)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\neoteroi\mkdocsoad\__init__.py", line 44, in on_page_markdown
       return self.rx.sub(self._replacer, markdown)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\neoteroi\mkdocsoad\__init__.py", line 34, in _replacer
       return handler.write()
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\__init__.py", line 417, in write
       return self._writer.write(
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\jinja.py", line 107, in write
       return template.render(data, **kwargs)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\jinja2\environment.py", line 1291, 
   in render
       self.environment.handle_exception()
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\jinja2\environment.py", line 925, in handle_exception
       raise rewrite_traceback_stack(source=source)
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\views_mkdocs\layout.html", line 14, in top-level template code
       {% include "partial/path-items.html" %}
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\views_mkdocs\partial\path-items.html", line 29, in top-level template code
       {%- include "partial/request-responses.html" %}
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\views_mkdocs\partial\request-responses.html", line 25, in top-level template code
       {% include "partial/content-examples.html" %}
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\views_mkdocs\partial\content-examples.html", line 1, in top-level template code
       {% for example in handler.get_content_examples(definition) %}
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\__init__.py", line 484, in get_content_examples
       example = self.generate_example_from_schema(data.get("schema"))
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\__init__.py", line 503, in generate_example_from_schema
       return get_example_from_schema(self.expand_references(schema))
     File "C:\Users\debor\Desktop\docs\n8n-docs\venv\lib\site-packages\openapidocs\mk\v3\__init__.py", line 541, in expand_references
       for key in list(clone.keys()):
   AttributeError: 'NoneType' object has no attribute 'keys'
   

   Attached my full requirements.txt
   requirements.txt