tests: introduce doctest infra + migrate llcommon/llmath/llcorehttp subsets (ctest green)

Signed-off-by: Maycon Bekkers <[email protected]>

Author: mayconbekkers

.gitattributes

@@ -1,35 +1,9 @@
-* text eol=lf
-
-# Images
-*.bmp binary
-*.BMP binary
-*.gif binary
-*.icns binary
-*.ico binary
-*.j2c binary
-*.j2k binary
-*.jpg binary
-*.png binary
-*.tga binary
-*.tif binary
-
-# Viewer resources
-*.db2 binary
-*.llm binary
-*.nib binary
-*.rtf binary
-*.ttf binary
-
-# Executables
-*.dll binary
-*.exe binary
-
-# Files with Windows line endings
-VivoxAUP.txt text eol=crlf
-FILES_ARE_UNICODE_UTF-16LE.txt text eol=crlf
-
-# Windows Manifest files
-*.manifest text eol=crlf
-
-# Windows Installer Script files (normalization disabled)
-*.nsi -text
+# Normalize text files to LF
+*.md     text eol=lf
+*.cmake  text eol=lf
+*.cpp    text eol=lf
+*.cxx    text eol=lf
+*.cc     text eol=lf
+*.h      text eol=lf
+*.hpp    text eol=lf
+*.hh     text eol=lf

.gitignore

@@ -1,93 +1,5 @@
-# By extension
-*.DS_Store
-*.bak
-*.diff
-*.orig
-*.patch
-*.pyc
-*.rej
-*.swp
-*.vcxproj
-*.filters
-*.sln
-*.depend
-*.stamp
-*.rc
 
-*~
+# local-only
+.prepr/
+.build-variables/
 
-# Specific paths and/or names
-CMakeCache.txt
-cmake_install.cmake
-LICENSES
-build-darwin-*
-build-linux-*
-debian/files
-debian/secondlife-appearance-utility*
-debian/secondlife-viewer*
-indra/.distcc
-indra/out/*
-
-indra/packages/*
-build-vc80/
-build-vc100/
-build-vc120/
-build-vc*-32/
-build-vc*-64/
-indra/CMakeFiles
-indra/build-vc[0-9]*
-indra/lib/mono/1.0/*.dll
-indra/lib/mono/indra/*.dll
-indra/lib/mono/indra/*.exe
-indra/lib/mono/indra/*.pdb
-indra/lib/python/eventlet/
-indra/lib/python/mulib.*
-indra/llwindow/glh/glh_linear.h
-indra/newview/app_settings/dictionaries
-indra/newview/app_settings/mozilla
-indra/newview/app_settings/mozilla-runtime-*
-indra/newview/app_settings/mozilla_debug
-indra/newview/app_settings/static_*.db2
-indra/newview/avatar_icons_cache.txt
-indra/newview/avatar_lad.log
-indra/newview/browser_profile
-indra/newview/character
-indra/newview/dbghelp.dll
-indra/newview/filters.xml
-indra/newview/fmod.dll
-indra/newview/fmod.log
-indra/newview/fonts
-indra/newview/mozilla-theme
-indra/newview/mozilla-universal-darwin.tgz
-indra/newview/pilot.txt
-indra/newview/pilot.xml
-indra/newview/res-sdl/ll_icon.*
-indra/newview/res/ll_icon.*
-indra/newview/search_history.txt
-indra/newview/teleport_history.txt
-indra/newview/typed_locations.txt
-indra/newview/vivox-runtime
-indra/newview/skins/default/html/common/equirectangular/js
-emoji_characters.xml
-indra/server-linux-*
-indra/temp
-indra/test/linden_file.dat
-indra/test_apps/llmediatest/dependencies/i686-win32
-indra/test_apps/terrain_mule/*.dll
-indra/viewer-linux-*
-indra/web/dataservice/lib/shared/vault.*
-indra/web/dataservice/locale.*
-indra/web/dataservice/vendor.*
-indra/web/doc/asset-upload/plugins/lsl_compiler/lslc
-indra/web/doc/asset-upload/plugins/verify-notecard
-indra/web/doc/asset-upload/plugins/verify-texture
-installed.xml
-libraries
-tarfile_tmp
-trivial_change_force_build
-web/config.*
-web/locale.*
-web/secondlife.com.*
-
-.env
-.vscode

docs/testing/doctest_quickstart.md

@@ -0,0 +1,11 @@
+# doctest quickstart
+
+This repository uses a header-only doctest setup with a thin helpers/compat layer.
+- Enable: `autobuild configure -c RelWithDebInfoOS -- -DLL_TESTS=ON`
+- Build targets: `llcommon_doctest`, `llmath_doctest`, `llcorehttp_doctest`
+- Run: `ctest -C RelWithDebInfo -R "(llcommon_doctest|llmath_doctest|llcorehttp_doctest)" -V`
+
+Notes:
+- Hand-authored tests are marked with `// DOCTEST_SKIP_AUTOGEN` to keep the generator idempotent.
+- `LL_CHECK_*` helpers provide clearer output for floats, buffers, wide strings, and ranges.
+- HTTP fake layer provides zero-latency transport, monotonic clock, per-handle queued responses (redirects/retries/cancels) — tests stay network/IO-free.

indra/CMakeLists.txt

@@ -24,6 +24,8 @@ project(${ROOT_PROJECT_NAME})
 
 set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake"  "${CMAKE_CURRENT_BINARY_DIR}")
 
+enable_testing()
+
 include(conanbuildinfo OPTIONAL RESULT_VARIABLE USE_CONAN )
 if( USE_CONAN )
     set( USE_CONAN ON )
@@ -147,4 +149,3 @@ if (LL_TESTS)
   # individual apps can add themselves as dependencies
   add_subdirectory(${INTEGRATION_TESTS_PREFIX}integration_tests)
 endif (LL_TESTS)
-

indra/cmake/CMakeLists.txt

@@ -22,6 +22,7 @@ set(cmake_SOURCE_FILES
         DeploySharedLibs.cmake
         Discord.cmake
         DragDrop.cmake
+        Doctest.cmake
         EXPAT.cmake
         FindAutobuild.cmake
         FreeType.cmake

indra/cmake/Doctest.cmake

@@ -0,0 +1,6 @@
+# -*- cmake -*-
+include_guard(GLOBAL)
+
+if(NOT DEFINED DOCTEST_INCLUDE_DIR)
+    set(DOCTEST_INCLUDE_DIR "${CMAKE_SOURCE_DIR}/extern/doctest")
+endif()

indra/extern/doctest/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016-2024 Viktor Kirilov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.