format.h 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793
  1. #pragma once
  2. #include <cstdio>
  3. #include <functional>
  4. #include <jvalidate/_macro.h>
  5. #include <cctype>
  6. #include <chrono>
  7. #include <cstddef>
  8. #include <cstring>
  9. #include <ctime>
  10. #include <string>
  11. #include <string_view>
  12. #include <system_error>
  13. #include <unordered_map>
  14. #include <unordered_set>
  15. #include <utility>
  16. #ifdef JVALIDATE_HAS_IDNA
  17. #include <ada/idna/to_unicode.h>
  18. #include <ada/idna/validity.h>
  19. #endif
  20. #include <jvalidate/detail/expect.h>
  21. #include <jvalidate/detail/idna_special_cases.h>
  22. #include <jvalidate/detail/pointer.h>
  23. #include <jvalidate/detail/relative_pointer.h>
  24. #include <jvalidate/detail/string.h>
  25. #include <jvalidate/enum.h>
  26. #include <jvalidate/forward.h>
  27. #define CONSTRUCTS(TYPE) format::ctor_as_valid<detail::TYPE>
  28. #define UTF32(FN) JVALIDATE_IIF(JVALIDATE_HAS_IDNA, format::utf32<format::FN<char32_t>>, nullptr)
  29. namespace jvalidate::format {
  30. bool date(std::string_view dt);
  31. bool time(std::string_view dt);
  32. bool date_time(std::string_view dt);
  33. bool duration(std::string_view dur);
  34. template <typename CharT = char> bool uri(std::basic_string_view<CharT> uri);
  35. template <typename CharT = char> bool uri_reference(std::basic_string_view<CharT> uri);
  36. bool uri_template(std::u32string_view uri);
  37. bool uuid(std::string_view id);
  38. template <typename CharT = char> bool hostname(std::basic_string_view<CharT> name);
  39. bool ipv4(std::string_view ip);
  40. bool ipv6(std::string_view ip);
  41. template <typename CharT = char> bool email(std::basic_string_view<CharT> em);
  42. }
  43. namespace jvalidate::format::detail {
  44. inline bool is_dec(std::string_view s, size_t min = 0, size_t max = std::string_view::npos) {
  45. constexpr char const * g_dec_digits = "0123456789";
  46. return s.find_first_not_of(g_dec_digits) == std::string::npos && s.size() >= min &&
  47. s.size() <= max;
  48. }
  49. inline bool is_hex(std::string_view s) {
  50. constexpr char const * g_hex_digits = "0123456789ABCDEFabcdef";
  51. return s.find_first_not_of(g_hex_digits) == std::string::npos;
  52. }
  53. struct result {
  54. ptrdiff_t consumed;
  55. bool valid;
  56. };
  57. inline bool is_leapyear(int y) { return (y % 400) == 0 || ((y % 4) == 0 && (y % 100) != 0); }
  58. inline bool illegal_date(int y, int m, int d) {
  59. static constexpr int days[] = {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31};
  60. if (is_leapyear(y) && m == 1) {
  61. --d;
  62. }
  63. return d > days[m];
  64. }
  65. inline result date(std::string_view dt) {
  66. struct tm tm;
  67. if (auto end = strptime(dt.data(), "%Y-%m-%d", &tm); end) {
  68. if ((end - dt.data()) != 10 || illegal_date(tm.tm_year + 1900, tm.tm_mon, tm.tm_mday)) {
  69. return {.consumed = 0, .valid = false};
  70. }
  71. return {.consumed = end - dt.data(), .valid = true};
  72. }
  73. return {.consumed = 0L, .valid = false};
  74. }
  75. inline bool is_leapsecond(std::tm tm) {
  76. if (tm.tm_sec != 60) {
  77. return true;
  78. }
  79. #if __cpp_lib_chrono >= 201907L
  80. tm.tm_isdst = -1;
  81. std::chrono::seconds time(std::mktime(&tm));
  82. auto const & leap_seconds = std::chrono::get_tzdb().leap_seconds;
  83. return std::ranges::find(leap_seconds, time) != leap_seconds.end();
  84. #else
  85. return false;
  86. #endif
  87. }
  88. // https://www.rfc-editor.org/rfc/rfc6570.html#section-1.5
  89. inline bool is_uschar(int c) {
  90. using P = std::pair<int, int>;
  91. constexpr std::array data{
  92. P{0xA0, 0xD7FF}, P{0xF900, 0xFDCF}, P{0xFDF0, 0xFFEF}, P{0x10000, 0x1FFFD},
  93. P{0x20000, 0x2FFFD}, P{0x30000, 0x3FFFD}, P{0x40000, 0x4FFFD}, P{0x50000, 0x5FFFD},
  94. P{0x60000, 0x6FFFD}, P{0x70000, 0x7FFFD}, P{0x80000, 0x8FFFD}, P{0x90000, 0x9FFFD},
  95. P{0xA0000, 0xAFFFD}, P{0xB0000, 0xBFFFD}, P{0xC0000, 0xCFFFD}, P{0xD0000, 0xDFFFD},
  96. P{0xE0000, 0xEFFFD},
  97. };
  98. return std::ranges::any_of(data,
  99. [c](auto & pair) { return c >= pair.first && c <= pair.second; });
  100. }
  101. template <typename CharT>
  102. inline bool is_pchar(std::basic_string_view<CharT> part, size_t & pos,
  103. std::string_view extra_valid_chars = ":@") {
  104. constexpr char const * g_hex_digits = "0123456789ABCDEFabcdef";
  105. if (std::isalnum(part[pos]) || is_uschar(part[pos]) ||
  106. std::strchr("-._~!$&'()*+,;=", part[pos])) {
  107. return true;
  108. }
  109. if (part[pos] == '%') {
  110. return pos + 2 < part.size() && std::strchr(g_hex_digits, part[++pos]) &&
  111. std::strchr(g_hex_digits, part[++pos]);
  112. }
  113. return extra_valid_chars.find(part[pos]) != part.npos;
  114. };
  115. inline bool is_uri_template_literal(std::u32string_view part, size_t & pos) {
  116. constexpr char const * g_hex_digits = "0123456789ABCDEFabcdef";
  117. if (part[pos] == '%') {
  118. return pos + 2 < part.size() && std::strchr(g_hex_digits, part[++pos]) &&
  119. std::strchr(g_hex_digits, part[++pos]);
  120. }
  121. return !std::strchr(R"( "'%<>\^`{|}`)", part[pos]) && part[pos] > 0x1F && part[pos] != 0x7F;
  122. }
  123. inline bool is_uri_template_varchar(std::u32string_view part, size_t & pos) {
  124. constexpr char const * g_hex_digits = "0123456789ABCDEFabcdef";
  125. if (part[pos] == '%') {
  126. return pos + 2 < part.size() && std::strchr(g_hex_digits, part[++pos]) &&
  127. std::strchr(g_hex_digits, part[++pos]);
  128. }
  129. return std::isalnum(part[pos]) || part[pos] == '_';
  130. }
  131. inline bool is_uri_template_expression(std::u32string_view part) {
  132. if (part.empty()) {
  133. return false;
  134. }
  135. if (std::strchr("+#./;?&=,!@|", part[0])) {
  136. part.remove_prefix(1);
  137. }
  138. for (size_t pos = part.find(','); !part.empty();
  139. part.remove_prefix(std::min(part.size(), pos)), pos = part.find(',')) {
  140. std::u32string_view varspec = part.substr(0, pos);
  141. std::u32string_view expand;
  142. if (size_t const mod = varspec.find_first_of(U":*"); mod != varspec.npos) {
  143. expand = varspec.substr(mod + 1);
  144. varspec.remove_suffix(expand.size() + 1);
  145. }
  146. if (expand.empty() || expand == U"*") {
  147. // No Modifier, or Explode
  148. } else if (expand.size() > 4 || expand[0] == '0' ||
  149. not std::ranges::all_of(expand, [](char c) { return std::isdigit(c); })) {
  150. return false;
  151. }
  152. for (size_t i = 0; i < varspec.size(); ++i) {
  153. RETURN_UNLESS(is_uri_template_varchar(varspec, i) || (i > 0 && varspec[i] == '.'), false);
  154. }
  155. }
  156. return true;
  157. }
  158. template <typename CharT> bool is_uri_authority(std::basic_string_view<CharT> uri) {
  159. // A URI Authority section MAY contain user info, which is every character up
  160. // to the first "@" character, as long as that character is not part of the path
  161. if (size_t pos = uri.find('@'); pos != uri.npos) {
  162. for (size_t i = 0; i < pos; ++i) {
  163. if (not is_pchar(uri, i, ":")) {
  164. return false;
  165. }
  166. }
  167. uri.remove_prefix(pos + 1);
  168. }
  169. // A URI Authority HOST section
  170. // If the URI starts with '[', then it MUST BE an IPv6 or an "IPvFuture"
  171. bool const has_ipv6 = (uri[0] == '[');
  172. if (has_ipv6) {
  173. size_t pos = uri.find(']');
  174. auto ip = uri.substr(1, pos - 1);
  175. uri.remove_prefix(pos + 1);
  176. if (not ipv6(to_u8(ip))) {
  177. return false;
  178. }
  179. }
  180. // A URI Authority PORT section. Technically allows any number of digits
  181. if (size_t pos = uri.find(':'); pos != uri.npos) {
  182. if (not std::ranges::all_of(uri.substr(pos + 1), [](auto c) { return std::isdigit(c); })) {
  183. return false;
  184. }
  185. uri.remove_suffix(uri.size() - pos + 1);
  186. }
  187. // Normal URI Authority HOST section is either an IPv4 or a HOSTNAME
  188. // if we had an ipv6 part, we can permit an empty string (since hostname
  189. // no longer permits them).
  190. return (has_ipv6 && uri.empty()) || ipv4(to_u8(uri)) || hostname(uri);
  191. }
  192. // Tests if a URI "Query Part" or "Fragment Part" is valid and remove the part
  193. template <typename CharT> bool test_uri_part(std::basic_string_view<CharT> & uri, char delim) {
  194. size_t const pos = uri.find(delim);
  195. if (pos == uri.npos) {
  196. return true;
  197. }
  198. auto part = uri.substr(pos + 1);
  199. uri = uri.substr(0, pos);
  200. for (size_t pos = 0; pos < part.size(); ++pos) {
  201. RETURN_UNLESS(detail::is_pchar(part, pos, ":@/?"), false);
  202. }
  203. return true;
  204. };
  205. }
  206. namespace jvalidate::format::draft03 {
  207. namespace detail = jvalidate::format::detail;
  208. inline bool time(std::string_view dt) {
  209. std::tm tm;
  210. char const * end = strptime(dt.data(), "%T", &tm);
  211. if (end == nullptr || (end - dt.data()) < 8) {
  212. return false;
  213. }
  214. return end == dt.end();
  215. }
  216. inline bool utc_millisec(std::string_view utc) {
  217. int64_t itime;
  218. if (auto [end, ec] = std::from_chars(utc.begin(), utc.end(), itime);
  219. ec == std::errc{} && end == utc.end()) {
  220. return true;
  221. }
  222. double dtime;
  223. auto [end, ec] = std::from_chars(utc.begin(), utc.end(), dtime);
  224. return ec == std::errc{} && end == utc.end();
  225. }
  226. inline bool css_2_1_color(std::string_view color) {
  227. if (color.empty()) {
  228. return false;
  229. }
  230. constexpr char const * g_hex_digits = "0123456789ABCDEFabcdef";
  231. if (color[0] == '#') {
  232. return color.size() <= 7 && detail::is_hex(color.substr(1));
  233. }
  234. static std::unordered_set<std::string_view> g_color_codes{
  235. "maroon", "red", "orange", "yellow", "olive", "purple", "fuchsia", "white", "lime",
  236. "green", "navy", "blue", "aqua", "teal", "black", "silver", "gray"};
  237. return g_color_codes.contains(color);
  238. }
  239. inline bool e_123_phone(std::string_view phone) {
  240. // https://support.secureauth.com/hc/en-us/articles/360036402211-Regular-Expressions-for-ITU-E-123-and-E-164-phone-number-formats
  241. if (phone.empty()) {
  242. return false;
  243. }
  244. if (phone[0] != '+') {
  245. constexpr size_t g_usa_phone_tokens = 3;
  246. char area[4], head[4], tail[5];
  247. return sscanf(phone.data(), "(%3s) %3s %4s", area, head, tail) == g_usa_phone_tokens &&
  248. detail::is_dec(area, 3) && detail::is_dec(head, 3) && detail::is_dec(tail, 4);
  249. }
  250. char tok0[4], tok1[4], tok2[4], tok3[5];
  251. constexpr size_t g_i18n_phone_tokens = 4;
  252. return sscanf(phone.data(), "+%3s %3s %3s %4s", tok0, tok1, tok2, tok3) == g_i18n_phone_tokens &&
  253. detail::is_dec(tok0, 1, 3) && detail::is_dec(tok1, 2, 3) && detail::is_dec(tok2, 2, 3) &&
  254. detail::is_dec(tok3, 4);
  255. }
  256. }
  257. namespace jvalidate::format {
  258. inline bool date(std::string_view dt) {
  259. auto [consumed, valid] = detail::date(dt);
  260. return valid && consumed == dt.size();
  261. }
  262. inline bool time(std::string_view dt) {
  263. std::tm tm;
  264. char const * end = strptime(dt.data(), "%T", &tm);
  265. if (end == nullptr || end == dt.end() || (end - dt.data()) < 8) {
  266. return false;
  267. }
  268. dt.remove_prefix(end - dt.begin());
  269. if (dt[0] == '.') {
  270. dt.remove_prefix(1);
  271. if (dt.empty() || not std::isdigit(dt[0])) {
  272. return false;
  273. }
  274. while (std::isdigit(dt[0])) {
  275. dt.remove_prefix(1);
  276. }
  277. }
  278. if (dt[0] == 'Z' || dt[0] == 'z') {
  279. return dt.size() == 1 && detail::is_leapsecond(tm);
  280. }
  281. if (std::strchr("+-", dt[0])) {
  282. return strptime(dt.data() + 1, "%R", &tm) == dt.end() && detail::is_leapsecond(tm);
  283. }
  284. return false;
  285. }
  286. inline bool date_time(std::string_view dt) {
  287. auto [size, good] = detail::date(dt);
  288. if (not good || std::strchr("Tt", dt[size]) == nullptr) {
  289. return false;
  290. }
  291. dt.remove_prefix(size + 1);
  292. return time(dt);
  293. }
  294. template <typename CharT> inline bool uri(std::basic_string_view<CharT> uri) {
  295. using delim = detail::char_delimiters<CharT>;
  296. // https://www.rfc-editor.org/rfc/rfc3986.html#appendix-A
  297. if (size_t const pos = uri.find(':'); pos != uri.npos) {
  298. RETURN_UNLESS(std::isalpha(uri[0]), false);
  299. for (size_t i = 1; i < pos; ++i) {
  300. RETURN_UNLESS(std::isalnum(uri[i]) || std::strchr("+-.", uri[i]), false);
  301. }
  302. uri.remove_prefix(pos + 1);
  303. } else {
  304. return false;
  305. }
  306. RETURN_UNLESS(detail::test_uri_part(uri, '#'), false);
  307. RETURN_UNLESS(detail::test_uri_part(uri, '?'), false);
  308. auto path = uri;
  309. if (uri.starts_with(delim::double_slash)) {
  310. uri.remove_prefix(2);
  311. path = uri.substr(std::min(uri.size(), uri.find('/')));
  312. uri.remove_suffix(path.size());
  313. RETURN_UNLESS(detail::is_uri_authority(uri), false);
  314. }
  315. for (size_t i = 0; i < path.size(); ++i) {
  316. RETURN_UNLESS(detail::is_pchar(path, i, "/:@"), false);
  317. }
  318. return true;
  319. }
  320. template <typename CharT> inline bool uri_reference(std::basic_string_view<CharT> uri) {
  321. using delim = detail::char_delimiters<CharT>;
  322. if (jvalidate::format::uri(uri)) {
  323. return true;
  324. }
  325. RETURN_UNLESS(detail::test_uri_part(uri, '#'), false);
  326. RETURN_UNLESS(detail::test_uri_part(uri, '?'), false);
  327. auto path = uri;
  328. if (uri.starts_with(delim::double_slash)) {
  329. uri.remove_prefix(2);
  330. path = uri.substr(std::min(uri.size(), uri.find('/')));
  331. uri.remove_suffix(path.size());
  332. RETURN_UNLESS(detail::is_uri_authority(uri), false);
  333. }
  334. if (size_t const pos = path.find('/'); pos != path.npos) {
  335. for (size_t i = 0; i < pos; ++i) {
  336. RETURN_UNLESS(detail::is_pchar(path, i, "@"), false);
  337. }
  338. path.remove_prefix(pos);
  339. }
  340. for (size_t i = 0; i < path.size(); ++i) {
  341. RETURN_UNLESS(detail::is_pchar(path, i, "/:@"), false);
  342. }
  343. return true;
  344. }
  345. inline bool uri_template(std::u32string_view uri) {
  346. for (size_t i = 0; i < uri.size(); ++i) {
  347. if (uri[i] != '{') {
  348. RETURN_UNLESS(detail::is_uri_template_literal(uri, i), false);
  349. continue;
  350. }
  351. std::u32string_view expr = uri.substr(i + 1);
  352. size_t const pos = expr.find('}');
  353. RETURN_UNLESS(pos != uri.npos, false);
  354. RETURN_UNLESS(detail::is_uri_template_expression(expr.substr(0, pos)), false);
  355. i += pos + 1;
  356. }
  357. return true;
  358. }
  359. inline bool uuid(std::string_view id) {
  360. constexpr size_t g_uuid_len = 36;
  361. constexpr size_t g_uuid_tokens = 5;
  362. char tok0[9], tok1[5], tok2[5], tok3[5], tok4[13];
  363. return id.size() == g_uuid_len &&
  364. sscanf(id.data(), "%8s-%4s-%4s-%4s-%12s", tok0, tok1, tok2, tok3, tok4) == g_uuid_tokens &&
  365. detail::is_hex(tok0) && detail::is_hex(tok1) && detail::is_hex(tok2) &&
  366. detail::is_hex(tok3) && detail::is_hex(tok4);
  367. }
  368. inline bool duration(std::string_view dur) {
  369. auto eat = [&dur](std::string_view text) {
  370. char type;
  371. unsigned int rep;
  372. if (sscanf(dur.data(), "%u%c", &rep, &type) != 2 || text.find(type) == std::string::npos) {
  373. return std::string::npos;
  374. }
  375. dur.remove_prefix(dur.find(type) + 1);
  376. return text.find(type);
  377. };
  378. // All DURATION entities must start with the prefix 'P', and cannot be empty
  379. // past that point.
  380. if (dur[0] != 'P' || dur.size() == 1) {
  381. return false;
  382. }
  383. dur.remove_prefix(1);
  384. // Special Case: a duration measured in weeks is incompatible with other
  385. // duration tokens.
  386. if (eat("W") != std::string::npos) {
  387. return dur.empty();
  388. }
  389. // DURATION takes the following form, because we use the same token for both
  390. // Months and Minutes.
  391. // "P[#Y][#M][#D][T[#H][#M][#S]]".
  392. // At least one of the optional fields must be present.
  393. if (dur[0] != 'T') {
  394. std::string_view ymd{"YMD"};
  395. // Read YMD duration offsets in that order, allowing us to skip past them.
  396. while (not ymd.empty() && not dur.empty()) {
  397. if (size_t n = eat(ymd); n != std::string::npos) {
  398. ymd.remove_prefix(n + 1);
  399. } else {
  400. return false;
  401. }
  402. }
  403. if (dur.empty()) {
  404. return true;
  405. }
  406. }
  407. // If we have a 'T' prefix for Hour/Minute/Second offsets, we must have at
  408. // least one of them present.
  409. if (dur[0] != 'T' || dur.size() == 1) {
  410. return false;
  411. }
  412. dur.remove_prefix(1);
  413. std::string_view hms{"HMS"};
  414. // Read HMS duration offsets in that order, allowing us to skip past them.
  415. while (not hms.empty() && not dur.empty()) {
  416. if (size_t n = eat(hms); n != std::string::npos) {
  417. hms.remove_prefix(n + 1);
  418. } else {
  419. return false;
  420. }
  421. }
  422. return dur.empty();
  423. }
  424. template <typename CharT>
  425. bool is_invalid_size_or_boundary_hostname(std::basic_string_view<CharT> name) {
  426. using delim = detail::char_delimiters<CharT>;
  427. return (name.empty() || name.length() >= 64 ||
  428. (name.size() >= 4 && name.substr(2).starts_with(delim::illegal_dashes_ulabel)) ||
  429. name[0] == '-' || name.back() == '-');
  430. }
  431. #if !JVALIDATE_HAS_IDNA
  432. inline bool hostname_part(std::string_view name) {
  433. using delim = detail::char_delimiters<char>;
  434. if (is_invalid_size_or_boundary_hostname(name)) {
  435. return false;
  436. }
  437. return std::ranges::none_of(name, [](char c) { return c != '-' && not std::isalnum(c); });
  438. }
  439. #else
  440. template <typename CharT> inline bool hostname_part(std::basic_string_view<CharT> name) {
  441. using delim = detail::char_delimiters<CharT>;
  442. // Punycode is a way to restructure UTF-8 strings to be ASCII compatibly
  443. // All Punycode string start with "xn--" (and would therefore fail below).
  444. if (name.starts_with(delim::punycode_prefix)) {
  445. std::u32string decoded = detail::to_u32(ada::idna::to_unicode(detail::to_u8(name)));
  446. return (decoded != detail::to_u32(name)) && hostname_part<char32_t>(decoded);
  447. }
  448. // Unfortunately, the ada-idna library does not validate things like
  449. // "is there a HEBREW character after the HEBREW COMMA".
  450. if (not detail::is_special_case_ok(name)) {
  451. return false;
  452. }
  453. if (name.find_first_of(delim::illegal_hostname_chars) != name.npos) {
  454. return false;
  455. }
  456. // An INVALID hostname part is one of the following:
  457. // - empty
  458. // - more than 63 characters long
  459. // - starts or ends with a '-'
  460. // - matches the regular expression /^..--.*$/
  461. if (is_invalid_size_or_boundary_hostname(name)) {
  462. return false;
  463. }
  464. // This is a much easier check in hostname than idn-hostname, since we can
  465. // just check for alphanumeric and '-'.
  466. if constexpr (std::is_same_v<char, CharT>) {
  467. return std::ranges::none_of(name, [](char c) { return c != '-' && not std::isalnum(c); });
  468. } else {
  469. return ada::idna::is_label_valid(name);
  470. }
  471. }
  472. #endif
  473. template <typename CharT> inline bool hostname(std::basic_string_view<CharT> name) {
  474. using delim = detail::char_delimiters<CharT>;
  475. // In general, the maximum length of a hostname is 253 characters.
  476. if (name.empty() || name.length() > 253) {
  477. return false;
  478. }
  479. // We validate each sub-section of the hostname in parts, delimited by '.'
  480. for (size_t n = name.find_first_of(delim::hostname_part_delims); n != std::string::npos;
  481. name.remove_prefix(n + 1), n = name.find_first_of(delim::hostname_part_delims)) {
  482. if (not hostname_part(name.substr(0, n))) {
  483. return false;
  484. }
  485. }
  486. // Previous test versions allowed for a hostname to end with '.', but this is
  487. // not permitted in the latest test specification.
  488. return hostname_part(name);
  489. }
  490. inline bool ipv4(std::string_view ip) {
  491. unsigned int ip0, ip1, ip2, ip3;
  492. char eof;
  493. // IPv4 address MAY only contain DIGITS and '.'
  494. if (ip.find_first_not_of("0123456789.") != ip.npos) {
  495. return false;
  496. }
  497. // Each OCTET of an IPv4 can only start with '0' if it is EXACTLY '0'
  498. if (ip[0] == '0' && std::isdigit(ip[1])) {
  499. return false;
  500. }
  501. if (size_t n = ip.find(".0"); n != ip.npos && std::isdigit(ip[n + 2])) {
  502. return false;
  503. }
  504. // sscanf returns the number of tokens parsed successfully.
  505. // Therefore, we can add a trailing character output to the format-string
  506. // and check that we failed to parse any token into the eof-character token.
  507. if (sscanf(std::string(ip).c_str(), "%3u.%3u.%3u.%3u%c", &ip0, &ip1, &ip2, &ip3, &eof) != 4) {
  508. return false;
  509. }
  510. // Affirm that each OCTET is only two bytes wide.
  511. return ip0 <= 0xFF && ip1 <= 0xFF && ip2 <= 0xFF && ip3 <= 0xFF;
  512. }
  513. inline bool ipv6(std::string_view ip) {
  514. int expected_spans = 8;
  515. // There is a special rule with IPv6 to allow an IPv4 address as a suffix
  516. if (size_t n = ip.find('.'); n != std::string::npos) {
  517. if (not ipv4(ip.substr(ip.find_last_of(':') + 1))) {
  518. return false;
  519. }
  520. // since ipv4 addresses contain 8 bytes of information, and each segment of
  521. // an ipv6 address contains 4 bytes - we should reduce the number of
  522. // expected spans to 6. Instead - we reduce it to 7 because we don't prune
  523. // the first OCTET of the IPv4 section (as it can read as a valid segment).
  524. expected_spans = 7;
  525. ip = ip.substr(0, n);
  526. }
  527. // IPv6 address MAY only contain HEXDIGITs and ':'
  528. if (ip.find_first_not_of("0123456789ABCDEFabcdef:") != std::string::npos) {
  529. return false;
  530. }
  531. // IPv6 addresses can have a maximum of 39 characters (8 4-char HEXDIGIT
  532. // segments with 7 dividing ':'s).
  533. if (ip.size() >= 40) {
  534. return false;
  535. }
  536. bool has_compressed = false;
  537. int groups = 0;
  538. if (ip.starts_with("::")) {
  539. has_compressed = true;
  540. ip.remove_prefix(2);
  541. }
  542. while (!ip.empty() && ++groups) {
  543. int data;
  544. if (sscanf(ip.data(), "%4x", &data) != 1) {
  545. // Not a 4-byte HEXDIGIT. Not sure that it's ever possible due to the
  546. // char filter above.
  547. return false;
  548. }
  549. if (size_t const n = ip.find(':'); std::min(n, ip.size()) > 4) {
  550. return false; // Segment too wide
  551. } else if (n != std::string::npos) {
  552. ip.remove_prefix(n + 1);
  553. } else {
  554. break; // End of String
  555. }
  556. // We removed the regular ':', so this is a check for a compression mark
  557. if (ip[0] != ':') {
  558. continue;
  559. }
  560. if (std::exchange(has_compressed, true)) {
  561. // The above trick allows us to ensure that there is no more than one
  562. // set of "::" compression tokens in this IPv6 adfress.
  563. return false;
  564. }
  565. ip.remove_prefix(1);
  566. }
  567. return groups == expected_spans || (has_compressed && groups < expected_spans);
  568. }
  569. // Let's be honest - no matter what RFC 5321 §4.1.2 or RFC 6531 say, the only
  570. // way to know if an email address is valid is to try and send a message to it.
  571. // Therefore, there's no point in trying to validate things according to a
  572. // complex grammar - as long as it has an '@' sign with at least one character
  573. // on each side, we ought to call it an email.
  574. template <typename CharT> inline bool email(std::basic_string_view<CharT> em) {
  575. using delim = detail::char_delimiters<CharT>;
  576. size_t const n = em.find_last_of('@');
  577. if (n == 0 || n >= em.size() - 1) {
  578. return false;
  579. }
  580. auto const who = em.substr(0, n);
  581. if (who.starts_with('"') && who.ends_with('"')) {
  582. // No validation
  583. } else if (who.starts_with('.') || who.ends_with('.')) {
  584. return false;
  585. } else if (em.substr(0, n).find(delim::dotdot) != em.npos) {
  586. return false;
  587. } else if (who.find('@') != em.npos) {
  588. // This will catch multiple emails, but will gracefully ignore quote-escaped
  589. // '@' characters in the name element.
  590. return false;
  591. }
  592. // The DOMAIN section of an email address MAY be either a HOSTNAME, or an
  593. // IP Address surrounded in brackets.
  594. auto domain = em.substr(n + 1);
  595. if (not(domain.starts_with('[') && domain.ends_with(']'))) {
  596. return hostname(domain);
  597. }
  598. domain.remove_prefix(1);
  599. domain.remove_suffix(1);
  600. // When the DOMAIN is an IPv6, it must start with "IPv6:" for some
  601. // weird compatibility reason.
  602. if (auto ip = detail::to_u8(domain); ip.starts_with("IPv6:")) {
  603. return ipv6(ip.substr(5));
  604. } else {
  605. return ipv4(ip);
  606. }
  607. }
  608. template <typename T> inline bool ctor_as_valid(std::string_view str) {
  609. try {
  610. [[maybe_unused]] auto _ = T(str);
  611. return true;
  612. } catch (std::exception const &) { return false; }
  613. }
  614. template <auto Predicate> bool utf32(std::string_view str) {
  615. return Predicate(detail::to_u32(str));
  616. }
  617. }
  618. namespace jvalidate {
  619. class FormatValidator {
  620. public:
  621. using StatelessPredicate = bool (*)(std::string_view);
  622. using Predicate = std::function<bool(std::string_view)>;
  623. using UserDefinedFormats = std::unordered_map<std::string, Predicate>;
  624. enum class Status { Unknown, Unimplemented, Valid, Invalid };
  625. private:
  626. // This isn't actually a user format, but we don't generate any special
  627. // annotations for user-defined format codes, so it doesn't really matter that
  628. // we're putting it here. It simply reduces the number of LoC when setting up.
  629. std::unordered_map<std::string, Predicate> formats_{{"regex", nullptr}};
  630. std::unordered_map<std::string, StatelessPredicate> builtin_formats_{
  631. {"date", &format::date},
  632. {"date-time", &format::date_time},
  633. {"duration", &format::duration},
  634. {"email", &format::email},
  635. {"hostname", &format::hostname},
  636. {"idn-email", UTF32(email)},
  637. {"idn-hostname", UTF32(hostname)},
  638. {"ipv4", &format::ipv4},
  639. {"ipv6", &format::ipv6},
  640. {"iri", UTF32(uri)},
  641. {"iri-reference", UTF32(uri_reference)},
  642. {"json-pointer", CONSTRUCTS(Pointer)},
  643. {"relative-json-pointer", CONSTRUCTS(RelativePointer)},
  644. {"time", &format::time},
  645. {"uri", &format::uri},
  646. {"uri-reference", &format::uri_reference},
  647. {"uri-template", &format::utf32<format::uri_template>},
  648. {"uuid", &format::uuid},
  649. };
  650. std::unordered_map<std::string, StatelessPredicate> draft03_formats_{
  651. {"date", &format::date},
  652. // One of the weird things about draft03 - date-time allows for timezone
  653. // and fraction-of-second in the argument, but time only allows hh:mm:ss.
  654. {"date-time", &format::date_time},
  655. {"time", &format::draft03::time},
  656. {"utc-millisec", &format::draft03::utc_millisec},
  657. {"color", &format::draft03::css_2_1_color},
  658. {"style", nullptr},
  659. {"phone", &format::draft03::e_123_phone},
  660. {"uri", &format::uri},
  661. {"email", &format::email},
  662. {"ip-address", &format::ipv4},
  663. {"ipv6", &format::ipv6},
  664. {"host-name", &format::hostname},
  665. };
  666. public:
  667. FormatValidator() = default;
  668. FormatValidator(Predicate is_regex) { formats_.insert_or_assign("regex", is_regex); }
  669. FormatValidator(UserDefinedFormats const & formats, Predicate is_regex) : formats_(formats) {
  670. formats_.insert_or_assign("regex", is_regex);
  671. }
  672. Status operator()(std::string const & format, schema::Version for_version,
  673. std::string_view text) const {
  674. auto const & supported =
  675. for_version == schema::Version::Draft03 ? draft03_formats_ : builtin_formats_;
  676. if (Status rval = (*this)(supported, format, text); rval != Status::Unknown) {
  677. return rval;
  678. }
  679. return (*this)(formats_, format, text);
  680. }
  681. private:
  682. Status operator()(auto const & supported, std::string const & format,
  683. std::string_view text) const {
  684. if (auto it = supported.find(format); it != supported.end()) {
  685. if (not it->second) {
  686. return Status::Unimplemented;
  687. }
  688. return it->second(text) ? Status::Valid : Status::Invalid;
  689. }
  690. return Status::Unknown;
  691. }
  692. };
  693. }
  694. #undef CONSTRUCTS
  695. #undef UTF32