Struct RustyBuffer

pub struct RustyBuffer { /* private fields */ }

A native Rust file-like object. Reading and writing takes place through the Rust implementation, allowing access to the underlying bytes in Python.

Python Example

>>> from cramjam import Buffer
>>> buf = Buffer(b"bytes")
>>> buf.read()
b'bytes'

Implementations

impl RustyBuffer

A Buffer object, similar to cramjam.File only the bytes are held in-memory

Example

from cramjam import Buffer
buf = Buffer(b'start bytes')
buf.read(5)
b'start'

pub fn __init__(data: Option<BytesType<'_>>) -> PyResult<Self>

Instantiate the object, optionally with any supported bytes-like object in BytesType

pub fn len(&self) -> usize

Length of the underlying buffer

pub fn write(&mut self, input: BytesType<'_>) -> PyResult<usize>

Write some bytes to the buffer, where input data can be anything in BytesType

pub fn read<'a>( &mut self, py: Python<'a>, n_bytes: Option<usize>, ) -> PyResult<&'a PyBytes>

Read from the buffer in its current position, returns bytes; optionally specify number of bytes to read.

pub fn readinto(&mut self, output: BytesType<'_>) -> PyResult<usize>

Read from the buffer in its current position, into a BytesType object.

pub fn seek( &mut self, position: isize, whence: Option<usize>, ) -> PyResult<usize>

Seek to a position within the buffer. whence follows the same values as IOBase.seek where:

0: from start of the stream
1: from current stream position
2: from end of the stream

pub fn seekable(&self) -> bool

Whether the buffer is seekable; here just for compatibility, it always returns True.

pub fn tell(&self) -> usize

Give the current position of the buffer.

pub fn set_len(&mut self, size: usize) -> PyResult<()>

Set the length of the buffer. If less than current length, it will truncate to the size given; otherwise will be null byte filled to the size.

pub fn truncate(&mut self) -> PyResult<()>

Truncate the buffer

Trait Implementations

impl Default for RustyBuffer

fn default() -> RustyBuffer

Returns the “default value” for a type.

impl From<Vec<u8>> for RustyBuffer

fn from(v: Vec<u8>) -> Self

Converts to this type from the input type.

impl IntoPy<Py<PyAny>> for RustyBuffer

fn into_py(self, py: Python<'_>) -> PyObject

Performs the conversion.

impl<'p> PyBufferGetBufferProtocol<'p> for RustyBuffer

type Result = Result<(), PyErr>

impl<'p> PyBufferProtocol<'p> for RustyBuffer

fn bf_getbuffer( slf: PyRefMut<'_, Self>, view: *mut Py_buffer, flags: c_int, ) -> <RustyBuffer as PyBufferGetBufferProtocol<'p>>::Result

fn bf_releasebuffer( _slf: PyRefMut<'_, Self>, _view: *mut Py_buffer, ) -> <RustyBuffer as PyBufferReleaseBufferProtocol<'p>>::Result

impl PyBufferProtocolSlots<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn buffer_protocol_slots(self) -> &'static [PyType_Slot]

impl<'p> PyBufferReleaseBufferProtocol<'p> for RustyBuffer

type Result = ()

impl PyClass for RustyBuffer

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

impl PyClassDescriptors<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn py_class_descriptors(self) -> &'static [PyMethodDefType]

impl PyClassImpl for RustyBuffer

const DOC: &'static str = /// A native Rust file-like object. Reading and writing takes place

Class doc string

const IS_GC: bool = false

#[pyclass(gc)]

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

type Layout = PyCell<RustyBuffer>

Layout

type BaseType = PyAny

Base class

type ThreadChecker = ThreadCheckerStub<RustyBuffer>

This handles following two situations:

fn for_each_method_def(visitor: &mut dyn FnMut(&[PyMethodDefType]))

fn get_new() -> Option<newfunc>

fn get_alloc() -> Option<allocfunc>

fn get_free() -> Option<freefunc>

fn get_call() -> Option<PyCFunctionWithKeywords>

fn for_each_proto_slot(visitor: &mut dyn FnMut(&[PyType_Slot]))

fn get_buffer() -> Option<&'static PyBufferProcs>

impl PyClassNewImpl<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn new_impl(self) -> Option<newfunc>

impl PyMethods<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn py_methods(self) -> &'static [PyMethodDefType]

impl<'p> PyObjectBoolProtocol<'p> for RustyBuffer

type Result = bool

impl<'p> PyObjectProtocol<'p> for RustyBuffer

fn __repr__(&'p self) -> <RustyBuffer as PyObjectReprProtocol<'p>>::Result

fn __bool__(&'p self) -> <RustyBuffer as PyObjectBoolProtocol<'p>>::Result

impl PyObjectProtocolSlots<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn object_protocol_slots(self) -> &'static [PyType_Slot]

impl<'p> PyObjectReprProtocol<'p> for RustyBuffer

type Result = String

impl<'p> PySequenceContainsProtocol<'p> for RustyBuffer

type Item = u8

type Result = bool

impl<'p> PySequenceLenProtocol<'p> for RustyBuffer

type Result = usize

impl<'p> PySequenceProtocol<'p> for RustyBuffer

fn __len__(&'p self) -> <RustyBuffer as PySequenceLenProtocol<'p>>::Result

fn __contains__( &'p self, x: <RustyBuffer as PySequenceContainsProtocol<'p>>::Item, ) -> <RustyBuffer as PySequenceContainsProtocol<'p>>::Result

impl PySequenceProtocolSlots<RustyBuffer> for PyClassImplCollector<RustyBuffer>

fn sequence_protocol_slots(self) -> &'static [PyType_Slot]

impl PyTypeInfo for RustyBuffer

const NAME: &'static str = "Buffer"

Class name.

const MODULE: Option<&'static str> = ::std::option::Option::None

Module name, if any.

type AsRefTarget = PyCell<RustyBuffer>

Utility type to make Py::as_ref work.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

PyTypeObject instance for this type.

fn is_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &PyAny) -> bool

Checks if object is an instance of this type.

impl Read for RustyBuffer

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Reader has an efficient read_vectored implementation.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Reads all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Reads all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Reads the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

where Self: Sized,

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R>

where R: Read, Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.

impl Seek for RustyBuffer

fn seek(&mut self, pos: SeekFrom) -> Result<u64>

Seek to an offset, in bytes, in a stream.

fn rewind(&mut self) -> Result<(), Error>

Rewind to the beginning of a stream.

fn stream_len(&mut self) -> Result<u64, Error>

🔬This is a nightly-only experimental API. (seek_stream_len)

Returns the length of this stream (in bytes).

fn stream_position(&mut self) -> Result<u64, Error>

Returns the current seek position from the start of the stream.

fn seek_relative(&mut self, offset: i64) -> Result<(), Error>

Seeks relative to the current position.

impl Write for RustyBuffer

fn write(&mut self, buf: &[u8]) -> Result<usize>

Writes a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.