Public Member Functions
	__init__ (self, search_dir, out_dir)

	extract (self, file, contents)

	build (self)

Public Attributes
	search_dir

	out_dir

	all_sources

Detailed Description

A class used to build documentation for an ICP implementation.

...

Attributes
----------
search_dir : str
    The directory to search for source files.
out_dir : str
    The directory to write the output markdown files.
all_sources : set
    A set of all sources found in the source files.

Methods
-------
extract(file, contents):
    Extracts the documentation from the given file contents and writes it to a markdown file.
build():
    Searches for source files in the search directory and extracts their documentation.

Definition at line 10 of file icp_doc_builder.py.

Constructor & Destructor Documentation

◆ init()

icp_doc_builder.ICPDocumentationBuilder.__init__	(	self,
		search_dir,
		out_dir )

Constructs a new ICPDocumentationBuilder.

Parameters
----------
search_dir : str
    The directory to search for source files.
out_dir : str
    The directory to write the output markdown files.

Definition at line 33 of file icp_doc_builder.py.

Member Function Documentation

◆ build()

icp_doc_builder.ICPDocumentationBuilder.build ( self )

Searches for source files in the search directory and extracts their documentation.

Definition at line 109 of file icp_doc_builder.py.

◆ extract()

icp_doc_builder.ICPDocumentationBuilder.extract	(	self,
		file,
		contents )

Extracts the documentation from the given file contents and writes it to a markdown file.

Parameters
----------
file : str
    The name of the file to extract documentation from.
contents : str
    The contents of the file.

Definition at line 48 of file icp_doc_builder.py.

Member Data Documentation

◆ all_sources

icp_doc_builder.ICPDocumentationBuilder.all_sources

Definition at line 46 of file icp_doc_builder.py.

◆ out_dir

icp_doc_builder.ICPDocumentationBuilder.out_dir

Definition at line 45 of file icp_doc_builder.py.

◆ search_dir

icp_doc_builder.ICPDocumentationBuilder.search_dir

Definition at line 44 of file icp_doc_builder.py.

The documentation for this class was generated from the following file:

script/icp_doc_builder.py

Public Member Functions

Public Attributes