{"id":24580069,"url":"https://github.com/vdaburon/createhtmlforfilesindirectory","last_synced_at":"2025-08-21T12:19:57.648Z","repository":{"id":62948815,"uuid":"551872998","full_name":"vdaburon/CreateHtmlForFilesInDirectory","owner":"vdaburon","description":"A tool that create a html page for files in directory to display graphs and link files","archived":false,"fork":false,"pushed_at":"2023-05-10T12:34:27.000Z","size":223,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T01:31:53.835Z","etag":null,"topics":["graph","jmeter","jmeter-plugin","jmeter-plugins","jmeter-report","loadtesting","maven","performance-testing","performance-visualization"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vdaburon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-10-15T09:28:44.000Z","updated_at":"2023-07-12T11:21:57.000Z","dependencies_parsed_at":"2022-11-09T18:02:04.334Z","dependency_job_id":null,"html_url":"https://github.com/vdaburon/CreateHtmlForFilesInDirectory","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdaburon%2FCreateHtmlForFilesInDirectory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdaburon%2FCreateHtmlForFilesInDirectory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdaburon%2FCreateHtmlForFilesInDirectory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vdaburon%2FCreateHtmlForFilesInDirectory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vdaburon","download_url":"https://codeload.github.com/vdaburon/CreateHtmlForFilesInDirectory/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244056429,"owners_count":20390720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["graph","jmeter","jmeter-plugin","jmeter-plugins","jmeter-report","loadtesting","maven","performance-testing","performance-visualization"],"created_at":"2025-01-24T01:32:38.210Z","updated_at":"2025-08-21T12:19:57.637Z","avatar_url":"https://github.com/vdaburon.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Generating an HTML page that references or includes various files\n[![Maven Central](https://img.shields.io/maven-central/v/io.github.vdaburon/create-html-for-files-in-directory)](https://central.sonatype.com/artifact/io.github.vdaburon/create-html-for-files-in-directory)\n[![Apache License](http://img.shields.io/badge/license-Apache-green.svg)](https://github.com/vdaburon/CreateHtmlForFilesInDirectory/blob/main/LICENSE)\n![Free](https://img.shields.io/badge/free-open--source-green.svg)\n[![Apache JMeter](https://img.shields.io/badge/Apache%20JMeter-green)](https://jmeter.apache.org/)\n\n\n\nThis program recursively scans a directory looking for files of different types to generate a link or include the content in the generated html page.\u003cbr/\u003e\nSince version 1.5, a Table Of Content could be computed and add to the result page.\n\nThe types (extensions) of files searched are:\n * csv\n * jtl\n * xml\n * gz\n * zip\n * log\n * xlsx\n * xls\n * gif\n * png\n * bmp\n * jpg\n * jpeg\n * html\n * txt\n * htm\n \nThe link is \"\u0026lt;a ref=\" relative for files of type: csv, jtl, xml, gz, zip, log, xlsx, xls, txt, htm (to download it)\n\nThe link is \"\u003cimg src=\" relative for files of type: gif, png, bmp, jpg, jpeg (to view it)\n\nFor html files (.html), the content is read and directly included in the generated html page (blocks of html tables created with the csv-report-to-html tool from csv file). This HTML included file must not have elements \u0026lt;html\u0026gt; and \u0026lt;/html\u0026gt;. **Please note:** \".html\" and \".htm\" files are treated differently.\n\nSorting algorithm : Ascending alphabetical sorting but filenames with less directory deep are before file this directory\n\u003cpre\u003e\nExample : z.img \u003c dir/x.img \u003c dir/y.img \u003c aa/bb/c.img \u003c aa/bb/d.img\nDeep    : no dir, dir 1 deep level,      dir 2 deep level\n\u003c/pre\u003e\n\n## Default values \n- image_width = 1024 (pixels)\n- add_toc = true (add Table Of Contents)\n\nAnd the charset to read could be set with -Dfile.encoding=\u0026lt;charset encoding\u0026gt; (e.g: UFT-8)\n\nChange this values with system properties :\n- -Dimage_width=new_int_value (e.g: 1280)\n- -Dadd_toc=false (e.g: true or false)\n\n## The index.html generated\nHTML Extract example :\n\n![html extract](doc/images/html_extract.png)\n\n## Usage Maven\n\nThe maven groupId, artifactId and version, this plugin is in the **Maven Central Repository** [![Maven Central](https://img.shields.io/maven-central/v/io.github.vdaburon/create-html-for-files-in-directory)](https://central.sonatype.com/artifact/io.github.vdaburon/create-html-for-files-in-directory)\n\n\n```xml\n\u003cgroupId\u003eio.github.vdaburon\u003c/groupId\u003e\n\u003cartifactId\u003ecreate-html-for-files-in-directory\u003c/artifactId\u003e\n\u003cversion\u003e1.8\u003c/version\u003e\n```\nJust include the plugin in your `pom.xml` and execute `mvn verify` \u003cbr\u003e\nor individual launch `mvn -Dimage_width=950 -Dadd_toc=false exec:java@create_html_page_for_files_in_directory`\n\n```xml\n\u003cproject\u003e\n    \u003cproperties\u003e\n        \u003cimage_width\u003e1024\u003c/image_width\u003e\n        \u003cadd_toc\u003etrue\u003c/add_toc\u003e\n    \u003c/properties\u003e\n\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.github.vdaburon\u003c/groupId\u003e\n            \u003cartifactId\u003ecreate-html-for-files-in-directory\u003c/artifactId\u003e\n            \u003cversion\u003e1.8\u003c/version\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n    \n    \u003cbuild\u003e\n        \u003cplugins\u003e\n            \u003cplugin\u003e\n                \u003cgroupId\u003eorg.codehaus.mojo\u003c/groupId\u003e\n                \u003cartifactId\u003eexec-maven-plugin\u003c/artifactId\u003e\n                \u003cversion\u003e1.2.1\u003c/version\u003e\n                \u003cexecutions\u003e\n                    \u003cexecution\u003e\n                        \u003cid\u003ecreate_html_page_for_files_in_directory\u003c/id\u003e\n                        \u003cphase\u003everify\u003c/phase\u003e\n                        \u003cgoals\u003e\n                            \u003cgoal\u003ejava\u003c/goal\u003e\n                        \u003c/goals\u003e\n                        \u003cconfiguration\u003e\n                            \u003cmainClass\u003eio.github.vdaburon.jmeter.utils.HtmlGraphVisualizationGenerator\u003c/mainClass\u003e\n                            \u003carguments\u003e\n                                \u003cargument\u003e${project.build.directory}/jmeter/results\u003c/argument\u003e\n                                \u003cargument\u003eindex.html\u003c/argument\u003e\n                            \u003c/arguments\u003e\n                            \u003csystemProperties\u003e\n                                \u003csystemProperty\u003e\n                                    \u003ckey\u003eimage_width\u003c/key\u003e\n                                    \u003cvalue\u003e${image_width}\u003c/value\u003e\n                                \u003c/systemProperty\u003e\n                                \u003csystemProperty\u003e\n                                    \u003ckey\u003eadd_toc\u003c/key\u003e\n                                    \u003cvalue\u003e${add_toc}\u003c/value\u003e\n                                \u003c/systemProperty\u003e\n                            \u003c/systemProperties\u003e\n                        \u003c/configuration\u003e\n                    \u003c/execution\u003e\n                \u003c/executions\u003e\n            \u003c/plugin\u003e\n        \u003c/plugins\u003e\n    \u003c/build\u003e\n\u003c/project\u003e\n```\n\n## Simple jar tool\nThis tool is a java jar, so it's could be use as simple jar (look at [Release](https://github.com/vdaburon/CreateHtmlForFilesInDirectory/releases) to download jar file)\n\u003cpre\u003e\njava -Dimage_width=900 -Dadd_toc=true -cp create-html-for-files-in-directory-\u0026lt;version\u0026gt;.jar io.github.vdaburon.jmeter.utils.HtmlGraphVisualizationGenerator jmeter/results index.html\nor\njava -Dimage_width=900 -Dadd_toc=true -jar create-html-for-files-in-directory-\u0026lt;version\u0026gt;-jar-with-dependencies.jar jmeter/results index.html\n\u003c/pre\u003e\n\nRemark : \u003cbr/\u003e\nThe result page could be in the parent directory like : ../index.html\n\n## Link to others projects\nUsually this plugin is use with [jmeter-graph-tool-maven-plugin](https://github.com/vdaburon/jmeter-graph-tool-maven-plugin)\u003cbr\u003e\nand this plugin [csv-report-to-html](https://github.com/vdaburon/JMReportCsvToHtml)\n1) The **jmeter-graph-tool-maven-plugin** create the report csv files and graphs\n2) The **csv-report-to-html** create the **html table report** from the csv file\n3) The **create-html-for-files-in-directory** create a page html this links to images and files in a directory to show and add links\n\n## License\nSee the LICENSE file Apache 2 [https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)\n\n## Versions\nVersion 1.8 date 2025-07-16, Change the maven plugin and configuration to publish to maven central in pom.xml.\n\nVersion 1.7 date 2025-07-11, Add extensions \".txt\" and \".htm\", \".htm\" file is not include like \".html\" file but like log file with a link a href. It's a solution to open another html page with a link.\n\nVersion 1.6 date 2025-04-29, Compute relative path for result page to a parent directory, e.g: directory with file : \"c:/dir/image\" and result to parent directory \"../index.html\" links in index.html to relative sub directory \"image/\"\n\nVersion 1.5 date 2025-04-27, Change links name for Table Of Contents to avoid conflict with links in included html page.\n\nVersion 1.4 date 2025-04-26, add Table Of Contents and new property add_toc (default value : true).\n\nVersion 1.3 date 2023-05-10, Add extensions xlsx and xls (Excel file)\n\nVersion 1.2 add the file size after the \"\u0026lt;a ref=\" link\n\nVersion 1.1 add link (a href) to jtl and xml files\n\nVersion 1.0 initial version\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdaburon%2Fcreatehtmlforfilesindirectory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvdaburon%2Fcreatehtmlforfilesindirectory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvdaburon%2Fcreatehtmlforfilesindirectory/lists"}