LVbag

Generate embedded file lists for directories. LVbag can serve as an occasional helper with static directories or become a part of the build process to assist in embedding dynamic files

Usage: lvb [flags] [commands] <path>
A large and handy file bag for V. It simplifies carrying files with your programs
by generating embed file lists for directories based on your specifications.
Flags:
-o --output The output file name. If none is set, the result is printed to stdout.
-a --append Append the result to the output file.
-f --force Overwrite the output file if it already exists.
-I --ignore Ignore the paths in the target directories if they contain these strings.
-r --regex Treat the ignore string as a regex pattern.
-h --hidden Include hidden files.
-bag --lv_bag The name of the handbag variable [default: `lv_bag`].
-mod --mod_name Specify the module name used in the output.
-v --verbose Enable extended information prints.
--skip-format Skip formatting of the output file.
--help Prints help information.
--version Prints version information.
Commands:
help Prints help information.
version Prints version information.

Installation

• The projects GitHub releases page provides prebuilt binaries for GNU/Linux, Windows and macOS.

Usage Examples

• Add a path without additional flags to print the output to the terminal.

  lvb examples/gui_project/ui

  constlv_bag= [
  $embed_file('/home/t/Dev/vlang/lvb/examples/gui_project/ui/src/main.js')
  $embed_file('/home/t/Dev/vlang/lvb/examples/gui_project/ui/src/style.css')
  $embed_file('/home/t/Dev/vlang/lvb/examples/gui_project/ui/src/index.html')
  ]

• Append to an existing file, specify a "bag" name (specifying a single file as path won't create an array).

  # Append to an existing file `foo.v`
  lvb -bag icon -o foo.v -a assets/icon.ico

  // foo.vmodulemainconstfoo="foo"consticon= $embed_file('<path>/ui_project/assets/icon.ico')

• Add a module name to the output, make the output print verbose.

  lvb -mod bar -v examples/ui_project/ui

  

App examples

Simple Application examples that utilize this tool can be found in the .examples/ directory.

An example application that uses LVbag to embed the files of a dynamic npm build output is emoji-mart-desktop

Development

To compile the app yourself, clone the repository and build the release version.

# Clone the repository
git clone https://github.com/ttytm/LVbag.git
cd LVbag
# Install dependencies - LVB uses PCRE
v install --once
# Build and run as usual in development
v run .# Build the release version
v -cc gcc -prod -o lvb .