aswi2021tri-musketyri-gitlab/Server/ServerApp/DataDownload/IDataDownloader.cs @ cf35739b

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ServerApp.DataDownload
{
	interface IDataDownloader
	{
		/// <summary>
		/// Downloads json file - returns contents of said file
		/// </summary>
		/// <returns> Path to file </returns>
		public string DownloadWeatherPrediction();

		/// <summary>
		/// Downloads selected type and time span of data in the desired format, returns a list of full paths to all successfully saved files. 
		/// If some of the files already existed and were not overwritten, then the returned List contains paths to these files also.
		/// </summary>
		/// <param name="type">The requested data type</param>
		/// <param name="format">The data format</param>
		/// <param name="startDate">The start date</param>
		/// <param name="endDate">The end date</param>
		/// <returns>A list of full paths to all saved files</returns>
		public List<string> DownloadData(DataType type, DataFormat format, Date startDate, Date endDate);

		/// <summary>
		/// Retrieves all data files with dates falling within the specified range. If not all data for the specified range is found
		/// then returns also file/s with month 0 if exists.
		/// If startDate and/or endDate are null, then returns all files from the given subdirectory.
		/// </summary>
		/// <param name="subDirectory">The subdirectory to search</param>
		/// <param name="startDate">The start date</param>
		/// <param name="endDate">The end date</param>
		/// <returns>A list of all retrieved data files from the requested time span</returns>
		public List<string> GetData(string subDirectory, Date startDate, Date endDate);
	}
}