> **Источник:** https://python-all.ru/3.3/library/gzip.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 13.2. [`gzip`](https://python-all.ru/3.3/library/gzip.html#module-gzip) – Поддержка **gzip**-файлов

**Исходный код:** [Lib/gzip.py](https://python-all.ru/src/3.3/Lib/gzip.py)

---

Этот модуль предоставляет простой интерфейс для сжатия и распаковки файлов, подобно тому, как это делают программы GNU **gzip** и **gunzip**.

Сжатие данных обеспечивается модулем [`zlib`](https://python-all.ru/3.3/library/zlib.html#module-zlib).

Модуль [`gzip`](https://python-all.ru/3.3/library/gzip.html#module-gzip) предоставляет класс [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile), а также вспомогательные функции [`open()`](https://python-all.ru/3.3/library/gzip.html#gzip.open), [`compress()`](https://python-all.ru/3.3/library/gzip.html#gzip.compress) и [`decompress()`](https://python-all.ru/3.3/library/gzip.html#gzip.decompress). Класс [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) читает и записывает файлы в формате **gzip**, автоматически сжимая или распаковывая данные, так что они выглядят как обычный [*файловый объект*](https://python-all.ru/3.3/glossary.html#term-file-object).

Обратите внимание, что дополнительные форматы файлов, которые могут быть распакованы программами **gzip** и **gunzip**, например, созданные программами **compress** и **pack**, не поддерживаются этим модулем.

Модуль определяет следующие элементы:

#### `gzip.open(filename, mode='rb', compresslevel=9, encoding=None, errors=None, newline=None)`

Открывает файл, сжатый gzip, в двоичном или текстовом режиме и возвращает [*файловый объект*](https://python-all.ru/3.3/glossary.html#term-file-object).

Аргумент *filename* может быть фактическим именем файла (объект [`str`](https://python-all.ru/3.3/library/stdtypes.html#str) или [`bytes`](https://python-all.ru/3.3/library/functions.html#bytes)), или существующим файловым объектом для чтения или записи.

Аргумент *mode* может быть любым из `'r'`, `'rb'`, `'a'`, `'ab'`, `'w'`, или `'wb'` для двоичного режима, или `'rt'`, `'at'`, или `'wt'` для текстового режима. По умолчанию используется `'rb'`.

Аргумент *compresslevel* – целое число от 0 до 9, как в конструкторе [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile).

Для двоичного режима эта функция эквивалентна конструктору [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile): `GzipFile(filename, mode, compresslevel)`. В этом случае аргументы *encoding*, *errors* и *newline* указывать нельзя.

Для текстового режима создаётся объект [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile), который оборачивается в экземпляр [`io.TextIOWrapper`](https://python-all.ru/3.3/library/io.html#io.TextIOWrapper) с указанной кодировкой, стратегией обработки ошибок и символами конца строки.

Изменено в версии 3.3: Добавлена поддержка *filename* в качестве файлового объекта, поддержка текстового режима, и аргументов *encoding*, *errors* и *newline*.

#### `class gzip.GzipFile(filename=None, mode=None, compresslevel=9, fileobj=None, mtime=None)`

Конструктор класса [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile), который имитирует большинство методов [*файлового объекта*](https://python-all.ru/3.3/glossary.html#term-file-object), за исключением метода `truncate()`. По крайней мере один из аргументов *fileobj* или *filename* должен иметь нетривиальное значение.

Новый экземпляр класса создаётся на основе *fileobj*, который может быть обычным файлом, объектом [`io.BytesIO`](https://python-all.ru/3.3/library/io.html#io.BytesIO) или любым другим объектом, имитирующим файл. По умолчанию используется `None`; в этом случае *filename* открывается для предоставления файлового объекта.

Если *fileobj* не равен `None`, аргумент *filename* используется только для включения в заголовок файла **gzip**, который может содержать исходное имя файла без сжатия. По умолчанию он равен имени файла *fileobj*, если его можно определить; в противном случае по умолчанию используется пустая строка, и в этом случае исходное имя файла не включается в заголовок.

Аргумент *mode* может быть любым из `'r'`, `'rb'`, `'a'`, `'ab'`, `'w'`, или `'wb'`, в зависимости от того, будет ли файл читаться или записываться. По умолчанию используется режим *fileobj*, если его можно определить; в противном случае по умолчанию используется `'rb'`.

Обратите внимание, что файл всегда открывается в двоичном режиме. Чтобы открыть сжатый файл в текстовом режиме, используйте [`open()`](https://python-all.ru/3.3/library/gzip.html#gzip.open) (или оберните свой [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) с помощью [`io.TextIOWrapper`](https://python-all.ru/3.3/library/io.html#io.TextIOWrapper)).

Аргумент *compresslevel* – целое число от `0` до `9`, управляющее уровнем сжатия; `1` – самый быстрый и даёт наименьшее сжатие, а `9` – самый медленный и даёт наибольшее сжатие. `0` – это отсутствие сжатия. По умолчанию `9`.

Аргумент *mtime* – необязательная числовая метка времени, которая записывается в поток при сжатии. Все сжатые потоки **gzip** должны содержать метку времени. Если она опущена или равна `None`, используется текущее время. Этот модуль игнорирует метку времени при распаковке; однако некоторые программы, такие как **gunzip**, используют её. Формат метки времени такой же, как у возвращаемого значения `time.time()` и атрибута `st_mtime` объекта, возвращаемого `os.stat()`.

Вызов метода `close()` объекта [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) не закрывает *fileobj*, так как может потребоваться добавить ещё данные после сжатых данных. Это также позволяет передать объект [`io.BytesIO`](https://python-all.ru/3.3/library/io.html#io.BytesIO), открытый для записи, в качестве *fileobj* и получить результирующий буфер памяти с помощью метода [`getvalue()`](https://python-all.ru/3.3/library/io.html#io.BytesIO.getvalue) объекта [`io.BytesIO`](https://python-all.ru/3.3/library/io.html#io.BytesIO).

[`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) поддерживает интерфейс [`io.BufferedIOBase`](https://python-all.ru/3.3/library/io.html#io.BufferedIOBase), включая итерацию и оператор [`with`](https://python-all.ru/3.3/reference/compound_stmts.html#with). Не реализован только метод `truncate()`.

[`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) также предоставляет следующий метод:

#### `peek([n])`

Читает *n* несжатых байтов без изменения позиции в файле. Для выполнения вызова производится не более одного чтения из сжатого потока. Возвращаемое количество байтов может быть больше или меньше запрошенного.

> **Примечание**
>
> Хотя вызов [`peek()`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile.peek) не изменяет файловую позицию объекта [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile), он может изменить позицию базового файлового объекта (например, если [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) был создан с параметром *fileobj*).

Новое в версии 3.2.

Изменено в версии 3.1: Добавлена поддержка оператора [`with`](https://python-all.ru/3.3/reference/compound_stmts.html#with), а также аргумента *mtime*.

Изменено в версии 3.2: Добавлена поддержка файлов с дополнением нулями и непозиционируемых файлов.

Изменено в версии 3.3: Теперь реализован метод [`io.BufferedIOBase.read1()`](https://python-all.ru/3.3/library/io.html#io.BufferedIOBase.read1).

#### `gzip.compress(data, compresslevel=9)`

Сжимает *data* и возвращает объект [`bytes`](https://python-all.ru/3.3/library/functions.html#bytes), содержащий сжатые данные. *compresslevel* имеет то же значение, что и в конструкторе [`GzipFile`](https://python-all.ru/3.3/library/gzip.html#gzip.GzipFile) выше.

Новое в версии 3.2.

#### `gzip.decompress(data)`

Распаковывает *data* и возвращает объект [`bytes`](https://python-all.ru/3.3/library/functions.html#bytes), содержащий несжатые данные.

Новое в версии 3.2.

## 13.2.1. Примеры использования

Пример чтения сжатого файла:

```python
import gzip
with gzip.open('/home/joe/file.txt.gz', 'rb') as f:
    file_content = f.read()
```

Пример создания сжатого файла GZIP:

```python
import gzip
content = b"Lots of content here"
with gzip.open('/home/joe/file.txt.gz', 'wb') as f:
    f.write(content)
```

Пример сжатия существующего файла в формате GZIP:

```python
import gzip
with open('/home/joe/file.txt', 'rb') as f_in:
    with gzip.open('/home/joe/file.txt.gz', 'wb') as f_out:
        f_out.writelines(f_in)
```

Пример сжатия бинарной строки в формате GZIP:

```python
import gzip
s_in = b"Lots of content here"
s_out = gzip.compress(s_in)
```

> **См. также**
>
> **Модуль [`zlib`](https://python-all.ru/3.3/library/zlib.html#module-zlib)**
>
> Базовый модуль сжатия данных, необходимый для поддержки формата файлов
>
> **gzip**
>
> .