test_format_cap.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 2014, Digium, Inc.
 *
 * Joshua Colp <[email protected]>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*!
 * \file
 * \brief Format Capabilities API Unit Tests
 *
 * \author Joshua Colp <[email protected]>
 *
 */

/*** MODULEINFO
 <depend>TEST_FRAMEWORK</depend>
 <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include "asterisk/test.h"
#include "asterisk/module.h"
#include "asterisk/codec.h"
#include "asterisk/frame.h"
#include "asterisk/format.h"
#include "asterisk/format_cap.h"

AST_TEST_DEFINE(format_cap_alloc)
{
 struct ast_format_cap *caps;

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_alloc";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities allocation unit test";
 info->description =
 "Test that allocation of a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }
 ao2_ref(caps, -1);

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_single)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, codec, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, retrieved, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities adding unit test";
 info->description =
 "Test that adding a single format to a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 codec = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!codec) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 format = ast_format_create(codec);
 if (!format) {
 ast_test_status_update(test, "Could not create format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, format, 42)) {
 ast_test_status_update(test, "Could not add newly created format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 1) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 1 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 retrieved = ast_format_cap_get_format(caps, 0);
 if (!retrieved) {
 ast_test_status_update(test, "Attempted to get single format from capabilities structure but got nothing\n");
 return AST_TEST_FAIL;
 } else if (retrieved != format) {
 ast_test_status_update(test, "Retrieved format is not the same as the one we added\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_get_format_framing(caps, retrieved) != 42) {
 ast_test_status_update(test, "Framing for format in capabilities structure does not match what we provided\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_multiple)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, retrieved, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities adding unit test";
 info->description =
 "Test that adding multiple formats to a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add newly created ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(caps, alaw_format, 84)) {
 ast_test_status_update(test, "Could not add newly created alaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 2) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 2 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 retrieved = ast_format_cap_get_format(caps, 0);
 if (!retrieved) {
 ast_test_status_update(test, "Attempted to get first format from capabilities structure but got nothing\n");
 return AST_TEST_FAIL;
 } else if (retrieved != ulaw_format) {
 ast_test_status_update(test, "First retrieved format is not the ulaw one we added\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_get_format_framing(caps, retrieved) != 42) {
 ast_test_status_update(test, "Framing for ulaw format in capabilities structure does not match what we provided\n");
 }
 ao2_ref(retrieved, -1);

 retrieved = ast_format_cap_get_format(caps, 1);
 if (!retrieved) {
 ast_test_status_update(test, "Attempted to get second format from capabilities structure but got nothing\n");
 return AST_TEST_FAIL;
 } else if (retrieved != alaw_format) {
 ast_test_status_update(test, "First retrieved format is not the alaw one we added\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_get_format_framing(caps, retrieved) != 84) {
 ast_test_status_update(test, "Framing for alaw format in capabilities structure does not match what we provided\n");
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_all_unknown)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities adding unit test";
 info->description =
 "Test that adding of all formats to a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to add all media formats of all types to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Added all media formats but no audio formats exist when they should\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Added all media formats but no video formats exist when they should\n");
 return AST_TEST_FAIL;
 } else if ((ast_format_cap_count(caps) + 1) != (ast_codec_get_max() - 1)) {
 ast_test_status_update(test, "The number of formats in the capabilities structure does not match known number\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_all_audio)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities adding unit test";
 info->description =
 "Test that adding of all audio formats to a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Failed to add all audio media formats to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Added audio media formats but no audio formats exist when they should\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_has_type(caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Added only audio media formats but video formats exist when they should not\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_has_type(caps, AST_MEDIA_TYPE_TEXT)) {
 ast_test_status_update(test, "Added only audio media formats but text formats exist when they should not\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_has_type(caps, AST_MEDIA_TYPE_IMAGE)) {
 ast_test_status_update(test, "Added only audio media formats but image formats exist when they should not\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_duplicate)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, codec, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, format_named, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, retrieved, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities duplication unit test";
 info->description =
 "Test that adding a single format multiple times to a capabilities structure results in only a single format";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 codec = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!codec) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 format = ast_format_create(codec);
 if (!format) {
 ast_test_status_update(test, "Could not create format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 format_named = ast_format_create_named("ulaw@20", codec);
 if (!format_named) {
 ast_test_status_update(test, "Could not create named format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, format, 42)) {
 ast_test_status_update(test, "Could not add newly created format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 1) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 1 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 /* Note: regardless of it being a duplicate, ast_format_cap_append should return success */
 if (ast_format_cap_append(caps, format, 0)) {
 ast_test_status_update(test, "Adding of duplicate format to capabilities structure failed\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 1) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 1 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, format_named, 0)) {
 ast_test_status_update(test, "Adding of duplicate named format to capabilities structure failed\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 1) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 1 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 retrieved = ast_format_cap_get_format(caps, 0);
 if (!retrieved) {
 ast_test_status_update(test, "Attempted to get single format from capabilities structure but got nothing\n");
 return AST_TEST_FAIL;
 } else if (retrieved != format) {
 ast_test_status_update(test, "Retrieved format is not the same as the one we added\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_get_format_framing(caps, retrieved) != 42) {
 ast_test_status_update(test, "Framing for format in capabilities structure does not match what we provided\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_from_cap)
{
 RAII_VAR(struct ast_format_cap *, dst_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, src_caps, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities append unit test";
 info->description =
 "Test that appending video formats from one capabilities structure to another succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 dst_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!dst_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(dst_caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Failed to add all audio media formats to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 src_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!src_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(src_caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Failed to add all video media formats to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append_from_cap(dst_caps, src_caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to append formats to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(dst_caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Successfully appended video formats to destination capabilities but it no longer contains audio formats\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(dst_caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Successfully appended formats but video formats do not exist in destination capabilities\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_append_from_cap_duplicate)
{
 RAII_VAR(struct ast_format_cap *, dst_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, src_caps, NULL, ao2_cleanup);
 unsigned int count;
 unsigned int total_count;

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities append duplicate unit test";
 info->description =
 "Test that appending capabilities structures multiple times does not result in duplicate formats";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 dst_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!dst_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(dst_caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Failed to add all audio media formats to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 src_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!src_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(src_caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Failed to add all video media formats to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 total_count = ast_format_cap_count(src_caps) + ast_format_cap_count(dst_caps);

 if (ast_format_cap_append_from_cap(dst_caps, src_caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to append formats to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(dst_caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Successfully appended video formats to destination capabilities but it no longer contains audio formats\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(dst_caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Successfully appended formats but video formats do not exist in destination capabilities\n");
 return AST_TEST_FAIL;
 }

 count = ast_format_cap_count(dst_caps);

 if (ast_format_cap_append_from_cap(dst_caps, src_caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to append duplicate formats to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ast_test_validate(test, count == ast_format_cap_count(dst_caps));
 ast_test_validate(test, count == total_count);

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_set_framing)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_set_framing";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities framing unit test";
 info->description =
 "Test that global framing on a format capabilities structure is used when it should be";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_set_framing(caps, 160);

 ast_test_validate(test, ast_format_cap_get_framing(caps) == 160);

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add newly created ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add newly created alaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_get_format_framing(caps, ulaw_format) != 42) {
 ast_test_status_update(test, "Added ulaw format to capabilities structure with explicit framing but did not get it back\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_get_format_framing(caps, alaw_format) != ast_format_get_default_ms(alaw_format)) {
 ast_test_status_update(test, "Added alaw format to capabilities structure with no explicit framing but did not get global back\n");
 return AST_TEST_FAIL;
 }
 ast_test_validate(test, ast_format_cap_get_framing(caps) == ast_format_get_default_ms(alaw_format));

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_remove_single)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, codec, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_remove_single";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities removal unit test";
 info->description =
 "Test that removing a single format from a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 codec = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!codec) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 format = ast_format_create(codec);
 if (!format) {
 ast_test_status_update(test, "Could not create format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, format, 42)) {
 ast_test_status_update(test, "Could not add newly created format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_remove(caps, format)) {
 ast_test_status_update(test, "Could not remove format that was just added to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_remove(caps, format)) {
 ast_test_status_update(test, "Successfully removed a format twice from the capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps)) {
 ast_test_status_update(test, "Capabilities structure should be empty but instead it contains '%zu' formats\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_remove_multiple)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, retrieved, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_remove_multiple";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities removal unit test";
 info->description =
 "Test that removing a format from a format capabilities structure containing multiple formats succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add newly created ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(caps, alaw_format, 84)) {
 ast_test_status_update(test, "Could not add newly created alaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_remove(caps, ulaw_format)) {
 ast_test_status_update(test, "Could not remove the ulaw format we just added to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_count(caps) != 1) {
 ast_test_status_update(test, "Capabilities structure should contain 1 format but it contains '%zu'\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 retrieved = ast_format_cap_get_format(caps, 0);
 if (!retrieved) {
 ast_test_status_update(test, "Attempted to get first format from capabilities structure but got nothing\n");
 return AST_TEST_FAIL;
 } else if (retrieved != alaw_format) {
 ast_test_status_update(test, "First retrieved format is not the alaw one we added\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_remove_bytype)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_remove_bytype";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities removal unit test";
 info->description =
 "Test that removal of a specific type of format from a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to add all media formats of all types to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_remove_by_type(caps, AST_MEDIA_TYPE_AUDIO);
 if (ast_format_cap_has_type(caps, AST_MEDIA_TYPE_AUDIO)) {
 ast_test_status_update(test, "Removed all audio type formats from capabilities structure but some remain\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_has_type(caps, AST_MEDIA_TYPE_VIDEO)) {
 ast_test_status_update(test, "Removed audio type formats from capabilities structure but video are gone as well\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_remove_all)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_remove_all";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities removal unit test";
 info->description =
 "Test that removal of all formats from a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append_by_type(caps, AST_MEDIA_TYPE_UNKNOWN)) {
 ast_test_status_update(test, "Failed to add all media formats of all types to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_remove_by_type(caps, AST_MEDIA_TYPE_UNKNOWN);

 if (ast_format_cap_count(caps)) {
 ast_test_status_update(test, "Removed all formats from capabilities structure but some remain\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_get_compatible_format)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, compatible, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_get_compatible_format";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities negotiation unit test";
 info->description =
 "Test that getting a compatible format from a capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add newly created ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }

 compatible = ast_format_cap_get_compatible_format(caps, alaw_format);
 if (compatible) {
 ast_test_status_update(test, "Retrieved a compatible format from capabilities structure when none should exist\n");
 return AST_TEST_FAIL;
 }

 compatible = ast_format_cap_get_compatible_format(caps, ulaw_format);
 if (!compatible) {
 ast_test_status_update(test, "Did not retrieve a compatible format from capabilities structure when there should be one\n");
 return AST_TEST_FAIL;
 } else if (compatible != ulaw_format) {
 ast_test_status_update(test, "Compatible format is not the format we added to the capabilities structure\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_iscompatible_format)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_iscompatible_format";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities negotiation unit test";
 info->description =
 "Test that checking whether a format is compatible with a capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add newly created ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_iscompatible_format(caps, alaw_format) != AST_FORMAT_CMP_NOT_EQUAL) {
 ast_test_status_update(test, "Alaw format is compatible with capabilities structure when it only contains ulaw\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_iscompatible_format(caps, ulaw_format) == AST_FORMAT_CMP_NOT_EQUAL) {
 ast_test_status_update(test, "Ulaw format is not compatible with capabilities structure when it should be\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_get_compatible)
{
 RAII_VAR(struct ast_format_cap *, alaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, ulaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, compatible_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_get_compatible";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities negotiation unit test";
 info->description =
 "Test that getting the compatible formats between two capabilities structures succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 alaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!alaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!ulaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 compatible_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!compatible_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(ulaw_caps, ulaw_format, 0)) {
 ast_test_status_update(test, "Could not add ulaw format to ulaw capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(alaw_caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add alaw format to alaw capabilities\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_get_compatible(ulaw_caps, alaw_caps, compatible_caps);
 if (ast_format_cap_count(compatible_caps)) {
 ast_test_status_update(test, "A compatible format exists when none should\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_get_compatible(ulaw_caps, ulaw_caps, compatible_caps);
 if (!ast_format_cap_count(compatible_caps)) {
 ast_test_status_update(test, "No compatible formats exist when 1 should\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_iscompatible)
{
 RAII_VAR(struct ast_format_cap *, alaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, ulaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_iscompatible";
 info->category = "/main/format_cap/";
 info->summary = "format capabilities negotiation unit test";
 info->description =
 "Test that checking if there are compatible formats between two capabilities structures succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 alaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!alaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!ulaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(ulaw_caps, ulaw_format, 0)) {
 ast_test_status_update(test, "Could not add ulaw format to ulaw capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(alaw_caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add alaw format to alaw capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_iscompatible(ulaw_caps, alaw_caps)) {
 ast_test_status_update(test, "Two capability structures that should not be compatible are\n");
 return AST_TEST_FAIL;
 } else if (!ast_format_cap_iscompatible(ulaw_caps, ulaw_caps)) {
 ast_test_status_update(test, "Capability structure is not compatible with itself\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_get_names)
{
 RAII_VAR(struct ast_format_cap *, empty_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, multi_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, alaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, ulaw_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);
 struct ast_str *buffer = ast_str_alloca(AST_FORMAT_CAP_NAMES_LEN);

 switch (cmd) {
 case TEST_INIT:
 info->name = "format_cap_get_names";
 info->category = "/main/format_cap/";
 info->summary = "Test getting the names of formats";
 info->description =
 "Test that obtaining the names from a format capabilities structure\n"
 "produces the expected output.";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 empty_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!empty_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 multi_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!multi_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 alaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!alaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!ulaw_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(ulaw_caps, ulaw_format, 0)) {
 ast_test_status_update(test, "Could not add ulaw format to ulaw capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(alaw_caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add alaw format to alaw capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(multi_caps, ulaw_format, 0)) {
 ast_test_status_update(test, "Could not add ulaw format to multi capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(multi_caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add alaw format to multi capabilities\n");
 return AST_TEST_FAIL;
 }

 ast_format_cap_get_names(empty_caps, &buffer);
 ast_test_validate(test, !strcmp(ast_str_buffer(buffer), "(nothing)"));
 ast_format_cap_get_names(ulaw_caps, &buffer);
 ast_test_validate(test, !strcmp(ast_str_buffer(buffer), "(ulaw)"));
 ast_format_cap_get_names(alaw_caps, &buffer);
 ast_test_validate(test, !strcmp(ast_str_buffer(buffer), "(alaw)"));
 ast_format_cap_get_names(multi_caps, &buffer);
 ast_test_validate(test, !strcmp(ast_str_buffer(buffer), "(ulaw|alaw)"));


 return AST_TEST_PASS;
}

AST_TEST_DEFINE(format_cap_best_by_type)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, h263, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, h263_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, best_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities best by type unit test";
 info->description =
 "Test that we can get the best format type out of a capabilities structure";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("ulaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve built-in ulaw codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 h263 = ast_codec_get("h263", AST_MEDIA_TYPE_VIDEO, 0);
 if (!h263) {
 ast_test_status_update(test, "Could not retrieve built-in h263 codec\n");
 return AST_TEST_FAIL;
 }

 h263_format = ast_format_create(h263);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create h263 format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 if (ast_format_cap_append(caps, ulaw_format, 0)) {
 ast_test_status_update(test, "Could not add ulaw format to capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(caps, alaw_format, 0)) {
 ast_test_status_update(test, "Could not add alaw format to capabilities\n");
 return AST_TEST_FAIL;
 } else if (ast_format_cap_append(caps, h263_format, 0)) {
 ast_test_status_update(test, "Could not add h263 format to capabilities\n");
 return AST_TEST_FAIL;
 }

 best_format = ast_format_cap_get_best_by_type(caps, AST_MEDIA_TYPE_UNKNOWN);
 ast_test_validate(test, ast_format_cmp(best_format, ulaw_format) == AST_FORMAT_CMP_EQUAL);
 ao2_ref(best_format, -1);

 best_format = ast_format_cap_get_best_by_type(caps, AST_MEDIA_TYPE_AUDIO);
 ast_test_validate(test, ast_format_cmp(best_format, ulaw_format) == AST_FORMAT_CMP_EQUAL);
 ao2_ref(best_format, -1);

 best_format = ast_format_cap_get_best_by_type(caps, AST_MEDIA_TYPE_VIDEO);
 ast_test_validate(test, ast_format_cmp(best_format, h263_format) == AST_FORMAT_CMP_EQUAL);
 ao2_ref(best_format, -1);

 best_format = ast_format_cap_get_best_by_type(caps, AST_MEDIA_TYPE_IMAGE);
 ast_test_validate(test, best_format == NULL);

 best_format = ast_format_cap_get_best_by_type(caps, AST_MEDIA_TYPE_TEXT);
 ast_test_validate(test, best_format == NULL);

 return AST_TEST_PASS;
}

static int test_law_samples(struct ast_frame *frame)
{
 return frame->datalen;
}

static int test_law_length(unsigned int samples)
{
 return samples;
}

static struct ast_codec test_law = {
 .name = "test_law",
 .description = "format cap unit test codec",
 .type = AST_MEDIA_TYPE_AUDIO,
 .sample_rate = 8000,
 .minimum_ms = 10,
 .maximum_ms = 150,
 .default_ms = 20,
 .samples_count = test_law_samples,
 .get_length = test_law_length,
 .smooth = 1,
};

static enum ast_format_cmp_res test_law_cmp(const struct ast_format *format1, const struct ast_format *format2)
{
 ast_log(LOG_ERROR, "Comparing format1 %p and format2 %p\n", format1, format2);
 return format1 == format2 ? AST_FORMAT_CMP_EQUAL : AST_FORMAT_CMP_NOT_EQUAL;
}

static void test_law_destroy(struct ast_format *format)
{
}

static int test_law_clone(const struct ast_format *src, struct ast_format *dst)
{
 return 0;
}

static struct ast_format_interface test_law_interface = {
 .format_cmp = test_law_cmp,
 .format_clone = test_law_clone,
 .format_destroy = test_law_destroy,
};

AST_TEST_DEFINE(format_cap_replace_from_cap)
{
 RAII_VAR(struct ast_format_cap *, caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, replace_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format_cap *, result_caps, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, ulaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, ulaw_format_variant, NULL, ao2_cleanup);
 RAII_VAR(struct ast_codec *, alaw, NULL, ao2_cleanup);
 RAII_VAR(struct ast_format *, alaw_format, NULL, ao2_cleanup);

 switch (cmd) {
 case TEST_INIT:
 info->name = __PRETTY_FUNCTION__;
 info->category = "/main/format_cap/";
 info->summary = "format capabilities adding unit test";
 info->description =
 "Test that adding multiple formats to a format capabilities structure succeeds";
 return AST_TEST_NOT_RUN;
 case TEST_EXECUTE:
 break;
 }

 caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 replace_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 result_caps = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
 if (!caps || !replace_caps || !result_caps) {
 ast_test_status_update(test, "Could not allocate an empty format capabilities structure\n");
 return AST_TEST_FAIL;
 }

 ulaw = ast_codec_get("test_law", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!ulaw) {
 ast_test_status_update(test, "Could not retrieve test_law codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format = ast_format_create(ulaw);
 if (!ulaw_format) {
 ast_test_status_update(test, "Could not create ulaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 ulaw_format_variant = ast_format_create(ulaw);
 if (!ulaw_format_variant) {
 ast_test_status_update(test, "Could not create ulaw format variant using built-in codec\n");
 return AST_TEST_FAIL;
 }

 alaw = ast_codec_get("alaw", AST_MEDIA_TYPE_AUDIO, 8000);
 if (!alaw) {
 ast_test_status_update(test, "Could not retrieve built-in alaw codec\n");
 return AST_TEST_FAIL;
 }

 alaw_format = ast_format_create(alaw);
 if (!alaw_format) {
 ast_test_status_update(test, "Could not create alaw format using built-in codec\n");
 return AST_TEST_FAIL;
 }

 /* fill caps with ulaw and alaw */
 if (ast_format_cap_append(caps, ulaw_format, 42)) {
 ast_test_status_update(test, "Could not add ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }
 if (ast_format_cap_append(caps, alaw_format, 84)) {
 ast_test_status_update(test, "Could not add alaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }
 if (ast_format_cap_count(caps) != 2) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 2 but is %zu\n",
 ast_format_cap_count(caps));
 return AST_TEST_FAIL;
 }

 /* fill replace_caps with the ulaw variant */
 if (ast_format_cap_append(replace_caps, ulaw_format_variant, 42)) {
 ast_test_status_update(test, "Could not add ulaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }
 if (ast_format_cap_count(replace_caps) != 1) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 1 but is %zu\n",
 ast_format_cap_count(replace_caps));
 return AST_TEST_FAIL;
 }

 /* fill result_caps with ulaw_variant and alaw */
 if (ast_format_cap_append(result_caps, ulaw_format_variant, 42)) {
 ast_test_status_update(test, "Could not add ulaw variant to capabilities structure\n");
 return AST_TEST_FAIL;
 }
 if (ast_format_cap_append(result_caps, alaw_format, 84)) {
 ast_test_status_update(test, "Could not add alaw format to capabilities structure\n");
 return AST_TEST_FAIL;
 }
 if (ast_format_cap_count(result_caps) != 2) {
 ast_test_status_update(test, "Number of formats in capabilities structure should be 2 but is %zu\n",
 ast_format_cap_count(result_caps));
 return AST_TEST_FAIL;
 }

 /* replace caps formats from replace_caps */
 ast_format_cap_replace_from_cap(caps, replace_caps, AST_MEDIA_TYPE_UNKNOWN);

 /* compare result_caps with caps */
 if (!ast_format_cap_identical(caps, result_caps)) {
 ast_test_status_update(test, "Actual and expected result caps differ\n");
 return AST_TEST_FAIL;
 }

 return AST_TEST_PASS;
}

static int unload_module(void)
{
 AST_TEST_UNREGISTER(format_cap_alloc);
 AST_TEST_UNREGISTER(format_cap_append_single);
 AST_TEST_UNREGISTER(format_cap_append_multiple);
 AST_TEST_UNREGISTER(format_cap_append_all_unknown);
 AST_TEST_UNREGISTER(format_cap_append_all_audio);
 AST_TEST_UNREGISTER(format_cap_append_duplicate);
 AST_TEST_UNREGISTER(format_cap_append_from_cap);
 AST_TEST_UNREGISTER(format_cap_append_from_cap_duplicate);
 AST_TEST_UNREGISTER(format_cap_set_framing);
 AST_TEST_UNREGISTER(format_cap_remove_single);
 AST_TEST_UNREGISTER(format_cap_remove_multiple);
 AST_TEST_UNREGISTER(format_cap_remove_bytype);
 AST_TEST_UNREGISTER(format_cap_remove_all);
 AST_TEST_UNREGISTER(format_cap_get_names);
 AST_TEST_UNREGISTER(format_cap_get_compatible_format);
 AST_TEST_UNREGISTER(format_cap_iscompatible_format);
 AST_TEST_UNREGISTER(format_cap_get_compatible);
 AST_TEST_UNREGISTER(format_cap_iscompatible);
 AST_TEST_UNREGISTER(format_cap_best_by_type);
 AST_TEST_UNREGISTER(format_cap_replace_from_cap);
 return 0;
}

static int load_module(void)
{
 AST_TEST_REGISTER(format_cap_alloc);
 AST_TEST_REGISTER(format_cap_append_single);
 AST_TEST_REGISTER(format_cap_append_multiple);
 AST_TEST_REGISTER(format_cap_append_all_unknown);
 AST_TEST_REGISTER(format_cap_append_all_audio);
 AST_TEST_REGISTER(format_cap_append_duplicate);
 AST_TEST_REGISTER(format_cap_append_from_cap);
 AST_TEST_REGISTER(format_cap_append_from_cap_duplicate);
 AST_TEST_REGISTER(format_cap_set_framing);
 AST_TEST_REGISTER(format_cap_remove_single);
 AST_TEST_REGISTER(format_cap_remove_multiple);
 AST_TEST_REGISTER(format_cap_remove_bytype);
 AST_TEST_REGISTER(format_cap_remove_all);
 AST_TEST_REGISTER(format_cap_get_names);
 AST_TEST_REGISTER(format_cap_get_compatible_format);
 AST_TEST_REGISTER(format_cap_iscompatible_format);
 AST_TEST_REGISTER(format_cap_get_compatible);
 AST_TEST_REGISTER(format_cap_iscompatible);
 AST_TEST_REGISTER(format_cap_best_by_type);
 AST_TEST_REGISTER(format_cap_replace_from_cap);
 ast_codec_register(&test_law);
 ast_format_interface_register("test_law", &test_law_interface);
 return AST_MODULE_LOAD_SUCCESS;
}

AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Format capabilities API test module");