outline for issue title tests

outline test cases and sections for the restrictions on titles described
in the milestone document

Author: arnemertz

docs/_pages/milestones.md

@@ -36,4 +36,5 @@ For this first milestone, I want to be able to do the following:
 - more allowed values for status
 
 ### Notes:
-- **2021-08-13**: issue IDs should be all lower case (prefix and hash)
+- **2021-08-13**: issue IDs are all lower case (prefix and hash)
+- **2021-08-20**: titles are further restricted to printable ASCII characters (except backspace and backtick)

src/domain/CMakeLists.txt

@@ -1,5 +1,6 @@
 set(DOMAIN_SOURCES
     application_service.cpp
+    title.cpp
     )
 
 add_library(domain ${DOMAIN_SOURCES})

src/domain/title.cpp

@@ -0,0 +1,7 @@
+#include "title.hpp"
+
+using fix::domain::title;
+
+bool title::create(std::string_view) { // NOLINT
+  return false;
+}

src/domain/title.hpp

@@ -0,0 +1,15 @@
+#ifndef FIX_SRC_DOMAIN_TITLE_HPP
+#define FIX_SRC_DOMAIN_TITLE_HPP
+
+#include <string_view>
+
+namespace fix::domain {
+
+class title {
+public:
+  static bool create(std::string_view str);
+};
+
+} // namespace fix::domain
+
+#endif // FIX_SRC_DOMAIN_TITLE_HPP

test/domain/CMakeLists.txt

@@ -1,5 +1,6 @@
 set(DOMAIN_TEST_SOURCES
     application_service_test.cpp
+    title_test.cpp
     )
 
 add_executable(domain_tests ${DOMAIN_TEST_SOURCES})

test/domain/title_test.cpp

@@ -0,0 +1,27 @@
+#include <catch2/catch.hpp>
+
+#include "title.hpp"
+
+using fix::domain::title;
+
+TEST_CASE("Titles have restricted length") {
+  SECTION("titles may not be empty") {
+    CHECK_FALSE(title::create(""));
+  }
+
+  SECTION("titles may not be too short") {}
+  SECTION("titles may not be too long") {}
+  SECTION("titles with a length in the allowed range can be created") {}
+}
+
+TEST_CASE("Titles have a restricted character set") {
+  SECTION("titles may contain alphanumeric characters and spaces") {}
+  SECTION("titles may not contain line breaks and other non-space whitespace") {}
+  SECTION("titles may not contain special punctuation characters") {
+    SECTION("backspace") {}
+    SECTION("backtick") {}
+  }
+  SECTION("titles may contain other punctuation characters") {}
+  SECTION("titles may not contain backspace characters") {}
+  SECTION("titles may not contain non-ASCII characters") {}
+}