update_checker.h

Go to the documentation of this file.

#pragma once

 
/* Storage capacities in elements; text buffers include the terminating NUL. */
#define NETWORK_UPDATE_CHECKER_LATEST_VERSION_BUFFER_SIZE 64
#define NETWORK_UPDATE_CHECKER_LATEST_SHA_BUFFER_SIZE 41
#define NETWORK_UPDATE_CHECKER_CURRENT_VERSION_BUFFER_SIZE 64
#define NETWORK_UPDATE_CHECKER_CURRENT_SHA_BUFFER_SIZE 41
#define NETWORK_UPDATE_CHECKER_RELEASE_URL_BUFFER_SIZE 512
 
#include <stdbool.h>
#include <stdint.h>
#include <time.h>
#include "../common.h"

typedef struct {
  bool update_available;                                                  
  char latest_version[NETWORK_UPDATE_CHECKER_LATEST_VERSION_BUFFER_SIZE]; 
  char latest_sha[NETWORK_UPDATE_CHECKER_LATEST_SHA_BUFFER_SIZE]; 
  char current_version[NETWORK_UPDATE_CHECKER_CURRENT_VERSION_BUFFER_SIZE]; 
  char current_sha[NETWORK_UPDATE_CHECKER_CURRENT_SHA_BUFFER_SIZE];         
  char release_url[NETWORK_UPDATE_CHECKER_RELEASE_URL_BUFFER_SIZE];         
  time_t last_check_time;                                                   
  time_t dismissed_until; 
  bool check_succeeded;   
} update_check_result_t;

typedef enum {
  INSTALL_METHOD_HOMEBREW,  
  INSTALL_METHOD_SCOOP,     
  INSTALL_METHOD_ARCH_AUR,  
  INSTALL_METHOD_INSTALLER, 
  INSTALL_METHOD_GITHUB,    
  INSTALL_METHOD_UNKNOWN,   
} install_method_t;

asciichat_error_t update_check_perform(update_check_result_t *result);

asciichat_error_t update_check_load_cache(update_check_result_t *result);

asciichat_error_t update_check_save_cache(const update_check_result_t *result);

void update_check_dismiss_for_a_week(update_check_result_t *result);

bool update_check_is_dismissed(const update_check_result_t *result);

bool update_check_is_cache_fresh(const update_check_result_t *result);

bool update_check_try_fresh_cache(update_check_result_t *result);

install_method_t update_check_detect_install_method(void);

void update_check_get_upgrade_suggestion(install_method_t method, const char *latest_version, char *buffer,
                                         size_t buffer_size);

const char *update_check_get_aur_helper(void);

void update_check_format_notification(const update_check_result_t *result, char *buffer, size_t buffer_size);

asciichat_error_t update_check_startup(update_check_result_t *result);