Improve error handling in BytesQueue.Push function in queue.go

[akanchha25]

The Push function in BytesQueue currently uses a generic error message when the queue is full. It is suggested to use errFullQueue for a more descriptive error message.

Current Code:

var (
    errEmptyQueue       = &queueError{"Empty queue"}
    errInvalidIndex     = &queueError{"Index must be greater than zero. Invalid index."}
    errIndexOutOfBounds = &queueError{"Index out of range"}
)

Push function

if !q.canInsertAfterTail(neededSize) {
        if q.canInsertBeforeHead(neededSize) {
            q.tail = leftMarginIndex
        } else if q.capacity+neededSize >= q.maxCapacity && q.maxCapacity > 0 {
            return -1, &queueError{"Full queue. Maximum size limit reached."}
        } else {
            q.allocateAdditionalMemory(neededSize)
        }
    }

Updated code

var (
    errEmptyQueue       = &queueError{"Queue is empty."}
    errInvalidIndex     = &queueError{"Index must be greater than zero. Invalid index."}
    errIndexOutOfBounds = &queueError{"Index out of range."}
    errFullQueue        = &queueError{"Queue is full. Maximum size limit reached."} 
)

if !q.canInsertAfterTail(neededSize) {
        if q.canInsertBeforeHead(neededSize)) {
            q.tail = leftMarginIndex
        } else if q.capacity+neededSize >= q.maxCapacity && q.maxCapacity > 0 {
            return -1, errFullQueue 
        } else {
            q.allocateAdditionalMemory(neededSize)
        }
    }

This will improve the code quality

[janisz]

@akanchha25 Indeed it's a good improvement. Do you think errors should be unexpeorted? If we export them then they could be used to check for given error like with io.EOF

[akanchha25]

@janisz That's a great point. Exporting the errors would indeed allow for more robust error handling, similar to checking for specific errors like io.EOF. This could be beneficial for users of the BytesQueue package to handle different error scenarios more explicitly.

I can update the code to export these error variables, making it easier for others to handle specific error conditions. I'll proceed with the changes if that sounds good to you.