stanhope/

write_webmenu.rs

//! *Write a single HTML file that serves as a Web Menu for all processes in a Process Library*
//! 
//! The purpose of this module is to write a nice HTML file that lists useful information about all processes in a library. Carl Sagan: "If you want to make an apple pie from scratch, you must first invent the universe."
//! * What processes are in the library?
//! * What is the useful information?
//! 
//! All information from all processes in a Process Library (user's flat list of folders) is stored in the *Library* struct, which essentially houses a vector of [crate::read_ebml::Process] structs. This module defines the *Library* struct, creates one, and then reads it to create "useful" HTML.
//! 
//! The Library struct is public, but its associated fields are private. "Get" and "Set"/"Add" functions exist to safely read/write Library fields.
use crate::read_ebml::read_ebml;
use crate::read_ebml::Process;
use crate::write_ebml::get_process_folder_name;

use std::fs::File;
use std::path::{PathBuf,Path};
use std::fs::{self,OpenOptions,metadata};
use std::io::{self,Write};
use std::env;

//  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄         ▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄ 
// ▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░▌       ▐░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌
// ▐░█▀▀▀▀▀▀▀▀▀  ▀▀▀▀█░█▀▀▀▀ ▐░█▀▀▀▀▀▀▀█░▌▐░▌       ▐░▌▐░█▀▀▀▀▀▀▀▀▀  ▀▀▀▀█░█▀▀▀▀ 
// ▐░▌               ▐░▌     ▐░▌       ▐░▌▐░▌       ▐░▌▐░▌               ▐░▌     
// ▐░█▄▄▄▄▄▄▄▄▄      ▐░▌     ▐░█▄▄▄▄▄▄▄█░▌▐░▌       ▐░▌▐░▌               ▐░▌     
// ▐░░░░░░░░░░░▌     ▐░▌     ▐░░░░░░░░░░░▌▐░▌       ▐░▌▐░▌               ▐░▌     
//  ▀▀▀▀▀▀▀▀▀█░▌     ▐░▌     ▐░█▀▀▀▀█░█▀▀ ▐░▌       ▐░▌▐░▌               ▐░▌     
//           ▐░▌     ▐░▌     ▐░▌     ▐░▌  ▐░▌       ▐░▌▐░▌               ▐░▌     
//  ▄▄▄▄▄▄▄▄▄█░▌     ▐░▌     ▐░▌      ▐░▌ ▐░█▄▄▄▄▄▄▄█░▌▐░█▄▄▄▄▄▄▄▄▄      ▐░▌     
// ▐░░░░░░░░░░░▌     ▐░▌     ▐░▌       ▐░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌     ▐░▌     
//  ▀▀▀▀▀▀▀▀▀▀▀       ▀       ▀         ▀  ▀▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀▀       ▀      
                                                                              
/// **Top-level struct containing all information read from an entire Process Library**
/// 
/// All fields are private, but are accessible with "get" functions, e.g. Library.get_name() returns a reference to the Library's name (&String).
pub struct Library {

	/// The name of the process library, e.g. "Process Library"
	name: String,

	/// A vector of [crate::read_ebml::Process] structs, each containing all information about its associated EBML file.
	all_processes: Vec<Process>,
}

//  ▄▄▄▄▄▄▄▄▄▄▄  ▄         ▄  ▄▄        ▄  ▄▄▄▄▄▄▄▄▄▄▄ 
// ▐░░░░░░░░░░░▌▐░▌       ▐░▌▐░░▌      ▐░▌▐░░░░░░░░░░░▌
// ▐░█▀▀▀▀▀▀▀▀▀ ▐░▌       ▐░▌▐░▌░▌     ▐░▌▐░█▀▀▀▀▀▀▀▀▀ 
// ▐░▌          ▐░▌       ▐░▌▐░▌▐░▌    ▐░▌▐░▌          
// ▐░█▄▄▄▄▄▄▄▄▄ ▐░▌       ▐░▌▐░▌ ▐░▌   ▐░▌▐░▌          
// ▐░░░░░░░░░░░▌▐░▌       ▐░▌▐░▌  ▐░▌  ▐░▌▐░▌          
// ▐░█▀▀▀▀▀▀▀▀▀ ▐░▌       ▐░▌▐░▌   ▐░▌ ▐░▌▐░▌          
// ▐░▌          ▐░▌       ▐░▌▐░▌    ▐░▌▐░▌▐░▌          
// ▐░▌          ▐░█▄▄▄▄▄▄▄█░▌▐░▌     ▐░▐░▌▐░█▄▄▄▄▄▄▄▄▄ 
// ▐░▌          ▐░░░░░░░░░░░▌▐░▌      ▐░░▌▐░░░░░░░░░░░▌
//  ▀            ▀▀▀▀▀▀▀▀▀▀▀  ▀        ▀▀  ▀▀▀▀▀▀▀▀▀▀▀ 

// <!-- Modified from: https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&gist=0e9857bd7f29eab065dfe52313f98af7

/// Helper function that looks at the name of every directory that shares a parent with the stanhope application binary.
/// 
/// This function calls itself recursively, adding elements to the input "vec" if they are folders (directories), and the name of the folder isn't "assets"
fn _list_files(vec: &mut Vec<PathBuf>, path: &Path) -> io::Result<()> {
    if metadata(&path)?.is_dir() {
        let paths = fs::read_dir(&path)?;
        for path_result in paths {
            let full_path = path_result?.path();
            if metadata(&full_path)?.is_dir() {
            	let path_str = &full_path.as_os_str();
            	let len = path_str.len();
                match len {
                	8 => {
                		match path_str.to_str() {
                			Some("./assets") => (),
                			Some(".\\assets") => (),
                			_ => vec.push(full_path),
                		}
                	}
                	_ => vec.push(full_path),
                };
            } 
        }
    }
    Ok(())
}

/// Wrapper function that calls the recursive helper to get the list of non-"assets" folders that exist next to the stanhope binary.
fn list_files(path: &Path) -> io::Result<Vec<PathBuf>> {
    let mut vec = Vec::new();
    _list_files(&mut vec,&path)?;
    Ok(vec)
}

// -->

/// Returns the name of the library, which... we define as the folder name of the directory that contains the stanhope binary and all process folders.
fn find_name_of_library() -> String {
	let exe = env::current_exe().expect("Naw1");
	exe.parent().expect("NawX").file_name().expect("Naw1").to_str().expect("Naw2").to_string()
}

/// Wrapper function that calls the wrapper function.
fn find_all_process_folders(dir:&str) -> Vec<PathBuf> {
    list_files(Path::new(dir)).expect("that's not a good path?")
}

/// The only public function, because the only purpose of this module is to write an HTML file!
/// 
/// Many "compose" functions are called to somewhat modularize and break up the really ugly autocoding here. This one might be even worse than [crate::write_html::generate_complete_html]!
/// 
/// No input arguments are supplied, because the location and filename of the Web Menu HTML file are assumed a priori:
/// * location is the Process Library root (next to stanhope binary)
/// * filename is "WebMenu.html"
pub fn generate_complete_webmenu(verbose:&bool) {

	// Open the filename input to write HTML out to that file
	if *verbose { print!("\n[A] Attempting to edit WebMenu.html..."); }
    let mut html_file = OpenOptions::new()
        .read(true)
        .write(true)
        .create(true)
        .truncate(true)
        .open("./WebMenu.html")
        .expect("cannot open file");
    if *verbose { print!("success! WebMenu.html is open for editing.\n"); }

    if *verbose { print!("[B] Attempting to create new Library struct..."); }
    let mut new_library = Library::new();
    if *verbose { print!("success! New Library struct created.\n"); }

    if *verbose { print!("[C] Attempting to change the name of the Library to this folder's name...")}
    new_library.set_name(&find_name_of_library().as_str());
    if *verbose { print!("success! New name: {}\n",new_library.get_name()); }

    if *verbose { print!("[D] Attempting list of all folders (excluding 'assets')..."); }
    let list_of_process_folders = find_all_process_folders(".");
    if *verbose { for folder in &list_of_process_folders { println!("{}",folder.file_name().expect("No bueno?").to_str().expect("Really bueno?").to_string());} }
    if *verbose { print!("success! Folders found, now look for files to process:\n"); }
    for folder in list_of_process_folders {
    	let folder_string = folder.file_name().expect("No bueno?").to_str().expect("Really bueno?").to_string();
    	if *verbose { print!("\t{}",&folder_string); }
    	let new_ebml_str = folder_string.clone() + "/" + &folder_string + ".ebml";
    	if *verbose { print!("\n\t\t-> {}",&new_ebml_str); }
    	let new_process = read_ebml(&("./".to_owned()+&new_ebml_str));
    	if *verbose { print!("\n\t\t-> processed "); }
    	new_library.add_process(new_process);
    	if *verbose { print!("\n\t\t-> added to Library\n"); }
    }

    if *verbose { print!("[E] Attempting to write the top of the HTML file..."); }
    compose_top_of_webmenu(&mut html_file);
    if *verbose { print!("success!\n"); }

    if *verbose { print!("[F] Attempting to write the head of the HTML file, including all CSS and Javascript..."); }
    compose_head_of_webmenu(&mut html_file,&new_library);
    if *verbose { print!("success!\n"); }

    if *verbose { print!("[G] Attempting to write the body of the HTML file, including everything that appears on screen..."); }
	compose_body_of_webmenu(&mut html_file,&new_library);
    if *verbose { print!("success!\n"); }


	if *verbose { print!("[H] Attempting to write the bottom of the HTML file..."); }
	compose_bottom_of_webmenu(&mut html_file);
    if *verbose { print!("success!\n"); }

    if *verbose { print!("\n\n"); new_library.display(); print!("\n\n"); }
}

/// Simple: doctype declaration and opening of the HTML tag.
fn compose_top_of_webmenu(f:&mut File) {
	f.write(b"<!DOCTYPE html>\n").expect("write failed");
	f.write(b"<html lang=\"en-US\">\n").expect("write failed");
}

/// All "head" metadata, including:
/// * embedded CSS, because this file is going to (almost) stand alone
/// * embedded JavaScript to sort tables, because we don't want this to depend on the internet, or break if external files move
/// 
/// Note: some needed images referenced here and in the body are in the "assets" folder...
fn compose_head_of_webmenu(f:&mut File, lib:&Library) {
	f.write(b"\t<head>\n").expect("write failed");
	f.write(b"\t\t<meta charset=\"utf-8\" />\n").expect("write failed");
	f.write(b"\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1, user-scalable=1\" />\n").expect("write failed");
	f.write(b"\t\t<style>\n").expect("write failed");
	f.write(b"\t\t\t
			@media print { .no-print, .no-print * { display: none !important; }  br { display:none !important; } table { font-size: 0.5em; } }
			body { font-family: sans-serif; padding: 0px; margin: 0px;}
			#pre-header { padding: 15px; border: 15px solid #BA6F47; background-color: #BEA465; color: #2F495A; text-align: center; font-size: 0.7em; }
			header { z-index: 100; border-bottom: 3px solid black; background-color: #2F495A; color: white; position: sticky; top:0px;}
			header, main { padding: 20px; margin:0px;}
			table { margin-top: 20px; }

			input + span { margin: 0px 5px 0px 5px; }

			.doc-box { display:inline-block; padding: 1px; border: 1px solid black; margin: 2px; width: 25px; }
			.doc-icon { width: 25px; height: 25px; overflow: hidden; position: relative; }
			.doc-format img { position: absolute; height: 25px; left: 0px; }

			input { z-index: 0; margin: 0px 5px 0px 5px; transform: scale(1.3);}

			.doc-box { display:inline-block; padding: 1px; border: 1px solid black; margin: 2px; width: 25px; }
			.doc-icon { width: 25px; height: 25px; overflow: hidden; position: relative; }
			.doc-format img { position: absolute; height: 25px; left: 0px; }

			.toggle-column-01:not(:checked) ~ table th:nth-child(1) { display: none; }
			.toggle-column-01:not(:checked) ~ table td:nth-child(1) { display: none; }

			.toggle-column-02:not(:checked) ~ table th:nth-child(2) { display: none; }
			.toggle-column-02:not(:checked) ~ table td:nth-child(2) { display: none; }

			.toggle-column-03:not(:checked) ~ table th:nth-child(3) { display: none; }
			.toggle-column-03:not(:checked) ~ table td:nth-child(3) { display: none; }

			.toggle-column-04:not(:checked) ~ table th:nth-child(4) { display: none; }
			.toggle-column-04:not(:checked) ~ table td:nth-child(4) { display: none; }

			.toggle-column-05:not(:checked) ~ table th:nth-child(5) { display: none; }
			.toggle-column-05:not(:checked) ~ table td:nth-child(5) { display: none; }

			.toggle-column-06:not(:checked) ~ table th:nth-child(6) { display: none; }
			.toggle-column-06:not(:checked) ~ table td:nth-child(6) { display: none; }

			.toggle-column-07:not(:checked) ~ table th:nth-child(7) { display: none; }
			.toggle-column-07:not(:checked) ~ table td:nth-child(7) { display: none; }

			.toggle-column-08:not(:checked) ~ table th:nth-child(8) { display: none; }
			.toggle-column-08:not(:checked) ~ table td:nth-child(8) { display: none; }

			.toggle-column-09:not(:checked) ~ table th:nth-child(9) { display: none; }
			.toggle-column-09:not(:checked) ~ table td:nth-child(9) { display: none; }

			.toggle-column-10:not(:checked) ~ table th:nth-child(10) { display: none; }
			.toggle-column-10:not(:checked) ~ table td:nth-child(10) { display: none; }

			.toggle-column-11:not(:checked) ~ table th:nth-child(11) { display: none; }
			.toggle-column-11:not(:checked) ~ table td:nth-child(11) { display: none; }

			.toggle-column-12:not(:checked) ~ table th:nth-child(12) { display: none; }
			.toggle-column-12:not(:checked) ~ table td:nth-child(12) { display: none; }

			.toggle-column-13:not(:checked) ~ table th:nth-child(13) { display: none; }
			.toggle-column-13:not(:checked) ~ table td:nth-child(13) { display: none; }

			.toggle-column-14:not(:checked) ~ table th:nth-child(14) { display: none; }
			.toggle-column-14:not(:checked) ~ table td:nth-child(14) { display: none; }

			.toggle-column-15:not(:checked) ~ table th:nth-child(15) { display: none; }
			.toggle-column-15:not(:checked) ~ table td:nth-child(15) { display: none; }

			.toggle-column-16:not(:checked) ~ table th:nth-child(16) { display: none; }
			.toggle-column-16:not(:checked) ~ table td:nth-child(16) { display: none; }
	\n").expect("write failed");
	f.write(b"\t\t\ttable { border-collapse: collapse; }
	\t\tth, td { padding: 0.4em; border: 1px solid black;}
	\t\tth { background-color: black; color: white; }
	\t\tth[role=columnheader]:not(.no-sort) { cursor: pointer; }
	\t\tth[role=columnheader]:not(.no-sort):after {
	\t\t	content: '';
	\t\t	float: right;
	\t\t	margin-top: 7px;
	\t\t  	margin-left: 5px;
	\t\t	border-width: 0 4px 4px;
	\t\t	border-style: solid;
	\t\t	border-color: white transparent;
	\t\t	visibility: hidden;
	\t\t	opacity: 0;
	\t\t	-ms-user-select: none;
	\t\t	-webkit-user-select: none;
	\t\t	-moz-user-select: none;
	\t\t	user-select: none;
	\t\t}
	\t\tth[aria-sort=ascending]:not(.no-sort):after { border-bottom: none; border-width: 4px 4px 0; }
	\t\tth[aria-sort]:not(.no-sort):after {	visibility: visible; opacity: 0.4; }
	\t\tth[role=columnheader]:not(.no-sort):hover:after { visibility: visible; opacity: 1; }\n").expect("write failed");
	f.write(b"\t\t</style>\n").expect("write failed");
	
	// This is the actual sorting javascript
	f.write(b"\t\t<script>\n").expect("write failed");
	f.write(b"\t\t\t!function(){function a(b,c){if(!(this instanceof a))return new a(b,c);if(!b||\"TABLE\"!==b.tagName)throw new Error(\"Element must be a table\");this.init(b,c||{})}var b=[],c=function(a){var b;return window.CustomEvent&&\"function\"==typeof window.CustomEvent?b=new CustomEvent(a):(b=document.createEvent(\"CustomEvent\"),b.initCustomEvent(a,!1,!1,void 0)),b},d=function(a){return a.getAttribute(\"data-sort\")||a.textContent||a.innerText||\"\"},e=function(a,b){return a=a.trim().toLowerCase(),b=b.trim().toLowerCase(),a===b?0:a<b?1:-1},f=function(a,b){return function(c,d){var e=a(c.td,d.td);return 0===e?b?d.index-c.index:c.index-d.index:e}};a.extend=function(a,c,d){if(\"function\"!=typeof c||\"function\"!=typeof d)throw new Error(\"Pattern and sort must be a function\");b.push({name:a,pattern:c,sort:d})},a.prototype={init:function(a,b){var c,d,e,f,g=this;if(g.table=a,g.thead=!1,g.options=b,a.rows&&a.rows.length>0)if(a.tHead&&a.tHead.rows.length>0){for(e=0;e<a.tHead.rows.length;e++)if(\"thead\"===a.tHead.rows[e].getAttribute(\"data-sort-method\")){c=a.tHead.rows[e];break}c||(c=a.tHead.rows[a.tHead.rows.length-1]),g.thead=!0}else c=a.rows[0];if(c){var h=function(){g.current&&g.current!==this&&g.current.removeAttribute(\"aria-sort\"),g.current=this,g.sortTable(this)};for(e=0;e<c.cells.length;e++)f=c.cells[e],f.setAttribute(\"role\",\"columnheader\"),\"none\"!==f.getAttribute(\"data-sort-method\")&&(f.tabindex=0,f.addEventListener(\"click\",h,!1),null!==f.getAttribute(\"data-sort-default\")&&(d=f));d&&(g.current=d,g.sortTable(d))}},sortTable:function(a,g){var h=this,i=a.cellIndex,j=e,k=\"\",l=[],m=h.thead?0:1,n=a.getAttribute(\"data-sort-method\"),o=a.getAttribute(\"aria-sort\");if(h.table.dispatchEvent(c(\"beforeSort\")),g||(o=\"ascending\"===o?\"descending\":\"descending\"===o?\"ascending\":h.options.descending?\"descending\":\"ascending\",a.setAttribute(\"aria-sort\",o)),!(h.table.rows.length<2)){if(!n){for(;l.length<3&&m<h.table.tBodies[0].rows.length;)k=d(h.table.tBodies[0].rows[m].cells[i]),k=k.trim(),k.length>0&&l.push(k),m++;if(!l)return}for(m=0;m<b.length;m++)if(k=b[m],n){if(k.name===n){j=k.sort;break}}else if(l.every(k.pattern)){j=k.sort;break}for(h.col=i,m=0;m<h.table.tBodies.length;m++){var p,q=[],r={},s=0,t=0;if(!(h.table.tBodies[m].rows.length<2)){for(p=0;p<h.table.tBodies[m].rows.length;p++)k=h.table.tBodies[m].rows[p],\"none\"===k.getAttribute(\"data-sort-method\")?r[s]=k:q.push({tr:k,td:d(k.cells[h.col]),index:s}),s++;for(\"descending\"===o?q.sort(f(j,!0)):(q.sort(f(j,!1)),q.reverse()),p=0;p<s;p++)r[p]?(k=r[p],t++):k=q[p-t].tr,h.table.tBodies[m].appendChild(k)}}h.table.dispatchEvent(c(\"afterSort\"))}},refresh:function(){void 0!==this.current&&this.sortTable(this.current,!0)}},\"undefined\"!=typeof module&&module.exports?module.exports=a:window.Tablesort=a}();\n").expect("write failed");
	f.write(b"\t\t</script>\n").expect("write failed");

	// This puts the sort function where it needs to go
	f.write(b"\t\t<script>\n").expect("write failed");
	f.write(b"\t\t\tfunction onPageReady() {\n").expect("write failed");
	f.write(b"\t\t\t\tnew Tablesort(document.getElementById('library'));\n").expect("write failed");
	f.write(b"\t\t\t}\n").expect("write failed");
	f.write(b"\t\t\tdocument.addEventListener('DOMContentLoaded', onPageReady, false);\n").expect("write failed");
	f.write(b"\t\t</script>\n").expect("write failed");

	f.write(b"\t\t<link rel=\"shortcut icon\" sizes=\"16x16 32x32 48x48\" type=\"image/png\" href=\"./assets/favicon.png\" />\n").expect("write failed");
	f.write(b"\t\t<link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"./assets/favicon.png\" />\n").expect("write failed");
	f.write(b"\t\t<link rel=\"mask-icon\" href=\"./assets/favicon.svg\" color=\"#000000\" />\n").expect("write failed");
	let temp_str = String::from("\t\t<title>&#x1F4DA; ") + &lib.get_name() + " &#x1F4DA;</title>\n";
    f.write(temp_str.as_bytes()).expect("write failed");
	f.write(b"\t</head>\n").expect("write failed");
}

/// The entire composition of the body contents you see on screen, broken up into
/// * header
/// * table, which actually includes non-table stuff... like the checkboxes and text above the table
/// * footer, which doesn't actually exist
fn compose_body_of_webmenu(f:&mut File, lib:&Library) {
	f.write(b"\t<body>\n").expect("write failed");
	compose_body_header(f,lib);
	compose_body_table(f,lib);
	compose_body_footer(f,lib);
	f.write(b"\t</body>\n").expect("write failed");
}

/// The header tag on this page is preceded by a scroll-by advertisement; the header itself is sticky.
fn compose_body_header(f:&mut File, lib:&Library) {
	f.write(b"\t\t<div id=\"pre-header\" class=\"no-print\"><h1>Contact Strativus Group for help of any kind! For example:</h1><h2>&#128218; Help with your Process Library &#128218;</h2><h2>&#128202; Help with Project Management &#128202;</h2><h2>&#128101; Help with People-Focused Leadership &#128101;</h2><h2><span style=\"background-color: #2F495A; color: #BEA465; padding: 10px;\">contact@strativusgroup.com</span></h2></div>\n").expect("write failed");
	f.write(b"\t\t<header>\n").expect("write failed");
	let temp_str = String::from("\t\t\t<h1>") + &lib.get_name() + "</h1>\n";
    f.write(temp_str.as_bytes()).expect("write failed");
	let temp_str = String::from("\t\t\t<p>Process Library with ") + &lib.get_all_processes().len().to_string() + " processes.</p>\n";
    f.write(temp_str.as_bytes()).expect("write failed");
	f.write(b"\t\t</header>\n").expect("write failed");
}

/// Compose the actual functional purpose of this module: make a useful table that has information about every process in a library.
/// 
/// 16 columns in the table use CSS to display or not, but all are written in at stanhope execution time, not browser render time.
fn compose_body_table(f:&mut File, lib:&Library) {
	f.write(b"\t\t<main>\n").expect("write failed");
	f.write(b"\t\t\t<h2 class=\"no-print\">Process metadata columns to show in the table below:</h2>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-01 no-print\" type=\"checkbox\" checked><span class=\"no-print\">Links</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-02 no-print\" type=\"checkbox\" checked><span class=\"no-print\">Document Number</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-03 no-print\" type=\"checkbox\" checked><span class=\"no-print\">Current Revision</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-04 no-print\" type=\"checkbox\" checked><span class=\"no-print\">Title</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-05 no-print\" type=\"checkbox\" ><span class=\"no-print\">Subject</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-06 no-print\" type=\"checkbox\" ><span class=\"no-print\">Author</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-07 no-print\" type=\"checkbox\" ><span class=\"no-print\">Reviewer</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-08 no-print\" type=\"checkbox\" ><span class=\"no-print\">Number of Objectives</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-09 no-print\" type=\"checkbox\" ><span class=\"no-print\">List of Objectives</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-10 no-print\" type=\"checkbox\" ><span class=\"no-print\">Number of Out of Scope Declarations</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-11 no-print\" type=\"checkbox\" ><span class=\"no-print\">List of Out of Scope Declarations</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-12 no-print\" type=\"checkbox\" ><span class=\"no-print\">Number of Requirement Verifications</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-13 no-print\" type=\"checkbox\" ><span class=\"no-print\">List of Requirement Verifications</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-14 no-print\" type=\"checkbox\" ><span class=\"no-print\">Number of Resources</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-15 no-print\" type=\"checkbox\" ><span class=\"no-print\">List of Resources</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<input class=\"toggle-column-16 no-print\" type=\"checkbox\" ><span class=\"no-print\">Number of Command Lines</span><br/>\n").expect("write failed");
	f.write(b"\t\t\t<h2 class=\"no-print\">Click on any column header to sort ascending/descending.</h2>\n").expect("write failed");
	
	f.write(b"\t\t\t<table id=\"library\">\n").expect("write failed");
	f.write(b"\t\t\t\t<thead>\n").expect("write failed");
	f.write(b"\t\t\t\t\t<tr data-sort-method=\"none\">\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col01 no-print\">Links</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col02\">Number</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col03\">Rev</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col04\">Title</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col05\">Subject</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col06\">Author</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col07\">Reviewer</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col08\">Obj</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col09\">List of Objectives</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col10\">OoS</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col11\">Out of Scope Declarations</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col12\">Ver</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col13\">List of Requirement Verifications</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col14\">Res</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col15\">List of Resources</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t\t<th class=\"col16\">Cmd</th>\n").expect("write failed");
	f.write(b"\t\t\t\t\t</tr>\n").expect("write failed");
	f.write(b"\t\t\t\t</thead>\n").expect("write failed");
	f.write(b"\t\t\t\t<tbody>\n").expect("write failed");
	for proc in lib.get_all_processes() {
		f.write(b"\t\t\t\t\t<tr>\n").expect("write failed");

		// <div class="doc-box" style="background-color: #DDD;"><div class="doc-icon"><div class="wi-format"><img src="./assets/html.png"/></div></div></div>
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col01 no-print\">
							<a href=\"") + &get_process_folder_name(&proc) + "/" + &get_process_folder_name(&proc) + ".ebml\"><div class=\"doc-box\" style=\"background-color: #DDD;\"><div class=\"doc-icon\"><div class=\"doc-format\"><img src=\"./assets/EBML.png\" alt=\"EBML\"/></div></div></div></a>
							<a href=\"" + &get_process_folder_name(&proc) + "/" + &get_process_folder_name(&proc) + ".html\"><div class=\"doc-box\" style=\"background-color: #DDD;\"><div class=\"doc-icon\"><div class=\"doc-format\"><img src=\"./assets/html.png\" alt=\"HTML\"/></div></div></div></a>
							<a href=\"" + &get_process_folder_name(&proc) + "/" + &get_process_folder_name(&proc) + ".pdf\"><div class=\"doc-box\" style=\"background-color: #DDD;\"><div class=\"doc-icon\"><div class=\"doc-format\"><img src=\"./assets/pdf.png\" alt=\"PDF\"/></div></div></div></a>
						</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");

		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col02\">") + proc.get_number() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col03\">") + proc.get_revision() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col04\">") + proc.get_title() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col05\">") + proc.get_subject() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col06\">") + proc.get_author() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col07\">") + proc.get_reviewer() + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col08\">") + &format!("{:03}",&proc.get_all_objectives().len()) + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col09\"><ul>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
    	let all_objectives = proc.get_all_objectives();
    	if all_objectives.len() > 0 {
    		for objective in all_objectives {
    			let temp_str = String::from("\t\t\t\t\t\t\t<li>") + &objective.0 + "</li>\n";
    			f.write(temp_str.as_bytes()).expect("write failed");		
    		}
    	}
    	let temp_str = String::from("\t\t\t\t\t\t</ul></td>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col10\">") + &format!("{:03}",&proc.get_all_out_of_scopes().len()) + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col11\"><ul>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
    	let all_out_of_scopes = proc.get_all_out_of_scopes();
    	if all_out_of_scopes.len() > 0 {
    		for out_of_scope in all_out_of_scopes {
    			let temp_str = String::from("\t\t\t\t\t\t\t<li>") + &out_of_scope.0 + "</li>\n";
    			f.write(temp_str.as_bytes()).expect("write failed");		
    		}
    	}
    	let temp_str = String::from("\t\t\t\t\t\t</ul></td>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");

    	let temp_str = String::from("\t\t\t\t\t\t<td class=\"col12\">") + &format!("{:03}",&proc.get_all_verifications().len()) + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col13\"><ul>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
    	let all_verifications = proc.get_all_verifications();
    	if all_verifications.len() > 0 {
    		for verification in all_verifications {
    			let temp_str = String::from("\t\t\t\t\t\t\t<li>") + &verification.0.get_id() + " (" + &((verification.0.get_method()).chars().nth(0).expect("How does this work?").to_string()) + ")</li>\n";
    			f.write(temp_str.as_bytes()).expect("write failed");
    		}
    	}
    	let temp_str = String::from("\t\t\t\t\t\t</ul></td>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col14\">") + &format!("{:03}",&proc.get_all_resources().len()) + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");
		
		let temp_str = String::from("\t\t\t\t\t\t<td class=\"col15\"><ul>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");
    	let all_resources = proc.get_all_resources();
    	if all_resources.len() > 0 {
    		for resource in all_resources {
    			let temp_str = String::from("\t\t\t\t\t\t\t<li>") + &resource.0.get_name() + "</li>\n";
    			f.write(temp_str.as_bytes()).expect("write failed");		
    		}
    	}
    	let temp_str = String::from("\t\t\t\t\t\t</ul></td>\n");
    	f.write(temp_str.as_bytes()).expect("write failed");

    	let temp_str = String::from("\t\t\t\t\t\t<td class=\"col16\">") + &format!("{:03}",&proc.get_all_command_lines().len()) + "</td>\n";
    	f.write(temp_str.as_bytes()).expect("write failed");

    	f.write(b"\t\t\t\t\t</tr>\n").expect("write failed");

	}
	f.write(b"\t\t\t\t</tbody>\n").expect("write failed");
	f.write(b"\t\t\t</table>\n").expect("write failed");
	f.write(b"\t\t</main>\n").expect("write failed");
}

/// TODO: currently empty
fn compose_body_footer(_f:&mut File, _lib:&Library) {}

/// Simply close out the HTML tag.
fn compose_bottom_of_webmenu(f:&mut File) {
	f.write(b"</html>\n").expect("write failed");
}

//  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄       ▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄           
// ▐░░░░░░░░░░░▌▐░░▌     ▐░░▌▐░░░░░░░░░░░▌▐░▌          
//  ▀▀▀▀█░█▀▀▀▀ ▐░▌░▌   ▐░▐░▌▐░█▀▀▀▀▀▀▀█░▌▐░▌          
//      ▐░▌     ▐░▌▐░▌ ▐░▌▐░▌▐░▌       ▐░▌▐░▌          
//      ▐░▌     ▐░▌ ▐░▐░▌ ▐░▌▐░█▄▄▄▄▄▄▄█░▌▐░▌          
//      ▐░▌     ▐░▌  ▐░▌  ▐░▌▐░░░░░░░░░░░▌▐░▌          
//      ▐░▌     ▐░▌   ▀   ▐░▌▐░█▀▀▀▀▀▀▀▀▀ ▐░▌          
//      ▐░▌     ▐░▌       ▐░▌▐░▌          ▐░▌          
//  ▄▄▄▄█░█▄▄▄▄ ▐░▌       ▐░▌▐░▌          ▐░█▄▄▄▄▄▄▄▄▄ 
// ▐░░░░░░░░░░░▌▐░▌       ▐░▌▐░▌          ▐░░░░░░░░░░░▌
//  ▀▀▀▀▀▀▀▀▀▀▀  ▀         ▀  ▀            ▀▀▀▀▀▀▀▀▀▀▀ 

/// Since all fields are private, "get" and "set"/"add" functions safely read and write a Library struct
impl Library {

	/// Instantiate a new Library struct, with empty name and Process vec
	pub fn new() -> Library {
		Library { 
			name: "".to_string(),
			all_processes: vec![],
		}
	}

	/// Return the contents of the "name" field
	pub fn get_name(&self) -> &String { &self.name }
	/// Return the contents of the "all_processes" field
	pub fn get_all_processes(&self) -> &Vec<Process> { &self.all_processes }

	/// Change the name of the "name" field
	pub fn set_name(&mut self, lib_name: &str) {
		self.name = String::from(lib_name.trim());
	}

	/// push a new [crate::read_ebml::Process] to the all_processes vector
	pub fn add_process(&mut self, process: Process) {
		self.all_processes.push(process);
	}

	/// Write to stdout a multi-line visual of the contents of a Library. This is mostly for debugging, because the HTML itself is supposed to be the nice output of even more information.
	pub fn display(&self) {
		let name = self.get_name();
		let all_processes = self.get_all_processes();
		println!("XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX");
		println!("XX LIBRARY VISUALIZER          XX");
		println!("XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX");
		println!(" -> Name:       {}",name);
		println!(" -> Processes:");
		for proc in all_processes {
			println!("    -> {}",proc.get_number());
		}
	}
}

//  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄▄▄ 
// ▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌
//  ▀▀▀▀█░█▀▀▀▀ ▐░█▀▀▀▀▀▀▀▀▀ ▐░█▀▀▀▀▀▀▀▀▀  ▀▀▀▀█░█▀▀▀▀ 
//      ▐░▌     ▐░▌          ▐░▌               ▐░▌     
//      ▐░▌     ▐░█▄▄▄▄▄▄▄▄▄ ▐░█▄▄▄▄▄▄▄▄▄      ▐░▌     
//      ▐░▌     ▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌     ▐░▌     
//      ▐░▌     ▐░█▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀█░▌     ▐░▌     
//      ▐░▌     ▐░▌                    ▐░▌     ▐░▌     
//      ▐░▌     ▐░█▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄█░▌     ▐░▌     
//      ▐░▌     ▐░░░░░░░░░░░▌▐░░░░░░░░░░░▌     ▐░▌     
//       ▀       ▀▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀▀       ▀      

#[cfg(test)]
mod tests {
    // Note this useful idiom: importing names from outer (for mod tests) scope.
	use super::*;
	//use std::fs;

	/*
	#[test]
	fn test_find_all_process_folders() {
		// I don't know how the test compiler works, where it works, how many folders are in the working directory... so if this runs it runs...
		let test_dir = "test_dir";
		let _ = fs::create_dir(&test_dir);
		let all_process_folders = find_all_process_folders(".");
		//assert_eq!(all_process_folders.len(),1);
		//assert_eq!(all_process_folders[0].clone().into_os_string().into_string().unwrap(),test_dir.to_string());
		let mut cnt = -1;
		for process_folder in all_process_folders.iter() {
			cnt += 1;
			println!("all_process_folders[{}] -> {}",cnt,process_folder.clone().into_os_string().into_string().unwrap());
		}
		println!("test_dir               -> {}",&test_dir.to_string());
		let _ = fs::remove_dir(&test_dir);
	}
	*/

	#[test]
	fn test_find_name_of_library() {
		println!("result of find_name_of_library() -> {}",find_name_of_library());	
	}

	/*
	#[test]
	fn test_list_files() {
		// I don't know how the test compiler works, where it works, how many folders are in the working directory... so if this runs it runs...
		let path = Path::new(".");
		let less_one = list_files(&path).expect("Naw").len();

		let test_dir = "test_dir";
		let _ = fs::create_dir(&test_dir);

		assert!(less_one < list_files(&path).expect("Naw").len());

		let _ = fs::remove_dir(&test_dir);

		let again = list_files(&path).expect("Naw").len();
		assert_eq!(less_one,again);
	}
	*/

	#[test]
	fn test_library_new() {
		Library::new();
	}

	#[test]
    fn test_library_get_functions() {
		
		let lib:Library = Library::new();

		assert_eq!(&lib.name,lib.get_name());
		println!("struct Library / Result of get_name() -> {:?}",lib.get_name());

		assert!(lib.all_processes.len()==0);
		assert_eq!(lib.all_processes.len(),lib.get_all_processes().len());
		let _is_right_type:&Vec<Process> = lib.get_all_processes();
		println!("struct Library / Result of get_all_processes() -> [it's empty]");
	}

	#[test]
	fn test_library_display() {
		Library::new().display();
	}

	#[test]
	fn test_library_set_functions() {
		let mut lib:Library = Library::new();

		lib.set_name("SET_LIBRARY_NAME");
		assert_eq!(&lib.name,lib.get_name());

		let proc = Process::new();
		let number = &proc.get_number().clone();
		lib.add_process(proc);
		assert_eq!(lib.get_all_processes()[0].get_number(),number);

		lib.display();
	}


}