vdts is a library and cli for verifying that items in a time series occur at regular time intervals.
It started out as a tool specifically used to check and report on if a set of files with dates in their names occur at regular time intervals with no missing and/or extra files.
For example, this is very useful for verifying that there are no missing statements in a directory for monthly financial statements.
It can still be used to do that. But underneath, we've isolated the core functionality—the module may also be used as a python code library now.
Fun fact: "vdts" originally was an abbreviation for "Verify Directory Time Series"
This package is still in development and will be deployed to Pypi soon. Watch out for the pypi release shield to appear at the top of this file.
Once the package is installed, you should have access to a command line script
vdts from your python environment's bin directory, which should be in your
user PATH.
To check if there are any gaps in monthly statements with file names that look
like statement-%Y%m%d.pdf in the current directory, you can run:
vdts . 'statement-%Y%m%d\.pdf'To check all the way up until today (to see if you need to go to your bank's online portal to download statements), you can run:
vdts -n . 'statement-%Y%m%d\.pdf'Now let's say you have an investment account that provides quarterly statements. You can check by running:
vdts -i q -n . 'investment_account_\d{8}-%Y%m%d\.pdf'For further instructions on how to use the CLI, just run
vdts -hDetails about the library will come soon!
TODO: I still need to finalize the API for the library offering of vdts