feat(uuid): add libavutil UUID support

Implements wrapper functions for the libavutil/uuid.h functionality:
- Adds AVUUID type and constants
- Implements manual wrappers for uuid functions in custom.go
- Updates generator to skip uuid functions (handled manually)
- Adds comprehensive test cases for UUID operations

These additions allow working with UUIDs according to IETF RFC 4122 specification,
including parsing, comparison, and string serialization operations.

Author: flexiondotorg

bindings_test.go

@@ -268,3 +268,87 @@ func TestGeneratorErrorHandling(t *testing.T) {
 		t.Logf("Error handling test passed: AVERROR_EOF = %d", AVErrorEofConst)
 	})
 }
+
+// TestUUID tests the UUID functionality from libavutil/uuid.h
+func TestUUID(t *testing.T) {
+	t.Run("Parse and Unparse", func(t *testing.T) {
+		// Parse a UUID string
+		uuidStr := "550e8400-e29b-41d4-a716-446655440000"
+		var uuid AVUUID
+
+		cStr := ToCStr(uuidStr)
+		defer cStr.Free()
+
+		ret, err := AVUuidParse(cStr, &uuid)
+		if ret != 0 || err != nil {
+			t.Fatalf("Failed to parse UUID: %v", err)
+		}
+
+		// Unparse it back to string
+		outStr := AllocCStr(37)
+		defer outStr.Free()
+		AVUuidUnparse(&uuid, outStr)
+
+		result := outStr.String()
+		if result != uuidStr {
+			t.Fatalf("UUID mismatch: expected %s, got %s", uuidStr, result)
+		}
+
+		t.Logf("UUID parse/unparse test passed: %s", result)
+	})
+
+	t.Run("UUID Operations", func(t *testing.T) {
+		// Create two identical UUIDs
+		var uuid1, uuid2 AVUUID
+		uuidStr := "550e8400-e29b-41d4-a716-446655440000"
+		cStr := ToCStr(uuidStr)
+		defer cStr.Free()
+
+		AVUuidParse(cStr, &uuid1)
+		AVUuidCopy(&uuid2, &uuid1)
+
+		// Test equality
+		equal, _ := AVUuidEqual(&uuid1, &uuid2)
+		if equal == 0 {
+			t.Fatal("UUIDs should be equal")
+		}
+
+		// Test nil UUID
+		var nilUuid AVUUID
+		AVUuidNil(&nilUuid)
+
+		equal, _ = AVUuidEqual(&uuid1, &nilUuid)
+		if equal != 0 {
+			t.Fatal("UUID should not equal nil UUID")
+		}
+
+		t.Logf("UUID operations test passed")
+	})
+
+	t.Run("URN Parsing", func(t *testing.T) {
+		// Parse a UUID URN
+		urnStr := "urn:uuid:550e8400-e29b-41d4-a716-446655440000"
+		var uuid AVUUID
+
+		cStr := ToCStr(urnStr)
+		defer cStr.Free()
+
+		ret, err := AVUuidUrnParse(cStr, &uuid)
+		if ret != 0 || err != nil {
+			t.Fatalf("Failed to parse UUID URN: %v", err)
+		}
+
+		// Verify by unparsing
+		outStr := AllocCStr(37)
+		defer outStr.Free()
+		AVUuidUnparse(&uuid, outStr)
+
+		result := outStr.String()
+		expected := "550e8400-e29b-41d4-a716-446655440000"
+		if result != expected {
+			t.Fatalf("UUID mismatch: expected %s, got %s", expected, result)
+		}
+
+		t.Logf("UUID URN parse test passed: %s", result)
+	})
+}

callbacks.gen.go

@@ -96,6 +96,7 @@ import "unsafe"
 // #include <libavutil/tree.h>
 // #include <libavutil/twofish.h>
 // #include <libavutil/tx.h>
+// #include <libavutil/uuid.h>
 // #include <libavutil/version.h>
 // #include <libavutil/video_enc_params.h>
 // #include <libavutil/video_hint.h>

constants.gen.go

@@ -94,6 +94,7 @@ package ffmpeg
 // #include <libavutil/tree.h>
 // #include <libavutil/twofish.h>
 // #include <libavutil/tx.h>
+// #include <libavutil/uuid.h>
 // #include <libavutil/version.h>
 // #include <libavutil/video_enc_params.h>
 // #include <libavutil/video_hint.h>
@@ -2653,6 +2654,15 @@ const AVTimecodeStrSize = C.AV_TIMECODE_STR_SIZE
 // AVTsMaxStringSize wraps AV_TS_MAX_STRING_SIZE.
 const AVTsMaxStringSize = C.AV_TS_MAX_STRING_SIZE
 
+// AVPriUuid wraps AV_PRI_UUID.
+const AVPriUuid = C.AV_PRI_UUID
+
+// AVPriUrnUuid wraps AV_PRI_URN_UUID.
+const AVPriUrnUuid = C.AV_PRI_URN_UUID
+
+// AVUuidLen wraps AV_UUID_LEN.
+const AVUuidLen = C.AV_UUID_LEN
+
 // LIBAVUtilVersionMajor wraps LIBAVUTIL_VERSION_MAJOR.
 const LIBAVUtilVersionMajor = C.LIBAVUTIL_VERSION_MAJOR
 

custom.go

@@ -6,6 +6,7 @@ package ffmpeg
 #include <libavcodec/avcodec.h>
 #include <libavcodec/bsf.h>
 #include <libavfilter/avfilter.h>
+#include <libavutil/uuid.h>
 
 // Forward declarations for iteration functions
 extern const AVCodec *av_codec_iterate(void **opaque);
@@ -187,3 +188,107 @@ type AVAdler = uint32
 // AVCRC is a typedef alias for uint32_t in FFmpeg.
 // This represents a CRC (Cyclic Redundancy Check) value.
 type AVCRC = uint32
+
+// AVUUID is a typedef to a 16-byte array in FFmpeg (uint8_t[16]).
+// This represents a UUID as an opaque sequence of 16 unsigned bytes.
+// Binary representation of a UUID per IETF RFC 4122.
+type AVUUID = [16]uint8
+
+// --- Manual UUID function wrappers (arrays need pointer conversion in CGO) ---
+
+// AVUuidParse parses a string representation of a UUID formatted according to IETF RFC 4122
+// into an AVUUID. The parsing is case-insensitive. The string must be 37
+// characters long, including the terminating NUL character.
+//
+// Example string representation: "2fceebd0-7017-433d-bafb-d073a7116696"
+//
+//	@param[in]  in  String representation of a UUID
+//	@param[out] uu  AVUUID
+//	@return         A non-zero value in case of an error.
+func AVUuidParse(in *CStr, uu *AVUUID) (int, error) {
+	var tmpin *C.char
+	if in != nil {
+		tmpin = in.ptr
+	}
+	ret := C.av_uuid_parse(tmpin, (*C.uint8_t)(unsafe.Pointer(&uu[0])))
+	return int(ret), WrapErr(int(ret))
+}
+
+// AVUuidUrnParse parses a URN representation of a UUID, as specified at IETF RFC 4122,
+// into an AVUUID. The parsing is case-insensitive. The string must be 46
+// characters long, including the terminating NUL character.
+//
+// Example string representation: "urn:uuid:2fceebd0-7017-433d-bafb-d073a7116696"
+//
+//	@param[in]  in  URN UUID
+//	@param[out] uu  AVUUID
+//	@return         A non-zero value in case of an error.
+func AVUuidUrnParse(in *CStr, uu *AVUUID) (int, error) {
+	var tmpin *C.char
+	if in != nil {
+		tmpin = in.ptr
+	}
+	ret := C.av_uuid_urn_parse(tmpin, (*C.uint8_t)(unsafe.Pointer(&uu[0])))
+	return int(ret), WrapErr(int(ret))
+}
+
+// AVUuidParseRange parses a string representation of a UUID formatted according to IETF RFC 4122
+// into an AVUUID. The parsing is case-insensitive.
+//
+//	@param[in]  inStart Pointer to the first character of the string representation
+//	@param[in]  inEnd   Pointer to the character after the last character of the
+//	                    string representation. That memory location is never
+//	                    accessed. It is an error if `inEnd - inStart != 36`.
+//	@param[out] uu      AVUUID
+//	@return             A non-zero value in case of an error.
+func AVUuidParseRange(inStart *CStr, inEnd *CStr, uu *AVUUID) (int, error) {
+	var tmpinStart *C.char
+	if inStart != nil {
+		tmpinStart = inStart.ptr
+	}
+	var tmpinEnd *C.char
+	if inEnd != nil {
+		tmpinEnd = inEnd.ptr
+	}
+	ret := C.av_uuid_parse_range(tmpinStart, tmpinEnd, (*C.uint8_t)(unsafe.Pointer(&uu[0])))
+	return int(ret), WrapErr(int(ret))
+}
+
+// AVUuidUnparse serializes a AVUUID into a string representation according to IETF RFC 4122.
+// The string is lowercase and always 37 characters long, including the terminating NUL character.
+//
+//	@param[in]  uu  AVUUID
+//	@param[out] out Pointer to an array of no less than 37 characters.
+func AVUuidUnparse(uu *AVUUID, out *CStr) {
+	var tmpout *C.char
+	if out != nil {
+		tmpout = out.ptr
+	}
+	C.av_uuid_unparse((*C.uint8_t)(unsafe.Pointer(&uu[0])), tmpout)
+}
+
+// AVUuidEqual compares two UUIDs for equality.
+//
+//	@param[in] uu1 AVUUID
+//	@param[in] uu2 AVUUID
+//	@return        Nonzero if uu1 and uu2 are equal, 0 otherwise.
+func AVUuidEqual(uu1 *AVUUID, uu2 *AVUUID) (int, error) {
+	ret := C.av_uuid_equal((*C.uint8_t)(unsafe.Pointer(&uu1[0])), (*C.uint8_t)(unsafe.Pointer(&uu2[0])))
+	return int(ret), WrapErr(int(ret))
+}
+
+// AVUuidCopy copies the bytes of src into dest.
+//
+//	@param[out] dest AVUUID
+//	@param[in]  src  AVUUID
+func AVUuidCopy(dest *AVUUID, src *AVUUID) {
+	C.av_uuid_copy((*C.uint8_t)(unsafe.Pointer(&dest[0])), (*C.uint8_t)(unsafe.Pointer(&src[0])))
+}
+
+// AVUuidNil sets a UUID to the nil UUID, i.e. a UUID with have all
+// its 128 bits set to zero.
+//
+//	@param[out] uu AVUUID
+func AVUuidNil(uu *AVUUID) {
+	C.av_uuid_nil((*C.uint8_t)(unsafe.Pointer(&uu[0])))
+}

enums.gen.go

@@ -96,6 +96,7 @@ import "unsafe"
 // #include <libavutil/tree.h>
 // #include <libavutil/twofish.h>
 // #include <libavutil/tx.h>
+// #include <libavutil/uuid.h>
 // #include <libavutil/version.h>
 // #include <libavutil/video_enc_params.h>
 // #include <libavutil/video_hint.h>

functions.gen.go

@@ -96,6 +96,7 @@ import "unsafe"
 // #include <libavutil/tree.h>
 // #include <libavutil/twofish.h>
 // #include <libavutil/tx.h>
+// #include <libavutil/uuid.h>
 // #include <libavutil/version.h>
 // #include <libavutil/video_enc_params.h>
 // #include <libavutil/video_hint.h>
@@ -16081,6 +16082,34 @@ func AVTxUninit(ctx **AVTXContext) {
 	}
 }
 
+// --- Function av_uuid_parse ---
+
+// av_uuid_parse skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_urn_parse ---
+
+// av_uuid_urn_parse skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_parse_range ---
+
+// av_uuid_parse_range skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_unparse ---
+
+// av_uuid_unparse skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_equal ---
+
+// av_uuid_equal skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_copy ---
+
+// av_uuid_copy skipped due to array typedef (manually wrapped in custom.go)
+
+// --- Function av_uuid_nil ---
+
+// av_uuid_nil skipped due to array typedef (manually wrapped in custom.go)
+
 // --- Function av_video_enc_params_block ---
 
 // AVVideoEncParamsBlock wraps av_video_enc_params_block.

internal/generator/generator.go

@@ -799,6 +799,16 @@ outer:
 			continue outer
 		}
 
+		// WORKAROUND: UUID functions use AVUUID (array typedef) which requires pointer conversion in CGO
+		// These are manually wrapped in custom.go with proper pointer handling
+		if fn.Name == "av_uuid_parse" || fn.Name == "av_uuid_urn_parse" || fn.Name == "av_uuid_parse_range" ||
+			fn.Name == "av_uuid_unparse" || fn.Name == "av_uuid_equal" || fn.Name == "av_uuid_copy" || fn.Name == "av_uuid_nil" {
+			o.Commentf("%v skipped due to array typedef (manually wrapped in custom.go)", fn.Name)
+			o.Line()
+
+			continue outer
+		}
+
 		if typeEquals(fn.Result, fileType) || typeEquals(fn.Result, fileType2) {
 			o.Commentf("%v skipped due to return", fn.Name)
 			o.Line()

internal/generator/parser.go

@@ -124,7 +124,7 @@ var files = []string{
 	"libavutil/tree.h",
 	"libavutil/twofish.h",
 	"libavutil/tx.h",
-	////"libavutil/uuid.h", //Unknown typedef kind NoDeclFound
+	"libavutil/uuid.h",
 	"libavutil/version.h",
 	"libavutil/video_enc_params.h",
 	"libavutil/video_hint.h",

structs.gen.go

@@ -96,6 +96,7 @@ import "unsafe"
 // #include <libavutil/tree.h>
 // #include <libavutil/twofish.h>
 // #include <libavutil/tx.h>
+// #include <libavutil/uuid.h>
 // #include <libavutil/version.h>
 // #include <libavutil/video_enc_params.h>
 // #include <libavutil/video_hint.h>