added for_each() for tables and arrays

also:
- refactoring
- documentation fixes
- updated conformance tests
- made submodules shallow

Author: marzer

.gitmodules

@@ -1,19 +1,21 @@
 [submodule "external/toml-test"]
 	path = external/toml-test
 	url = https://github.com/BurntSushi/toml-test.git
+	shallow = true
 [submodule "external/toml-spec-tests"]
 	path = external/toml-spec-tests
 	url = https://github.com/iarna/toml-spec-tests.git
-[submodule "external/dox"]
-	path = external/dox
-	url = https://github.com/marzer/dox.git
-[submodule "external/Catch2"]
-	path = external/Catch2
-	url = https://github.com/catchorg/Catch2.git
-	branch = v2.x
+	shallow = true
 [submodule "external/tloptional"]
 	path = external/tloptional
 	url = https://github.com/TartanLlama/optional.git
+	shallow = true
 [submodule "external/json"]
 	path = external/json
 	url = https://github.com/nlohmann/json.git
+	shallow = true
+[submodule "external/Catch2"]
+	path = external/Catch2
+	url = https://github.com/catchorg/Catch2.git
+	branch = v2.x
+	shallow = true

CHANGELOG.md

@@ -14,17 +14,19 @@ template:
 -->
 
 
-## Unreleased
+## [v3.1.0](https://github.com/marzer/tomlplusplus/releases/tag/v3.1.0) - 2022-04-22
 
 #### Fixes:
 - Fixed potential segfault when calling `at_path()` with an empty string
 - Fixed UB in internal unicode machinery (#144) (@kchalmer)
 - Fixed a number of spurious warnings with Clang 10 (#145, #146) (@chronoxor)
 
 #### Additions:
+- Added `toml::array::for_each()`
+- Added `toml::table::for_each()`
 - Added config options `TOML_EXPORTED_CLASS`, `TOML_EXPORTED_MEMBER_FUNCTION`, `TOML_EXPORTED_STATIC_FUNCTION` & `TOML_EXPORTED_FREE_FUNCTION`
-- Add support for escape sequence `\e` when using `TOML_ENABLE_UNRELEASED_FEATURES` ([toml/790](https://github.com/toml-lang/toml/pull/790))
-- Add support for more unicode in bare keys when using `TOML_ENABLE_UNRELEASED_FEATURES` ([toml/891](https://github.com/toml-lang/toml/pull/891))
+- Added support for escape sequence `\e` when using `TOML_ENABLE_UNRELEASED_FEATURES` ([toml/790](https://github.com/toml-lang/toml/pull/790))
+- Added support for more unicode in bare keys when using `TOML_ENABLE_UNRELEASED_FEATURES` ([toml/891](https://github.com/toml-lang/toml/pull/891))
 
 #### Removals/Deprecations:
 - Deprecated old `TOML_API` option in favour new `TOML_EXPORTED_X` options

CMakeLists.txt

@@ -2,7 +2,7 @@ cmake_minimum_required(VERSION 3.14)
 
 project(
     tomlplusplus
-    VERSION 3.0.1
+    VERSION 3.1.0
     DESCRIPTION "Header-only TOML config file parser and serializer for C++17"
     HOMEPAGE_URL "https://marzer.github.io/tomlplusplus/"
     LANGUAGES CXX

README.md

@@ -99,13 +99,13 @@ You'll find some more code examples in the `examples` directory, and plenty more
 2. `#include <toml++/toml.h>`
 
 ### Conan
-Add `tomlplusplus/3.0.1` to your conanfile.
+Add `tomlplusplus/3.1.0` to your conanfile.
 
 ### DDS
 Add `tomlpp` to your `package.json5`, e.g.:
 ```
 depends: [
-    'tomlpp^3.0.1',
+    'tomlpp^3.1.0',
 ]
 ```
 > ℹ&#xFE0F; _[What is DDS?](https://dds.pizza/)_
@@ -121,12 +121,21 @@ include(FetchContent)
 FetchContent_Declare(
     tomlplusplus
     GIT_REPOSITORY https://github.com/marzer/tomlplusplus.git
-    GIT_TAG        v3.0.1
+    GIT_TAG        v3.1.0
 )
 FetchContent_MakeAvailable(tomlplusplus)
 ```
 > ℹ&#xFE0F; _[What is FetchContent?](https://cmake.org/cmake/help/latest/module/FetchContent.html)_
 
+### Git submodules
+```
+git submodule add --depth 1 https://github.com/marzer/tomlplusplus.git tomlplusplus
+git config -f .gitmodules submodule.tomlplusplus.shallow true
+```
+> ℹ&#xFE0F; The toml++ repository has some submodules of its own, but **they are only used for testing**!
+> You do not need to use the `--recursive` option for regular library consumption.
+
+
 ### Other environments and package managers
 `toml++` is a fairly new project and I'm not up-to-speed with all of the available packaging and integration options
 in the C++ ecosystem. I'm also a cmake novice, for better or worse. If there's an integration option missing be

docs/pages/main_page.dox

@@ -457,15 +457,15 @@
 
 
  \subsection mainpage-adding-lib-conan Conan
- Add `tomlplusplus/3.0.1` to your conanfile.
+ Add `tomlplusplus/3.1.0` to your conanfile.
 
 
 
  \subsection mainpage-adding-lib-dds DDS
  Add `tomlpp` to your `package.json5`, e.g.:
  \bash
  depends: [
-		'tomlpp^3.0.1',
+		'tomlpp^3.1.0',
  ]
  \ebash
 
@@ -497,7 +497,7 @@
  FetchContent_Declare(
      tomlplusplus
      GIT_REPOSITORY https://github.com/marzer/tomlplusplus.git
-     GIT_TAG        v3.0.1
+     GIT_TAG        v3.1.0
  )
  FetchContent_MakeAvailable(tomlplusplus)
  \endcode
@@ -506,6 +506,16 @@
 
 
 
+\subsection mainpage-adding-lib-git-submodules Git submodules
+\bash
+git submodule add --depth 1 https://github.com/marzer/tomlplusplus.git tomlplusplus
+git config -f .gitmodules submodule.tomlplusplus.shallow true
+\ebash
+\note The toml++ repository has some submodules of its own, but **they are only used for testing**! You do not need to
+use the `--recursive` option for regular library consumption.
+
+
+
  \subsection mainpage-adding-lib-other Other environments and package managers
  toml++ is a fairly new project and I'm not up-to-speed with all of the available packaging and integration options
  in the C++ ecosystem. I'm also a cmake novice, for better or worse. If there's an integration option missing