mirror of
				https://github.com/ggml-org/llama.cpp.git
				synced 2025-10-29 08:41:22 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			90 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			90 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| #pragma once
 | |
| 
 | |
| #include "common.h"
 | |
| 
 | |
| #include <set>
 | |
| #include <string>
 | |
| #include <vector>
 | |
| 
 | |
| //
 | |
| // CLI argument parsing
 | |
| //
 | |
| 
 | |
| struct common_arg {
 | |
|     std::set<enum llama_example> examples = {LLAMA_EXAMPLE_COMMON};
 | |
|     std::set<enum llama_example> excludes = {};
 | |
|     std::vector<const char *> args;
 | |
|     const char * value_hint   = nullptr; // help text or example for arg value
 | |
|     const char * value_hint_2 = nullptr; // for second arg value
 | |
|     const char * env          = nullptr;
 | |
|     std::string help;
 | |
|     bool is_sparam = false; // is current arg a sampling param?
 | |
|     void (*handler_void)   (common_params & params) = nullptr;
 | |
|     void (*handler_string) (common_params & params, const std::string &) = nullptr;
 | |
|     void (*handler_str_str)(common_params & params, const std::string &, const std::string &) = nullptr;
 | |
|     void (*handler_int)    (common_params & params, int) = nullptr;
 | |
| 
 | |
|     common_arg(
 | |
|         const std::initializer_list<const char *> & args,
 | |
|         const char * value_hint,
 | |
|         const std::string & help,
 | |
|         void (*handler)(common_params & params, const std::string &)
 | |
|     ) : args(args), value_hint(value_hint), help(help), handler_string(handler) {}
 | |
| 
 | |
|     common_arg(
 | |
|         const std::initializer_list<const char *> & args,
 | |
|         const char * value_hint,
 | |
|         const std::string & help,
 | |
|         void (*handler)(common_params & params, int)
 | |
|     ) : args(args), value_hint(value_hint), help(help), handler_int(handler) {}
 | |
| 
 | |
|     common_arg(
 | |
|         const std::initializer_list<const char *> & args,
 | |
|         const std::string & help,
 | |
|         void (*handler)(common_params & params)
 | |
|     ) : args(args), help(help), handler_void(handler) {}
 | |
| 
 | |
|     // support 2 values for arg
 | |
|     common_arg(
 | |
|         const std::initializer_list<const char *> & args,
 | |
|         const char * value_hint,
 | |
|         const char * value_hint_2,
 | |
|         const std::string & help,
 | |
|         void (*handler)(common_params & params, const std::string &, const std::string &)
 | |
|     ) : args(args), value_hint(value_hint), value_hint_2(value_hint_2), help(help), handler_str_str(handler) {}
 | |
| 
 | |
|     common_arg & set_examples(std::initializer_list<enum llama_example> examples);
 | |
|     common_arg & set_excludes(std::initializer_list<enum llama_example> excludes);
 | |
|     common_arg & set_env(const char * env);
 | |
|     common_arg & set_sparam();
 | |
|     bool in_example(enum llama_example ex);
 | |
|     bool is_exclude(enum llama_example ex);
 | |
|     bool get_value_from_env(std::string & output);
 | |
|     bool has_value_from_env();
 | |
|     std::string to_string();
 | |
| };
 | |
| 
 | |
| struct common_params_context {
 | |
|     enum llama_example ex = LLAMA_EXAMPLE_COMMON;
 | |
|     common_params & params;
 | |
|     std::vector<common_arg> options;
 | |
|     void(*print_usage)(int, char **) = nullptr;
 | |
|     common_params_context(common_params & params) : params(params) {}
 | |
| };
 | |
| 
 | |
| // parse input arguments from CLI
 | |
| // if one argument has invalid value, it will automatically display usage of the specific argument (and not the full usage message)
 | |
| bool common_params_parse(int argc, char ** argv, common_params & params, llama_example ex, void(*print_usage)(int, char **) = nullptr);
 | |
| 
 | |
| // function to be used by test-arg-parser
 | |
| common_params_context common_params_parser_init(common_params & params, llama_example ex, void(*print_usage)(int, char **) = nullptr);
 | |
| bool common_has_curl();
 | |
| 
 | |
| struct common_remote_params {
 | |
|     std::vector<std::string> headers;
 | |
|     long timeout = 0; // CURLOPT_TIMEOUT, in seconds ; 0 means no timeout
 | |
|     long max_size = 0; // max size of the response ; unlimited if 0 ; max is 2GB
 | |
| };
 | |
| // get remote file content, returns <http_code, raw_response_body>
 | |
| std::pair<long, std::vector<char>> common_remote_get_content(const std::string & url, const common_remote_params & params);
 | 
