ZIPReader

package
v0.0.0-...-c858641 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 14, 2025 License: MIT Imports: 22 Imported by: 0

Documentation

Overview

This class implements a reader that can extract the content of individual files inside a ZIP archive. See also graphics.gd/classdb/ZIPPacker.

package main

import (
	"path/filepath"
	"strings"

	"graphics.gd/classdb/DirAccess"
	"graphics.gd/classdb/FileAccess"
	"graphics.gd/classdb/ZIPReader"
)

func ReadZipFile() []byte {
	var reader = ZIPReader.New()
	var err = reader.Open("user://archive.zip")
	if err != nil {
		return nil
	}
	var res = reader.ReadFile("hello.txt")
	reader.Close()
	return res
}

// Extract all files from a ZIP archive, preserving the directories within.
// This acts like the "Extract all" functionality from most archive managers.
func ExtractAllFromZip() {
	var reader = ZIPReader.New()
	reader.Open("res://archive.zip")

	// Destination directory for the extracted files (this folder must exist before extraction).
	// Not all ZIP archives put everything in a single root folder,
	// which means several files/folders may be created in `root_dir` after extraction.
	var rootDir = DirAccess.Open("user://")

	var files = reader.GetFiles()
	for _, filePath := range files {
		// If the current entry is a directory.
		if strings.HasSuffix(filePath, "/") {
			rootDir.MakeDirRecursive(filePath)
			continue
		}

		// Write file contents, creating folders automatically when needed.
		// Not all ZIP archives are strictly ordered, so we need to do this in case
		// the file entry comes before the folder entry.
		rootDir.MakeDirRecursive(filepath.Base(filepath.Join(rootDir.GetCurrentDir(), filePath)))
		var file = FileAccess.Open(filepath.Join(rootDir.GetCurrentDir(), filePath), FileAccess.Write)
		var buffer = reader.ReadFile(filePath)
		file.StoreBuffer(buffer)
	}
}

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Advanced

type Advanced = class

Advanced exposes a 1:1 low-level instance of the class, undocumented, for those who know what they are doing.

type Any

type Any interface {
	gd.IsClass
	AsZIPReader() Instance
}

type Expanded

type Expanded [1]gdclass.ZIPReader

func (Expanded) FileExists

func (self Expanded) FileExists(path string, case_sensitive bool) bool

Returns true if the file exists in the loaded zip archive.

Must be called after Instance.Open.

func (Expanded) ReadFile

func (self Expanded) ReadFile(path string, case_sensitive bool) []byte

Loads the whole content of a file in the loaded zip archive into memory and returns it.

Must be called after Instance.Open.

type Extension

type Extension[T gdclass.Interface] struct{ gdclass.Extension[T, Instance] }

Extension can be embedded in a new struct to create an extension of this class. T should be the type that is embedding this Extension

func (*Extension[T]) AsObject

func (self *Extension[T]) AsObject() [1]gd.Object

func (*Extension[T]) AsRefCounted

func (self *Extension[T]) AsRefCounted() [1]gd.RefCounted

func (*Extension[T]) AsZIPReader

func (self *Extension[T]) AsZIPReader() Instance

type ID

type ID Object.ID

ID is a typed object ID (reference) to an instance of this class, use it to store references to objects with unknown lifetimes, as an ID will not panic on use if the underlying object has been destroyed.

func (ID) Instance

func (id ID) Instance() (Instance, bool)

type Instance

type Instance [1]gdclass.ZIPReader

Instance of the class with convieniently typed arguments and results.

var Nil Instance

Nil is a nil/null instance of the class. Equivalent to the zero value.

func New

func New() Instance

func (Instance) AsObject

func (self Instance) AsObject() [1]gd.Object

func (Instance) AsRefCounted

func (self Instance) AsRefCounted() [1]gd.RefCounted

func (Instance) AsZIPReader

func (self Instance) AsZIPReader() Instance

func (Instance) Close

func (self Instance) Close() error

Closes the underlying resources used by this instance.

func (Instance) FileExists

func (self Instance) FileExists(path string) bool

Returns true if the file exists in the loaded zip archive.

Must be called after Instance.Open.

func (Instance) GetFiles

func (self Instance) GetFiles() []string

Returns the list of names of all files in the loaded archive.

Must be called after Instance.Open.

func (Instance) ID

func (self Instance) ID() ID

func (Instance) Open

func (self Instance) Open(path string) error

Opens the zip archive at the given 'path' and reads its file index.

func (Instance) ReadFile

func (self Instance) ReadFile(path string) []byte

Loads the whole content of a file in the loaded zip archive into memory and returns it.

Must be called after Instance.Open.

func (*Instance) SetObject

func (self *Instance) SetObject(obj [1]gd.Object) bool

func (Instance) Virtual

func (self Instance) Virtual(name string) reflect.Value

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL