Datafiles Sample
index.txt sample
datafile sample : CINCINATTI-2019-01-31.txt
UTC_datetime format is: 2019-01-31T18:40:32+00:00 (ISO-8601)
UTC_datestamp format is: 2019-01-31
Filename Format
---------------
ABBREVIATEDLOCATION-utcdatestamp.txt or .zip
Header Format
-------------
%HDR%shasum_identifier%BK%abreviated_location%BK%description%BK%custom_1%BK%custom_2...%LBK%
The header's shasum_identifier gives a sum for the remaining header
information, exclusive of the %BK% tag but inclusive any other tags that
follow it.
Carriage returns do not count as line breaks. %LBK% is necessary.
Entry Format
------------
shasum_identifier%BK%abbreviated_location%BK%UTC_datetime%BK%sender%BK%recipient%BK%keywords%BK%detailed_location%BK%text%LBK%
Once again, the shasum does not include the %BK% tag following it, but it
does contain all subsequent information and tags.
Recommended detailed_location is: city/town,county,state,country
Transmissions should end with %EOF%
Package File Name
-----------------
ABBREVIATEDLOCATION-datestamp.txt and .zip
The datestamp is UTC and does not include time. This datestamp is the
same as that which appears on datafile entries. Thus a location file
can be updated at a later date with data that arrives later.
If someone creates a file with the bad case, a savvy server can simply
merge it into a file with the proper case.
Index File Format
-----------------
filename%BK%UTC_datestamp_for_last_update%BK%shasum_for_entire_file%BK%sha_sum_for_regular_data%BK%txt_size%BK%zip_size%LBK%
The last two fields (file sizes) are optional.
The %LBK% can be replaced with a carriage return when displaying content to a user.
Index File Name
---------------
index.txt and .zip
Return to the main page.
Hermann L. Johnson. January 2019. Free for unmodified redistribution and non-commercial use.