gbdev/rgbds
1
0
Fork 0
mirror of https://github.com/gbdev/rgbds.git synced 2025-11-20 10:12:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Factor out common usage-help code

Browse Source
This commit is contained in:
Rangi42
2025-07-27 19:20:04 -04:00
parent 16e16cdf51
commit b2747dfbd8
9 changed files with 138 additions and 179 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
Makefile
View File

@@ -51,7 +51,8 @@ all: rgbasm rgblink rgbfix rgbgfx
common_obj := \
src/extern/getopt.o \
src/diagnostics.o
src/diagnostics.o \
src/usage.o
rgbasm_obj := \
${common_obj} \

2
include/platform.hpp
View File

@@ -1,7 +1,5 @@
// SPDX-License-Identifier: MIT
// platform-specific hacks
#ifndef RGBDS_PLATFORM_HPP
#define RGBDS_PLATFORM_HPP

21
include/usage.hpp Normal file
View File

@@ -0,0 +1,21 @@
// SPDX-License-Identifier: MIT
#ifndef RGBDS_USAGE_HPP
#define RGBDS_USAGE_HPP
#include <stdarg.h>
class Usage {
char const *usage;
public:
Usage(char const *usage_) : usage(usage_) {}
[[noreturn]]
void printAndExit(int code) const;
[[gnu::format(printf, 2, 3), noreturn]]
void printAndExit(char const *fmt, ...) const;
};
#endif // RGBDS_USAGE_HPP

1
src/CMakeLists.txt
View File

@@ -5,6 +5,7 @@ configure_file(version.cpp _version.cpp ESCAPE_QUOTES)
set(common_src
"extern/getopt.cpp"
"diagnostics.cpp"
"usage.cpp"
"_version.cpp"
)

39
src/asm/main.cpp
View File

@@ -15,6 +15,7 @@
#include "extern/getopt.hpp"
#include "helpers.hpp"
#include "parser.hpp" // Generated from parser.y
#include "usage.hpp"
#include "version.hpp"
#include "asm/charmap.hpp"
@@ -83,9 +84,8 @@ static option const longopts[] = {
{nullptr, no_argument, nullptr, 0 }
};
// LCOV_EXCL_START
static void printUsage() {
fputs(
// clang-format off: long string literal
static Usage usage(
"Usage: rgbasm [-EhVvw] [-b chars] [-D name[=value]] [-g chars] [-I path]\n"
" [-M depend_file] [-MC] [-MG] [-MP] [-MT target_file] [-MQ target_file]\n"
" [-o out_file] [-P include_file] [-p pad_value] [-Q precision]\n"
@@ -100,24 +100,9 @@ static void printUsage() {
" -V, --version print RGBASM version and exit\n"
" -W, --warning <warning> enable or disable warnings\n"
"\n"
"For help, use `man rgbasm' or go to https://rgbds.gbdev.io/docs/\n",
stderr
"For help, use `man rgbasm' or go to https://rgbds.gbdev.io/docs/\n"
);
}
// LCOV_EXCL_STOP
[[gnu::format(printf, 1, 2), noreturn]]
static void fatalWithUsage(char const *fmt, ...) {
va_list ap;
fputs("FATAL: ", stderr);
va_start(ap, fmt);
vfprintf(stderr, fmt, ap);
va_end(ap);
putc('\n', stderr);
printUsage();
exit(1);
}
// clang-format on
// Parse a comma-separated string of '-s/--state' features
static std::vector<StateFeature> parseStateFeatures(char *str) {
@@ -218,10 +203,7 @@ int main(int argc, char *argv[]) {
break;
case 'h':
// LCOV_EXCL_START
printUsage();
exit(0);
// LCOV_EXCL_STOP
usage.printAndExit(0); // LCOV_EXCL_LINE
case 'I':
fstk_AddIncludePath(musl_optarg);
@@ -382,10 +364,7 @@ int main(int argc, char *argv[]) {
// Unrecognized options
default:
// LCOV_EXCL_START
printUsage();
exit(1);
// LCOV_EXCL_STOP
usage.printAndExit(1); // LCOV_EXCL_LINE
}
}
@@ -394,9 +373,9 @@ int main(int argc, char *argv[]) {
}
if (argc == musl_optind) {
fatalWithUsage("Please specify an input file (pass `-` to read from standard input)");
usage.printAndExit("Please specify an input file (pass `-` to read from standard input)");
} else if (argc != musl_optind + 1) {
fatalWithUsage("More than one input file specified");
usage.printAndExit("More than one input file specified");
}
std::string mainFileName = argv[musl_optind];

39
src/fix/main.cpp
View File

@@ -16,6 +16,7 @@
#include "extern/getopt.hpp"
#include "helpers.hpp"
#include "platform.hpp"
#include "usage.hpp"
#include "version.hpp"
#include "fix/mbc.hpp"
@@ -57,9 +58,8 @@ static option const longopts[] = {
{nullptr, no_argument, nullptr, 0 }
};
// LCOV_EXCL_START
static void printUsage() {
fputs(
// clang-format off: long string literal
static Usage usage(
"Usage: rgbfix [-hjOsVvw] [-C | -c] [-f <fix_spec>] [-i <game_id>] [-k <licensee>]\n"
" [-L <logo_file>] [-l <licensee_byte>] [-m <mbc_type>]\n"
" [-n <rom_version>] [-p <pad_value>] [-r <ram_size>] [-t <title_str>]\n"
@@ -73,24 +73,9 @@ static void printUsage() {
" -V, --version print RGBFIX version and exit\n"
" -v, --validate fix the header logo and both checksums (-f lhg)\n"
"\n"
"For help, use `man rgbfix' or go to https://rgbds.gbdev.io/docs/\n",
stderr
"For help, use `man rgbfix' or go to https://rgbds.gbdev.io/docs/\n"
);
}
// LCOV_EXCL_STOP
[[gnu::format(printf, 1, 2), noreturn]]
static void fatalWithUsage(char const *fmt, ...) {
va_list ap;
fputs("FATAL: ", stderr);
va_start(ap, fmt);
vfprintf(stderr, fmt, ap);
va_end(ap);
putc('\n', stderr);
printUsage();
exit(1);
}
// clang-format on
static uint8_t tpp1Rev[2];
@@ -727,10 +712,7 @@ int main(int argc, char *argv[]) {
break;
case 'h':
// LCOV_EXCL_START
printUsage();
exit(0);
// LCOV_EXCL_STOP
usage.printAndExit(0); // LCOV_EXCL_LINE
case 'i':
gameID = musl_optarg;
@@ -835,10 +817,7 @@ int main(int argc, char *argv[]) {
break;
default:
// LCOV_EXCL_START
printUsage();
exit(1);
// LCOV_EXCL_STOP
usage.printAndExit(1); // LCOV_EXCL_LINE
}
}
@@ -894,11 +873,11 @@ int main(int argc, char *argv[]) {
argv += musl_optind;
if (!*argv) {
fatalWithUsage("Please specify an input file (pass `-` to read from standard input)");
usage.printAndExit("Please specify an input file (pass `-` to read from standard input)");
}
if (outputFilename && argc != musl_optind + 1) {
fatalWithUsage("If `-o` is set then only a single input file may be specified");
usage.printAndExit("If `-o` is set then only a single input file may be specified");
}
bool failed = warnings.nbErrors > 0;

43
src/gfx/main.cpp
View File

@@ -18,6 +18,7 @@
#include "extern/getopt.hpp"
#include "file.hpp"
#include "platform.hpp"
#include "usage.hpp"
#include "version.hpp"
#include "gfx/pal_spec.hpp"
@@ -98,9 +99,8 @@ static option const longopts[] = {
{nullptr, no_argument, nullptr, 0 }
};
// LCOV_EXCL_START
static void printUsage() {
fputs(
// clang-format off: long string literal
static Usage usage(
"Usage: rgbgfx [-r stride] [-ChmOuVXYZ] [-v [-v ...]] [-a <attr_map> | -A]\n"
" [-b <base_ids>] [-c <colors>] [-d <depth>] [-i <tileset_file>]\n"
" [-L <slice>] [-l <base_pal>] [-N <nb_tiles>] [-n <nb_pals>]\n"
@@ -113,24 +113,9 @@ static void printUsage() {
" -u, --unique-tiles optimize out identical tiles\n"
" -V, --version print RGBGFX version and exit\n"
"\n"
"For help, use `man rgbgfx' or go to https://rgbds.gbdev.io/docs/\n",
stderr
"For help, use `man rgbgfx' or go to https://rgbds.gbdev.io/docs/\n"
);
}
// LCOV_EXCL_STOP
[[gnu::format(printf, 1, 2), noreturn]]
static void fatalWithUsage(char const *fmt, ...) {
va_list ap;
fputs("FATAL: ", stderr);
va_start(ap, fmt);
vfprintf(stderr, fmt, ap);
va_end(ap);
putc('\n', stderr);
printUsage();
exit(1);
}
// clang-format on
// Parses a number at the beginning of a string, moving the pointer to skip the parsed characters.
// Returns the provided errVal on error.
@@ -209,13 +194,13 @@ static void skipWhitespace(char *&arg) {
static void registerInput(char const *arg) {
if (!options.input.empty()) {
fatalWithUsage(
usage.printAndExit(
"Input image specified more than once! (first \"%s\", then \"%s\")",
options.input.c_str(),
arg
);
} else if (arg[0] == '\0') { // Empty input path
fatalWithUsage("Input image path cannot be empty");
usage.printAndExit("Input image path cannot be empty");
} else {
options.input = arg;
}
@@ -379,10 +364,7 @@ static char *parseArgv(int argc, char *argv[]) {
}
break;
case 'h':
// LCOV_EXCL_START
printUsage();
exit(0);
// LCOV_EXCL_STOP
usage.printAndExit(0); // LCOV_EXCL_LINE
case 'i':
if (!options.inputTileset.empty()) {
warnx("Overriding input tileset file %s", options.inputTileset.c_str());
@@ -591,10 +573,7 @@ static char *parseArgv(int argc, char *argv[]) {
}
break;
default:
// LCOV_EXCL_START
printUsage();
exit(1);
// LCOV_EXCL_STOP
usage.printAndExit(1); // LCOV_EXCL_LINE
}
}
@@ -818,7 +797,7 @@ int main(int argc, char *argv[]) {
if (autoOptEnabled) {
std::string &image = localOptions.groupOutputs ? options.output : options.input;
if (image.empty()) {
fatalWithUsage(
usage.printAndExit(
"No %s specified",
localOptions.groupOutputs ? "output tile data file" : "input image"
);
@@ -875,7 +854,7 @@ int main(int argc, char *argv[]) {
&& !localOptions.reverse) {
processPalettes();
} else {
fatalWithUsage("No input image specified");
usage.printAndExit("No input image specified");
}
requireZeroErrors();

37
src/link/main.cpp
View File

@@ -15,6 +15,7 @@
#include "itertools.hpp"
#include "platform.hpp"
#include "script.hpp" // Generated from script.y
#include "usage.hpp"
#include "version.hpp"
#include "link/assign.hpp"
@@ -81,9 +82,8 @@ static option const longopts[] = {
{nullptr, no_argument, nullptr, 0 }
};
// LCOV_EXCL_START
static void printUsage() {
fputs(
// clang-format off: long string literal
static Usage usage(
"Usage: rgblink [-dhMtVvwx] [-l script] [-m map_file] [-n sym_file]\n"
" [-O overlay_file] [-o out_file] [-p pad_value]\n"
" [-S spec] <file> ...\n"
@@ -96,24 +96,9 @@ static void printUsage() {
" -x, --nopad disable padding of output binary\n"
" -V, --version print RGBLINK version and exits\n"
"\n"
"For help, use `man rgblink' or go to https://rgbds.gbdev.io/docs/\n",
stderr
"For help, use `man rgblink' or go to https://rgbds.gbdev.io/docs/\n"
);
}
// LCOV_EXCL_STOP
[[gnu::format(printf, 1, 2), noreturn]]
static void fatalWithUsage(char const *fmt, ...) {
va_list ap;
fputs("FATAL: ", stderr);
va_start(ap, fmt);
vfprintf(stderr, fmt, ap);
va_end(ap);
putc('\n', stderr);
printUsage();
exit(1);
}
// clang-format on
enum ScrambledRegion {
SCRAMBLE_ROMX,
@@ -268,10 +253,7 @@ int main(int argc, char *argv[]) {
options.isWRAM0Mode = true;
break;
case 'h':
// LCOV_EXCL_START
printUsage();
exit(0);
// LCOV_EXCL_STOP
usage.printAndExit(0); // LCOV_EXCL_LINE
case 'l':
if (linkerScriptName) {
warnx("Overriding linker script %s", linkerScriptName);
@@ -345,10 +327,7 @@ int main(int argc, char *argv[]) {
options.is32kMode = true;
break;
default:
// LCOV_EXCL_START
printUsage();
exit(1);
// LCOV_EXCL_STOP
usage.printAndExit(1); // LCOV_EXCL_LINE
}
}
@@ -356,7 +335,7 @@ int main(int argc, char *argv[]) {
// If no input files were specified, the user must have screwed up
if (curArgIndex == argc) {
fatalWithUsage("Please specify an input file (pass `-` to read from standard input)");
usage.printAndExit("Please specify an input file (pass `-` to read from standard input)");
}
// Patch the size array depending on command-line options

22
src/usage.cpp Normal file
View File

@@ -0,0 +1,22 @@
// SPDX-License-Identifier: MIT
#include "usage.hpp"
#include <stdio.h>
#include <stdlib.h>
void Usage::printAndExit(int code) const {
fputs(usage, stderr);
exit(code);
}
void Usage::printAndExit(char const *fmt, ...) const {
va_list args;
fputs("FATAL: ", stderr);
va_start(args, fmt);
vfprintf(stderr, fmt, args);
va_end(args);
putc('\n', stderr);
printAndExit(1);
}