Usage

To use Datavzrd, run the following command in your terminal:

$ datavzrd [FLAGS] [OPTIONS] <CONFIG> --output <output>

Example:

$ datavzrd path/to/my-config.yaml --output my-report

Command Line Arguments

Command Line Arguments

Name	Description	Type	Required	Default Value
--debug	Activates debug mode. Javascript files are not minified.	Flag	No	N/A
-h, --help	Prints help information.	Flag	No	N/A
--overwrite-output	Overwrites the contents of the given output directory if it is not empty.	Flag	No	N/A
-V, --version	Prints version information.	Flag	No	N/A
-v, --verbose	Verbose mode (-v, -vv, -vvv, etc.).	Flag	No	N/A
-o, --output	Output file.	Option	Yes	N/A
-w, --webview-url	Sets the URL of the webview host. Note that when using the link, the row data can temporarily occur (in base64-encoded form) in the server logs of the given webview host.	Option	No	https://datavzrd.github.io/view/
<CONFIG>	Config file containing file paths and settings.	Argument	Yes	N/A

Subcommands

Datavzrd also supports additional functionality through subcommands. Below are the available subcommands:

Publish

The publish subcommand allows you to publish a generated report to GitHub Pages. This requires the user to have gh installed and authenticated.

$ datavzrd publish --repo-name <repo_name> --report-path <report_path> [--org <organization>]

Command Line Arguments for publish:

publish Subcommand Arguments

Name	Description	Type	Required	Default Value
--repo-name	GitHub repository name to publish to.	Option	Yes	N/A
--report-path	Path to the report directory.	Option	Yes	N/A
--org	Optional: Specify the organization for the repository.	Option	No	N/A

Example:

$ datavzrd publish --repo-name my-awesome-report --report-path ./output --org my-awesome-org --entry index.html

This command publishes the report located in ./output to the my-awesome-report repository of the organisation my-awesome-org on GitHub Pages, with index.html as the entry point. The repository will be created under https://my-awesome-org.github.io/my-awesome-report/ and can be accessed after GitHub pages is activated by the user. After successful publishing the user is provided with simple instructions on how to activate GitHub pages.

Suggest

The suggest subcommand generates a configuration file based on the provided tabular input files. The suggested configuration is written to stdout.

$ datavzrd suggest --files <file_paths> --separators <separators> [--name <report_name>]

Command Line Arguments for suggest:

suggest Subcommand Arguments

Name	Description	Type	Required	Default Value
--files	List of paths to input files.	Option	Yes	N/A
--separators	Separators for the corresponding input files (e.g., comma for CSV, tab for TSV).	Option	Yes	N/A
--name	Name of the report.	Option	No	Datavzrd Report

Example:

$ datavzrd suggest -f data1.csv -s , -f data2.tsv -s $'\t'