grid_file – инстурмент, для представления файлов, хранящихся в GridFS

GridIn

class grid_file.GridIn(root_collection, **kwargs)

Файл в коллекции

Данный класс не следуюет инстацировать, он возвращвется методами gridfs.GridFS

  • root_collection - коллекция, в которой находится объект

  • _id - уникальный идентификатор объекта

  • filename - человеческое имя объекта

  • contentType, content_type - mime-type файла

  • chunkSize, chunk_size - chank размер, по умолчанию 255 kb

  • encoding - кодировка файла

_id

Возвращает идентификатор объекта

chunk_size

Возвращает размер chunk’a

closed

Возвращает булево, файл уже закрыт

content_type

Возвращает mime-type файла

filename

Возвращает название файла

length

Возвращает размер объекта, в байтах. Может быть получен только у закрытого файла.

md5

Возвращает MD5 хеш файла. Может быть получен только у закрытого файла.

name

Возвращает название файла

upload_date

Дата добавления файла. Может быть получен только у закрытого файла.

close()

Сохраняет все содержимое и закрывает файл

write(data)

Записывает данные в файл.

Данные могут быть представлены как в строковом формате так и в файлобым объектом.

Из-за буферизации, даные запишутся в БД только после закрытия файла.

writelines(sequence)

Записывает список строк в файл

GridOut

class grid_file.GridOut(root_collection, file_id=None, file_document=None)

Прочтианный файл в gridfs.GridFS

Данный класс не следуюет инстацировать, он возвращвется методами gridfs.GridFS

  • root_collection - коллекция, в котором находится файл

  • file_id - опционально, уникальный идентификатор объекта

  • file_document - опционально, сам файл

_id

Возвращает уникальный идентификатор объекта

aliases

Возвращает список алиасов на файл

chunk_size

Возвращает размер chunk

content_type

Возвращает mime-type объекта

filename

Возвращает название файла

length

Возвращает размер файла, в байтах

md5

Возвращает MD5 хеш файла

metadata

Возвращает метадату файла

name

Возвращает название файла

upload_date

Возвращает дату создания файла в БД

close()

Make GridOut more generically file-like.

__iter__()

Возвращает итератор объекта

read(size=-1)

Читает дуказанное количесвто байтов из файла

readchunk()

Читает данные из файла от укзанной позиции, размером чанка.

readline(size=-1)

Читает указанное количесвто строк из файлаad

seek(pos, whence=0)

Перемещает курсор чтени в указанное положение

  • pos - позиция, на которую необходимо переместиться

  • whence - опционально, откуда будем перемещаться

    • os.SEEK_SET - 0 - абсолютная позиция

    • os.SEEK_CUR - 1 - относительно текущей позиции

    • os.SEEK_END - 2 - относительно конца

tell()

возвращает текущую позицию в файле

GridOutCursor

class grid_file.GridOutCursor(collection, filter=None, skip=0, limit=0, no_cursor_timeout=False, sort=None)

Возвращает новый курсор, похожий на pymongo.cursor.Cursor

Не должен инстацироватьсся, в получется методом gridfs.GridFS.find()

next()

Возвращает следующий объект