Imports System.IO Imports Newtonsoft.Json Imports Newtonsoft.Json.Linq Public Class Utilities ''' ''' Shows the license notice in a messagebox. ''' ''' ''' Result of the Dialog (Yes/No). ''' Public Shared Function LicenseAgreement() Dim result As DialogResult = MessageBox.Show($"MIT License {My.Application.Info.Copyright} Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ""Software""), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.", "License Agreement", MessageBoxButtons.OKCancel, MessageBoxIcon.Information) Return result End Function ''' ''' Checks for the existence of the 'logs' directory under the 'RPST' directory within the user's AppData\Roaming folder. ''' If the directory does not exist, it creates one. ''' ''' ''' The directory path is 'C:\Users\\AppData\Roaming\RPST\logs'. ''' If the 'RPST' or 'logs' directories do not exist, the function will create them. ''' If the directories already exist, the function will not perform any actions. ''' Public Shared Sub PathFinder() Dim directoryPath As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "RPST", "logs") If Not Directory.Exists(directoryPath) Then Directory.CreateDirectory(directoryPath) End If End Sub ''' ''' Collects and validates user inputs from StartForm and returns them as a Tuple. ''' ''' ''' Tuple containing: ''' Keyword (String) - Keyword entered by user in theFormMain. ''' Subreddit (String) - Subreddit entered by user in theFormMain. ''' Listing (String) - Listing chosen by user in the StartForm, defaults to 'top' if none is selected. ''' Limit (Integer) - Limit entered by user in the StartForm, defaults to 10 if the entered value is over 100. ''' Timeframe (String) - Timeframe chosen by user in the StartForm, defaults to 'all' if none is selected. ''' ''' ''' If keyword or subreddit are empty, Displays a warning and returns nothing. ''' Public Shared Function CollectInputs() As (Keyword As String, Subreddit As String, Listing As String, Limit As Integer, Timeframe As String)? Dim keyword As String = FormMain.TextBoxKeyword.Text.Trim() Dim subreddit As String = FormMain.TextBoxSubreddit.Text.Trim() ' Convert the Listing and Subreddit to lowercase using InvariantCulture. Dim listing As String = If(String.IsNullOrEmpty(FormMain.ComboBoxListing.Text), "top", FormMain.ComboBoxListing.Text.ToLower(Globalization.CultureInfo.InvariantCulture).Trim()) Dim timeframe As String = If(String.IsNullOrEmpty(FormMain.ComboBoxTimeframe.Text), "all", FormMain.ComboBoxTimeframe.Text.ToLower(Globalization.CultureInfo.InvariantCulture).Trim()) Dim limit As Integer = FormMain.NumericUpDownLimit.Value ' Validate inputs. If String.IsNullOrEmpty(keyword) AndAlso String.IsNullOrEmpty(subreddit) Then MessageBox.Show("Keyword and Subreddit should not be empty.", "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning) Return Nothing ElseIf String.IsNullOrEmpty(keyword) Then MessageBox.Show("Keyword field should not be empty.", "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning) Return Nothing ElseIf String.IsNullOrEmpty(subreddit) Then MessageBox.Show("Subreddit field should not be empty.", "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning) Return Nothing End If Return (keyword, subreddit, listing, limit, timeframe) End Function ''' ''' Saves the gives posts' data to a JSON file. ''' ''' The object containing posts to be saved. ''' ''' This function allows the user to select a location to save the posts. ''' If the user confirms the save location, the posts will be serialized ''' to JSON with an indented format and written to the chosen file. ''' A success message will be displayed to the user upon successful save. ''' Public Shared Sub SavePostsToJson(posts As Object) Dim saveFileDialog As New SaveFileDialog With { .Filter = "JSON files (*.json)|*.json", .Title = "Save posts to JSON" } If saveFileDialog.ShowDialog() = DialogResult.OK Then Dim fileName As String = saveFileDialog.FileName Dim serializerSettings As New JsonSerializerSettings With { .Formatting = Formatting.Indented } Dim json As String = JsonConvert.SerializeObject(posts, serializerSettings) File.WriteAllText(fileName, json) MessageBox.Show($"Posts saved to {fileName}", "Saved", MessageBoxButtons.OK, MessageBoxIcon.Information) End If End Sub ''' ''' Saves Reddit posts contained in a JArray to a CSV file. ''' ''' A JArray containing the Reddit posts to be saved. ''' ''' This function displays a SaveFileDialog to allow the user to specify the file name and location. ''' It then iterates through the JArray to write each post's details (totalPosts, title, subreddit, author, score) into the selected CSV file. ''' Public Shared Sub SavePostsToCSV(posts As JArray) Dim saveFileDialog As New SaveFileDialog With { .Filter = "CSV files (*.csv)|*.csv", .Title = "Save posts to CSV" } If saveFileDialog.ShowDialog() = DialogResult.OK Then Dim fileName As String = saveFileDialog.FileName Using csvWriter As New StreamWriter(fileName) ' Write the header. csvWriter.WriteLine("Index,Author,ID,Subreddit,Visibility,Thumbnail,NSFW,Gilded,Upvotes,Upvote Ratio,Downvotes,Award,Top Award,Is cross-postable?,Score,Category,Text,Domain,Permalink,Created At,Approved At,Approved By") Dim postCount As Integer = 0 For Each post In posts postCount += 1 csvWriter.WriteLine($"{postCount},{post("data")("author")},{post("data")("id")},{post("data")("subreddit_name_prefixed")},{post("data")("subreddit_type")},{post("data")("thumbnail")},{post("data")("over_18")},{post("data")("gilded")},{post("data")("ups")},{post("data")("upvote_ratio")},{post("data")("downs")},{post("data")("total_awards_received")},{post("data")("top_awarded_type")},{post("data")("is_crosspostable")},{post("data")("score")},{post("data")("category")},{post("data")("selftext")},{post("data")("domain")},{post("data")("permalink")},{post("data")("created")},{post("data")("approved_at_utc")},{post("data")("approved_by")}") Next End Using MessageBox.Show($"Posts saved to {fileName}", "Saved", MessageBoxButtons.OK, MessageBoxIcon.Information) End If End Sub ''' ''' Checks if the "launch.log" file exists in the directory: C:\Users\\AppData\Roaming\RPSTl\logs. ''' ''' ''' If the file doesn't exist, it shows a MessageBox with the License Agreement Notice with buttons Yes and No. ''' If the user clicks on the Yes button, it creates one the launch.log file, otherwise assume the user did not agree to the License and close the program. ''' The launc.log file is used to determine whether the program has been run before. ''' Public Shared Sub LogFirstTimeLaunch() Dim filePath As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "RPST", "logs", "launch.log") Dim textToWrite As String = $" {My.Application.Info.AssemblyName} ------------------------- User: {Environment.UserName} Host: {Environment.MachineName} OS: {Environment.OSVersion} x64: {Environment.Is64BitOperatingSystem} First launched on: {DateTime.Now}" If Not File.Exists(filePath) Then Dim result As DialogResult = LicenseAgreement() If result = DialogResult.OK Then File.WriteAllText(filePath, textToWrite) Else FormMain.Close() End If End If End Sub End Class