/* * uriparser - RFC 3986 URI parsing library * * Copyright (C) 2025, Sebastian Pipping * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #undef NDEBUG // because we rely on assert(3) further down #include #include #include namespace { static void testIsWellFormedFragment(const char * candidate, bool expectedWellFormed) { const char * const first = candidate; const char * const afterLast = (candidate == NULL) ? NULL : (candidate + strlen(candidate)); const UriBool actualWellFormed = uriIsWellFormedFragmentA(first, afterLast); ASSERT_EQ(actualWellFormed, expectedWellFormed); } static UriUriA parseWellFormedUri(const char * text) { UriUriA uri; const int error = uriParseSingleUriA(&uri, text, NULL); // NOTE: we cannot use ASSERT_EQ here because of the outer non-void return type assert(error == URI_SUCCESS); return uri; } static void assertUriEqual(const UriUriA * uri, const char * expected) { int charsRequired = -1; ASSERT_EQ(uriToStringCharsRequiredA(uri, &charsRequired), URI_SUCCESS); ASSERT_TRUE(charsRequired >= 0); char * const buffer = (char *)malloc(charsRequired + 1); ASSERT_TRUE(buffer != NULL); ASSERT_EQ(uriToStringA(buffer, uri, charsRequired + 1, NULL), URI_SUCCESS); EXPECT_STREQ(buffer, expected); free(buffer); } } // namespace TEST(IsWellFormedFragment, Null) { testIsWellFormedFragment(NULL, false); } TEST(IsWellFormedFragment, Empty) { testIsWellFormedFragment("", true); } TEST(IsWellFormedFragment, AllowedCharacters) { // The related grammar subset is this: // // fragment = *( pchar / "/" / "?" ) // pchar = unreserved / pct-encoded / sub-delims / ":" / "@" // unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~" // pct-encoded = "%" HEXDIG HEXDIG // sub-delims = "!" / "$" / "&" / "'" / "(" / ")" // / "*" / "+" / "," / ";" / "=" // // NOTE: Percent encoding has dedicated tests further down testIsWellFormedFragment("0123456789" "ABCDEF" "abcdef" "gGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ" "-._~" "!$&'()*+,;=" ":@" "/?", true); } TEST(IsWellFormedFragment, ForbiddenCharacters) { testIsWellFormedFragment(" ", false); } TEST(IsWellFormedFragment, PercentEncodingWellFormed) { testIsWellFormedFragment("%" "aa" "%" "AA", true); } TEST(IsWellFormedFragment, PercentEncodingMalformedCutOff1) { testIsWellFormedFragment("%", false); } TEST(IsWellFormedFragment, PercentEncodingMalformedCutOff2) { testIsWellFormedFragment("%" "a", false); } TEST(IsWellFormedFragment, PercentEncodingMalformedForbiddenCharacter1) { testIsWellFormedFragment("%" "ga", false); } TEST(IsWellFormedFragment, PercentEncodingMalformedForbiddenCharacter2) { testIsWellFormedFragment("%" "ag", false); } TEST(SetFragment, NullUriOnly) { UriUriA * const uri = NULL; const char * const first = "toc"; const char * const afterLast = first + strlen(first); ASSERT_EQ(uriSetFragmentA(uri, first, afterLast), URI_ERROR_NULL); } TEST(SetFragment, NullFirstOnly) { UriUriA uri = {}; const char * const fragment = "toc"; const char * const first = NULL; const char * const afterLast = fragment + strlen(fragment); ASSERT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_ERROR_NULL); } TEST(SetFragment, NullAfterLastOnly) { UriUriA uri = {}; const char * const first = "toc"; const char * const afterLast = NULL; ASSERT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_ERROR_NULL); } TEST(SetFragment, NullValueLeavesOwnerAtFalse) { UriUriA uri = parseWellFormedUri("scheme://host/#fragment"); EXPECT_EQ(uri.owner, URI_FALSE); // self-test EXPECT_EQ(uriSetFragmentA(&uri, NULL, NULL), URI_SUCCESS); EXPECT_EQ(uri.owner, URI_FALSE); // i.e. still false uriFreeUriMembersA(&uri); } TEST(SetFragment, NonNullValueMakesOwner) { UriUriA uri = parseWellFormedUri("scheme://host/#old"); const char * const first = "new"; const char * const afterLast = first + strlen(first); EXPECT_EQ(uri.owner, URI_FALSE); // self-test EXPECT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_SUCCESS); EXPECT_EQ(uri.owner, URI_TRUE); // i.e. now owned uriFreeUriMembersA(&uri); } TEST(SetFragment, NullValueApplied) { UriUriA uri = parseWellFormedUri("scheme://host/#fragment"); EXPECT_EQ(uriSetFragmentA(&uri, NULL, NULL), URI_SUCCESS); assertUriEqual(&uri, "scheme://host/"); uriFreeUriMembersA(&uri); } TEST(SetFragment, NonNullValueAppliedEmpty) { UriUriA uri = parseWellFormedUri("scheme://host/#fragment"); const char * const empty = ""; EXPECT_EQ(uriSetFragmentA(&uri, empty, empty), URI_SUCCESS); assertUriEqual(&uri, "scheme://host/#"); uriFreeUriMembersA(&uri); } TEST(SetFragment, NonNullValueAppliedNonEmpty) { UriUriA uri = parseWellFormedUri("scheme://host/#old"); const char * const first = "new"; const char * const afterLast = first + strlen(first); EXPECT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_SUCCESS); assertUriEqual(&uri, "scheme://host/#new"); uriFreeUriMembersA(&uri); } TEST(SetFragment, MalformedValueRejected) { UriUriA uri = parseWellFormedUri("scheme://host/#fragment"); const char * const first = "not well-formed"; const char * const afterLast = first + strlen(first); EXPECT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_ERROR_SYNTAX); uriFreeUriMembersA(&uri); } TEST(SetFragment, UriWithoutHostTolerated) { UriUriA uri = parseWellFormedUri("/no/host/here"); const char * const first = "toc"; const char * const afterLast = first + strlen(first); EXPECT_TRUE(uri.hostText.first == NULL); // self-test EXPECT_EQ(uriSetFragmentA(&uri, first, afterLast), URI_SUCCESS); assertUriEqual(&uri, "/no/host/here#toc"); uriFreeUriMembersA(&uri); }