millironx/nfdocs-parser
1
0
Fork 0
mirror of https://github.com/MillironX/nfdocs-parser.git synced 2024-11-22 08:59:55 +00:00
Code Issues Releases Packages Activity

Promote main script to RST run function

Browse source 
Signed-off-by: Thomas A. Christensen II <25492070+MillironX@users.noreply.github.com>
This commit is contained in:
Thomas A. Christensen II 2022-01-05 16:43:44 -06:00
parent c09f664328
commit 5124acddc7
1 changed files with 66 additions and 63 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
nfdocs-parser.py
View file

@ -1,10 +1,12 @@
#!/usr/bin/env python #!/usr/bin/env python
import sys
import yaml import yaml
from docutils import nodes from docutils import nodes
from docutils.parsers.rst import Directive from docutils.parsers.rst import Directive
from docutils.parsers.rst import directives
class NFDocs(Directive): class NFDocs(Directive):
# Class default overrides
required_arguments = 1
# Declare the docstring starting characters # Declare the docstring starting characters
DOC_STARTER = "/// " DOC_STARTER = "/// "
@ -37,7 +39,7 @@ class NFDocs(Directive):
tuple_item += nodes.paragraph(text="Tuple:") tuple_item += nodes.paragraph(text="Tuple:")
tuple_list = nodes.bullet_list() tuple_list = nodes.bullet_list()
for io in params["tuple"]: for io in params["tuple"]:
tuple_list += params_to_list(io) tuple_list += self.params_to_list(io)
tuple_item += tuple_list tuple_item += tuple_list
return tuple_item return tuple_item
else: else:
@ -48,8 +50,9 @@ class NFDocs(Directive):
io_item += nodes.paragraph(text=params["description"]) io_item += nodes.paragraph(text=params["description"])
return io_item return io_item
def run(self):
# Take path as single argument for now # Take path as single argument for now
nextflow_path = sys.argv[1] nextflow_path = self.arguments[0]
with open(nextflow_path) as nextflow_file: with open(nextflow_path) as nextflow_file:
# Split by lines # Split by lines
@ -65,13 +68,13 @@ class NFDocs(Directive):
# Calculate the start and end positions of each docstring # Calculate the start and end positions of each docstring
for i, line in enumerate(nextflow_lines): for i, line in enumerate(nextflow_lines):
# Check if this is a docstring # Check if this is a docstring
if line.startswith(DOC_STARTER): if line.startswith(self.DOC_STARTER):
# It is: check the next and previous lines to see if this is part of a block # It is: check the next and previous lines to see if this is part of a block
line_previous = nextflow_lines[i-1] line_previous = nextflow_lines[i-1]
line_next = nextflow_lines[i+1] line_next = nextflow_lines[i+1]
if not line_previous.startswith(DOC_STARTER): if not line_previous.startswith(self.DOC_STARTER):
doc_start = i doc_start = i
if not line_next.startswith(DOC_STARTER): if not line_next.startswith(self.DOC_STARTER):
doc_end = i doc_end = i
# Check if we've reached the end of a docstring block # Check if we've reached the end of a docstring block
@ -88,10 +91,10 @@ class NFDocs(Directive):
# Parse out the docstrings and put them in the appropriate dictionary # Parse out the docstrings and put them in the appropriate dictionary
for pos in docstring_positions: for pos in docstring_positions:
proc_name, proc_type = definition_type(nextflow_lines[pos[-1]+1]) proc_name, proc_type = self.definition_type(nextflow_lines[pos[-1]+1])
doc_yaml = "" doc_yaml = ""
for i in pos: for i in pos:
doc_yaml = doc_yaml + nextflow_lines[i].replace(DOC_STARTER, "") doc_yaml = doc_yaml + nextflow_lines[i].replace(self.DOC_STARTER, "")
docstrings[proc_type][proc_name] = yaml.safe_load(doc_yaml) docstrings[proc_type][proc_name] = yaml.safe_load(doc_yaml)
# Create any array to return from the plugin # Create any array to return from the plugin
@ -112,11 +115,11 @@ class NFDocs(Directive):
io_section += nodes.title(text=met) io_section += nodes.title(text=met)
io_list = nodes.bullet_list() io_list = nodes.bullet_list()
for io in proc_docs[met]: for io in proc_docs[met]:
io_list += params_to_list(io) io_list += self.params_to_list(io)
io_section += io_list io_section += io_list
proc_section += io_section proc_section += io_section
block_section += proc_section block_section += proc_section
return_nodes.append(block_section) return_nodes.append(block_section)
print(return_nodes) return return_nodes