hdmf-dev / hdmf-docutils

Collection of CLIs, scripts and modules useful to generate HDMF/NWB schema documentation
Other
0 stars 3 forks source link

TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family' #62

Closed rly closed 3 years ago

rly commented 3 years ago

When generating HDMF Common documentation, I get the following error:

  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'     

Networkx docs for draw_network_nodes() says that 'font_family' is not a keyword argument. https://networkx.org/documentation/stable/reference/generated/networkx.drawing.nx_pylab.draw_networkx_nodes.html

New in networkx 2.5, released on 22 August 2020, is that extra keywords are no longer accepted in draw_network_nodes().

As far as I can tell from the networkx 2.4 source code, the extra keywords were never used, so removing 'font_family' from the call to draw_network_nodes() should result in no change in behavior.

Full output:

(dev) λ make html                                                                                                 
Running Sphinx v3.5.4                                                                                             
making output directory... done                                                                                   
Removed old sources at: C:\Users\Ryan\Documents\NWB\hdmf-common-schema\docs\source\_format_auto_docs              
Generating output directory: C:\Users\Ryan\Documents\NWB\hdmf-common-schema\docs\source\_format_auto_docs         

SORTING TYPES INTO SECTIONS                                                                                       
---------------------------                                                                                       
Base data types                                                                                                   
    base data types                                                                                               
    ['Data', 'Container', 'SimpleMultiContainer']                                                                 
Table data types                                                                                                  
    data types for a column-based table                                                                           
    ['VectorData', 'VectorIndex', 'ElementIdentifiers', 'DynamicTableRegion', 'DynamicTable', 'AlignedDynamicTable
']                                                                                                                
Sparse data types                                                                                                 
    data types for different types of sparse matrices                                                             
    ['CSRMatrix']                                                                                                 
RENDERING TYPE HIERARCHY                                                                                          
------------------------                                                                                          
Container                                                                                                         
   CSRMatrix                                                                                                      
   DynamicTable                                                                                                   
      AlignedDynamicTable                                                                                         
   SimpleMultiContainer                                                                                           
Data                                                                                                              
   ElementIdentifiers                                                                                             
   VectorData                                                                                                     
      DynamicTableRegion                                                                                          
      VectorIndex                                                                                                 
RENDERING NAMESPACE SPECIFICATION                                                                                 
---------------------------------                                                                                 
    hdmf-common-- WRITE NAMESPACE DESCRIPTION DOC OK.                                                             
    hdmf-common-- WRITE NAMESPACE SOURCE DOC OK.                                                                  
RENDERING TYPE SPECIFICATIONS                                                                                     
------------------------------                                                                                    
BUILDING Data                                                                                                     
    Data-- SKIPPED RENDER HIERARCHY. TWO OR FEWER NODES.                                                          
    Data-- WRITE DESCRIPTION DOC OK.                                                                              
    Data-- WRITE SOURCE DOC OK.                                                                                   
BUILDING Container                                                                                                
    Container-- SKIPPED RENDER HIERARCHY. TWO OR FEWER NODES.                                                     
    Container-- WRITE DESCRIPTION DOC OK.                                                                         
    Container-- WRITE SOURCE DOC OK.                                                                              
BUILDING SimpleMultiContainer                                                                                     
SimpleMultiContainer-- RENDER HIERARCHY FAILED: Traceback (most recent call last):                                
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\generate_format_docs.py", line 268, in r
ender_data_type_section                                                                                           
    fig = temp_graph.draw(show_plot=False,     # noqa F841                                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 343, in draw  
    return self.draw_graph(graph=self.graph, pos=self.pos, data=self.data, **kwargs)                              
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'                                 

    SimpleMultiContainer-- WRITE DESCRIPTION DOC OK.                                                              
    SimpleMultiContainer-- WRITE SOURCE DOC OK.                                                                   
BUILDING VectorData                                                                                               
    VectorData-- SKIPPED RENDER HIERARCHY. TWO OR FEWER NODES.                                                    
    VectorData-- WRITE DESCRIPTION DOC OK.                                                                        
    VectorData-- WRITE SOURCE DOC OK.                                                                             
BUILDING VectorIndex                                                                                              
    VectorIndex-- SKIPPED RENDER HIERARCHY. TWO OR FEWER NODES.                                                   
    VectorIndex-- WRITE DESCRIPTION DOC OK.                                                                       
    VectorIndex-- WRITE SOURCE DOC OK.                                                                            
BUILDING ElementIdentifiers                                                                                       
    ElementIdentifiers-- SKIPPED RENDER HIERARCHY. TWO OR FEWER NODES.                                            
    ElementIdentifiers-- WRITE DESCRIPTION DOC OK.                                                                
    ElementIdentifiers-- WRITE SOURCE DOC OK.                                                                     
BUILDING DynamicTableRegion                                                                                       
DynamicTableRegion-- RENDER HIERARCHY FAILED: Traceback (most recent call last):                                  
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\generate_format_docs.py", line 268, in r
ender_data_type_section                                                                                           
    fig = temp_graph.draw(show_plot=False,     # noqa F841                                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 343, in draw  
    return self.draw_graph(graph=self.graph, pos=self.pos, data=self.data, **kwargs)                              
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'                                 

    DynamicTableRegion-- WRITE DESCRIPTION DOC OK.                                                                
    DynamicTableRegion-- WRITE SOURCE DOC OK.                                                                     
BUILDING DynamicTable                                                                                             
DynamicTable-- RENDER HIERARCHY FAILED: Traceback (most recent call last):                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\generate_format_docs.py", line 268, in r
ender_data_type_section                                                                                           
    fig = temp_graph.draw(show_plot=False,     # noqa F841                                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 343, in draw  
    return self.draw_graph(graph=self.graph, pos=self.pos, data=self.data, **kwargs)                              
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'                                 

    DynamicTable-- WRITE DESCRIPTION DOC OK.                                                                      
    DynamicTable-- WRITE SOURCE DOC OK.                                                                           
BUILDING AlignedDynamicTable                                                                                      
AlignedDynamicTable-- RENDER HIERARCHY FAILED: Traceback (most recent call last):                                 
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\generate_format_docs.py", line 268, in r
ender_data_type_section                                                                                           
    fig = temp_graph.draw(show_plot=False,     # noqa F841                                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 343, in draw  
    return self.draw_graph(graph=self.graph, pos=self.pos, data=self.data, **kwargs)                              
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'                                 

    AlignedDynamicTable-- WRITE DESCRIPTION DOC OK.                                                               
    AlignedDynamicTable-- WRITE SOURCE DOC OK.                                                                    
BUILDING CSRMatrix                                                                                                
CSRMatrix-- RENDER HIERARCHY FAILED: Traceback (most recent call last):                                           
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\generate_format_docs.py", line 268, in r
ender_data_type_section                                                                                           
    fig = temp_graph.draw(show_plot=False,     # noqa F841                                                        
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 343, in draw  
    return self.draw_graph(graph=self.graph, pos=self.pos, data=self.data, **kwargs)                              
  File "c:\users\ryan\miniconda3\envs\dev\lib\site-packages\hdmf_docutils\doctools\render.py", line 682, in draw_g
raph                                                                                                              
    nx.draw_networkx_nodes(graph, pos,                                                                            
TypeError: draw_networkx_nodes() got an unexpected keyword argument 'font_family'                                 

    CSRMatrix-- WRITE DESCRIPTION DOC OK.                                                                         
    CSRMatrix-- WRITE SOURCE DOC OK.                                                                              
Write C:\Users\Ryan\Documents\NWB\hdmf-common-schema\docs\source\_format_auto_docs\format_spec_doc.inc            
Write C:\Users\Ryan\Documents\NWB\hdmf-common-schema\docs\source\_format_auto_docs\format_spec_sources.inc        
Write C:\Users\Ryan\Documents\NWB\hdmf-common-schema\docs\source\_format_auto_docs\format_spec_main.inc           
building [mo]: targets for 0 po files that are out of date                                                        
building [html]: targets for 6 source files that are out of date                                                  
updating environment: [new config] 6 added, 0 changed, 0 removed                                                  
reading sources... [100%] software_process                                                                        
looking for now-outdated files... none found                                                                      
pickling environment... done                                                                                      
checking consistency... done                                                                                      
preparing documents... done                                                                                       
writing output... [100%] software_process                                                                         
generating indices... genindex done                                                                               
writing additional pages... search done                                                                           
copying images... [100%] figures/ragged-array.png                                                                 
copying static files... done                                                                                      
copying extra files... done                                                                                       
dumping search index in English (code: en)... done                                                                
dumping object inventory... done                                                                                  
build succeeded.                                                                                                  

The HTML pages are in _build\html.                                                                                

Build finished. The HTML pages are in _build/html.