https://github.com/vdaburon/createhtmlforfilesindirectory
A tool that create a html page for files in directory to display graphs and link files
https://github.com/vdaburon/createhtmlforfilesindirectory
graph jmeter jmeter-plugin jmeter-plugins jmeter-report loadtesting maven performance-testing performance-visualization
Last synced: 6 months ago
JSON representation
A tool that create a html page for files in directory to display graphs and link files
- Host: GitHub
- URL: https://github.com/vdaburon/createhtmlforfilesindirectory
- Owner: vdaburon
- License: apache-2.0
- Created: 2022-10-15T09:28:44.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-10T12:34:27.000Z (almost 3 years ago)
- Last Synced: 2025-01-24T01:31:53.835Z (about 1 year ago)
- Topics: graph, jmeter, jmeter-plugin, jmeter-plugins, jmeter-report, loadtesting, maven, performance-testing, performance-visualization
- Language: Java
- Homepage:
- Size: 218 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Generating an HTML page that references or includes various files
[](https://central.sonatype.com/artifact/io.github.vdaburon/create-html-for-files-in-directory)
[](https://github.com/vdaburon/CreateHtmlForFilesInDirectory/blob/main/LICENSE)
[](https://jmeter.apache.org/)
This program recursively scans a directory looking for files of different types to generate a link or include the content in the generated html page.
Since version 1.5, a Table Of Content could be computed and add to the result page.
The types (extensions) of files searched are:
* csv
* jtl
* xml
* gz
* zip
* log
* xlsx
* xls
* gif
* png
* bmp
* jpg
* jpeg
* html
* txt
* htm
The link is "<a ref=" relative for files of type: csv, jtl, xml, gz, zip, log, xlsx, xls, txt, htm (to download it)
The link is "![]()
Example : z.img < dir/x.img < dir/y.img < aa/bb/c.img < aa/bb/d.img
Deep : no dir, dir 1 deep level, dir 2 deep level
## Default values
- image_width = 1024 (pixels)
- add_toc = true (add Table Of Contents)
And the charset to read could be set with -Dfile.encoding=<charset encoding> (e.g: UFT-8)
Change this values with system properties :
- -Dimage_width=new_int_value (e.g: 1280)
- -Dadd_toc=false (e.g: true or false)
## The index.html generated
HTML Extract example :
## Usage Maven
The maven groupId, artifactId and version, this plugin is in the **Maven Central Repository** [](https://central.sonatype.com/artifact/io.github.vdaburon/create-html-for-files-in-directory)
```xml
io.github.vdaburon
create-html-for-files-in-directory
1.8
```
Just include the plugin in your `pom.xml` and execute `mvn verify`
or individual launch `mvn -Dimage_width=950 -Dadd_toc=false exec:java@create_html_page_for_files_in_directory`
```xml
1024
true
io.github.vdaburon
create-html-for-files-in-directory
1.8
org.codehaus.mojo
exec-maven-plugin
1.2.1
create_html_page_for_files_in_directory
verify
java
io.github.vdaburon.jmeter.utils.HtmlGraphVisualizationGenerator
${project.build.directory}/jmeter/results
index.html
image_width
${image_width}
add_toc
${add_toc}
```
## Simple jar tool
This 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)
java -Dimage_width=900 -Dadd_toc=true -cp create-html-for-files-in-directory-<version>.jar io.github.vdaburon.jmeter.utils.HtmlGraphVisualizationGenerator jmeter/results index.html
or
java -Dimage_width=900 -Dadd_toc=true -jar create-html-for-files-in-directory-<version>-jar-with-dependencies.jar jmeter/results index.html
Remark :
The result page could be in the parent directory like : ../index.html
## Link to others projects
Usually this plugin is use with [jmeter-graph-tool-maven-plugin](https://github.com/vdaburon/jmeter-graph-tool-maven-plugin)
and this plugin [csv-report-to-html](https://github.com/vdaburon/JMReportCsvToHtml)
1) The **jmeter-graph-tool-maven-plugin** create the report csv files and graphs
2) The **csv-report-to-html** create the **html table report** from the csv file
3) 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
## License
See the LICENSE file Apache 2 [https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)
## Versions
Version 1.8 date 2025-07-16, Change the maven plugin and configuration to publish to maven central in pom.xml.
Version 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.
Version 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/"
Version 1.5 date 2025-04-27, Change links name for Table Of Contents to avoid conflict with links in included html page.
Version 1.4 date 2025-04-26, add Table Of Contents and new property add_toc (default value : true).
Version 1.3 date 2023-05-10, Add extensions xlsx and xls (Excel file)
Version 1.2 add the file size after the "<a ref=" link
Version 1.1 add link (a href) to jtl and xml files
Version 1.0 initial version