Raw cmd for special usages

[bisho]

Motivation / Description

This change adds a raw command passthrough capability to the memcache socket implementation, allowing users to send arbitrary memcache protocol commands and receive the raw response bytes. This is useful for accessing memcache features that may not have dedicated high-level methods or for debugging purposes.

Its implementation is not performance oriented, since this should not be used.

Possible usages: flush for test suites, stats commands...

Changes introduced

• Added raw_cmd method to MemcacheSocket class that accepts raw command bytes and an optional multi_line parameter
• The method automatically appends \r\n to commands if not already present
• For single-line responses, reads until \r\n and returns the content before it
• For multi-line responses, reads until END\r\n and returns all content before the terminator
• Uses a separate buffer to avoid interfering with the main I/O state
• Releases the GIL during socket operations for better performance
• Added comprehensive test coverage including single-line commands, multi-line responses, empty responses, and verification that the method doesn't affect subsequent meta commands

[bisho]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• Raw cmd for special usages #17 👈 (View in Graphite)
• multi-get #16
• Move key encoding to socket api #15
• Add meta command methods to MemcacheSocket #14
• Add MemcacheSocket class and response types with CI tests #13
• Bump version to 0.1.7 and add Python 3.13t support #12
• Refactor parse_header to return structured type and update to Rust 2024 #11
• Bump version to 0.1.6 and optimize performance #9
• Update to PyO3 Bound API #10
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[ethervoid]

@claude review this pr