Package: csvdeploy
csvdeployPython package for deploying tabular data files (csvw) as static websites with continuous integrationIntroductioncsvdeployis a Python library for the generation and deployment of static websites
based on tabular data following [csvw](thehttps://www.w3.org/TR/tabular-data-primer/) standard
from W3C. It intended as a solution for simple websites requiring almost no configuration and
which can be served on cheap or free hosting services: out goal is to have a tool that is
as "plug-and-play" as possible, and which can be configured for continuous integration.
Simple things should be simple, and hard things should be possible -- as long as they
don't steep the learning curve.Installation and usageThe library can be installed as any standard Python library withpip, as in the snippet
below. If installed in a local machine, it is highly recommended using a virtual
environment solution. In all cases, updating the packages used for installing libraries
is also recommended whenever possible (that is,pip install --upgrade pip setuptools wheel).$pipinstalldeploycsvIn most situations, however, you will probably want to use the library automatically in
some integrated system. The intended usage is to have agitrepository holding
your data that will automatically invokecsvdeploy, generate the new web pages, and
upload them to be served each time the raw data is changed. The instructions for
installing and using the library will depend on the exact system you will be using,
with the most common given in our documentation.The basic operation is to invoke thecsvdeploycommand-line tool, pointing it to
a JSON configuration file, as in the command below using one the demo datasets
distributed with the package:$csvdeploydemo_data/langgenera/langgenera.config.jsonThe exact operation of the tool will, as expected, depend on the configuration. By
default, a new site will be generated in the_sitedirectory under the path where
it is called.ChangelogVersion 0.1:First released version.Community guidelinesWhile the author can be contacted directly for support, it is recommended that third parties use
GitHub standard features, such as issues and pull requests, to contribute, report problems, or
seek support.Contributing guidelines, including a code of conduct, can be found in theCONTRIBUTING.mdfile.Author and citationThe library is developed by Tiago Tresoldi (tiago.tresoldi@lingfil.uu.se).During initial stage of development, the author received funding from the European Research Council
(ERC) under the European Union's Horizon 2020 research and innovation programme (grant agreement No.
ERC Grant #715618, "Computer-Assisted Language Comparison").If you usecsvdeploy, please cite it as:Tresoldi, Tiago (2021). CSVDeploy, a package for deploying tabular data files as static websites.
Version 0.1. Uppsala.In BibTeX:@misc{Tresoldi2021csvdeploy,
  author = {Tresoldi, Tiago},
  title = {CSVDeploy, a package for deploying tabular data files as static websites. Version 0.1},
  howpublished = {\url{https://github.com/tresoldi/csvdeploy}},
  address = {Uppsala},
  publisher = {Institutionen fÃ¶r lingvistik och filologi, Uppsala universitet}
  year = {2021},
}