Package: simple-parquet-viewer
Simple Parquet ViewerA simple (and lightweight) visualization tool for Parquet files.InstallationIn order to install it, you just have to run the following command in the shell:pipinstallsimple-parquet-viewerAlternatively you can install the distribution package available in thereleases page.UsageTo open the app, it is just necessary to call it from the shell (notice thatpath_to_filearg is optional):spv[path_to_file]Creating shortcut (Windows only)In order to use the shortcut creation utility, thepywin32package must be already installed. Otherwise, you will have to install it by running eitherpip install pywin32orpip install simple-parquet-viewer[windows].Since this is a GUI application, it would be easier to start it from a shortcut rather than the command line. Therefore, in order to make the shortcut creation easier, this application provides a convenience script for that purpose. By running following command, for instance, a shortcut for "Simple Parquet Viewer" must be created in the Start Menu:spv-shortcutNB.:Icons generated using this utility are not automatically removed when this package is uninstalled. Therefore, you must remove them manually afterwards.Desktop shortcutThespv-shortcututility also supports a validdir_pathas first argument, allowing you to generate a shortcut in custom directories, such as "Desktop". The following example demonstrates how to create a desktop shortcut for this application:spv-shortcut %USERPROFILE%\DesktopIn PowerShell:spv-shortcut$env:USERPROFILE\DesktopDevelopmentThere are some utilities which have made the development of this application a bit easier:Icon generation: The application icons have been generated by using open source vectorized images, which can be found close to their "png/ico" versions at./src/res/imgs/;i18n script: This script makes creating and deploying translation files a bit easier by calling tools likepylupdate,linguistandlreleaseunder the hood;package creation: The distribution package of this library is build withhatch(checkpyproject.tomlfile for specs).Generating iconThe usage of inkscape in order to create/modify application icons is strongly recommended, since it is free and open source (and anyone would be able to contribute), but any vectorized drawing tool can be used for this purpose.In order to deploy the application icon, it was necessary to make use ofimagemagickso as to convert the SVG file to a multi-sized icon. The following command has been used generate it:magickconvert./src/res/imgs/app_icon.svg-defineicon:auto-resize=256,128,48,32,16-backgroundnone-fuzz10%-transparentwhite./src/res/imgs/app_icon.icoTranslationsThe usage ofi18nscript is quite straightforward: it is usuallypython ./scripts/i18n.py <COMMAND> <LANG_CODE>, where the command depends on the translation step:generate: Used to generate a new translation file or update the strings of an existing one;edit: Convenience method to openQt Linguist(an editor for translation files);release: Used when the translation is ready for deployment (builds a compiled translation file).NB:It is necessary to havePyQt6andqt6_applicationsso as to be able to run every command.Package generationIn order to build this package, it is just necessary to run the following command in the sell:python-mbuild