added prival to string function

CMakeLists.txt

@@ -233,6 +233,7 @@ set(STUMPLESS_SOURCES
   ${PROJECT_SOURCE_DIR}/src/version.c
   ${PROJECT_SOURCE_DIR}/src/validate.c
   ${PROJECT_SOURCE_DIR}/src/priority.c
+  ${PROJECT_SOURCE_DIR}/src/prival.c
 )
 
 
@@ -698,6 +699,7 @@ install(FILES
   ${PROJECT_SOURCE_DIR}/include/stumpless/target.h
   ${PROJECT_SOURCE_DIR}/include/stumpless/version.h
   ${PROJECT_SOURCE_DIR}/include/stumpless/priority.h
+  ${PROJECT_SOURCE_DIR}/include/stumpless/prival.h
   DESTINATION "include/stumpless"
 )
 
@@ -1016,6 +1018,10 @@ add_function_test(priority
   SOURCES ${PROJECT_SOURCE_DIR}/test/function/priority.cpp
 )
 
+add_function_test(prival
+  SOURCES ${PROJECT_SOURCE_DIR}/test/function/prival.cpp
+)
+
 add_custom_target(build-test
   DEPENDS ${STUMPLESS_FUNCTION_TESTS}
 )

include/stumpless.h

@@ -101,6 +101,7 @@
 #include <stumpless/target/stream.h>
 #include <stumpless/version.h>
 #include <stumpless/priority.h>
+#include <stumpless/prival.h>
 
 #ifdef STUMPLESS_CHAIN_TARGETS_SUPPORTED
 /** @example chain_example.c

include/stumpless/prival.h

@@ -0,0 +1,62 @@
+/* SPDX-License-Identifier: Apache-2.0 */
+
+/*
+ * Copyright 2018-2023 Joel E. Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/** @file
+ * Function for converting prival from int to string
+ */
+
+#ifndef __STUMPLESS_PRIVAL_H
+#  define __STUMPLESS_PRIVAL_H
+
+#  include <stumpless/config.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+/**
+ * Gets the string representation of the given prival.
+ *
+ * The string returned must be freed by the caller when it is no longer
+ * needed to avoid memory leaks.
+ *
+ * **Thread Safety: MT-Safe**
+ * This function is thread safe.
+ *
+ * **Async Signal Safety: AS-Unsafe heap**
+ * This function is not safe to call from signal handlers due to the use of
+ * memory management functions.
+ *
+ * **Async Cancel Safety: AC-Unsafe heap**
+ * This function is not safe to call from threads that may be asynchronously
+ * cancelled due to the use of memory management functions.
+ *
+ * @since release v2.2.0
+ *
+ * @param prival int to get the string from.
+ *
+ * @return The string representation of the given prival.
+ */
+STUMPLESS_PUBLIC_FUNCTION
+const char *
+stumpless_get_prival_string( int prival );
+
+#ifdef __cplusplus
+} /* extern "C" */
+#endif
+
+#endif /* __STUMPLESS_PRIVAL_H */

src/prival.c

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: Apache-2.0
+
+/*
+ * Copyright 2018-2022 Joel E. Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <string.h>
+#include <stdio.h>
+#include <stumpless/prival.h>
+#include <stumpless/severity.h>
+#include <stumpless/facility.h>
+#include "private/severity.h"
+#include "private/facility.h"
+#include "private/memory.h"
+
+const char* stumpless_get_prival_string( int prival ) {	
+	const char *severity = stumpless_get_severity_string( get_severity( prival ) );
+	const char *facility = stumpless_get_facility_string( get_facility( prival ) );
+
+	size_t prival_string_length = ( strlen( severity ) + strlen( facility ) + 4); //+3 for formatting, +1 for termination
+	char *prival_string = alloc_mem( prival_string_length );
+
+	snprintf(prival_string, prival_string_length, "%s | %s", severity, facility);
+
+	return prival_string;
+}

src/windows/stumpless.def

@@ -244,3 +244,5 @@ EXPORTS
   stumpless_get_chain_length                    @227
   stumpless_new_chain                           @228
   stumpless_set_entry_message_str_w             @229
+
+  stumpless_get_prival_string                   @230

test/function/prival.cpp

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: Apache-2.0
+
+/*
+ * Copyright 2019-2021 Joel E. Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <gtest/gtest.h>
+#include <stumpless.h>
+
+namespace {
+
+	class PrivalTest : public::testing::Test {
+	};
+
+	TEST(GetPrivalString, ValidPrival) {
+	const char *result;
+
+	result = stumpless_get_prival_string( 11 ); \
+	EXPECT_STREQ( result, "STUMPLESS_SEVERITY_ERR | STUMPLESS_FACILITY_USER" );
+  }
+} 

tools/check_headers/stumpless.yml

@@ -639,3 +639,4 @@
 "STUMPLESS_FOREACH_TARGET_TYPE" : "stumpless/target.h"
 "STUMPLESS_FOREACH_SEVERITY" : "stumpless/severity.h"
 "stumpless_prival_from_string" : "stumpless/priority.h"
+"stumpless_get_prival_string" : "stumpless/prival.h"