Metadata-Version: 2.3
Name: zip_gui
Version: 1.0.1
Summary: A clean and straightforward graphical interface for compressing (packing) and extracting (unpacking) archive files, built with Python and PySide6.
Project-URL: Homepage, https://github.com/twn39/zip-gui
Project-URL: Documentation, https://github.com/twn39/zip-gui
Project-URL: Repository, https://github.com/twn39/zip-gui
Project-URL: Source Code, https://github.com/twn39/zip-gui
Author-email: curry tang <twn39@163.com>
Maintainer-email: curry tang <twn39@163.com>
Keywords: GUI,compress,zip,zip gui
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: pyside6>=6.9.0
Requires-Dist: qtawesome>=1.4.0
Description-Content-Type: text/markdown

# ZipGUI - Simple Archive Utility

[![PyPI version](https://badge.fury.io/py/zip_gui.svg)](https://badge.fury.io/py/zip_gui)
[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
[![Framework](https://img.shields.io/badge/Framework-PySide6-informational)](https://www.qt.io/qt-for-python)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) <!-- 你可以添加一个 LICENSE 文件 -->

A clean and straightforward graphical interface for compressing (packing) and extracting (unpacking) archive files, built with Python and PySide6.

<div align="center">
  <img src="./screen.png" alt="图片描述" width="500"/>
</div>

## Overview

ZipGUI provides an intuitive user interface to manage your archive files effortlessly. 
Leveraging Python's built-in `shutil` module, it supports common archive formats like ZIP, TAR, GZ, BZ2, and XZ. 
Whether you need to quickly compress a folder or extract an archive, ZipGUI simplifies the process with visual feedback.

## ✨ Features

*   **Dual Mode Operation:** Easily switch between **Packing** (compressing files/folders) and **Unpacking** (extracting archives).
*   **Multiple Format Support:** Compresses to `zip`, `tar`, `gztar`, `bztar`, `xztar` formats.
*   **User-Friendly Interface:** Simple layout with clear options for selecting source paths, destination paths, and archive formats.

## 📋 Requirements

*   **Python:** 3.7 or higher
*   **PySide6:** The Qt for Python framework.

## 📦 Building Executable (Optional)

You can create a standalone executable using PyInstaller.

*   **Using the spec file (Recommended for more control):**
    Then build using the spec file:
    ```bash
    pyinstaller --clean ZipGUI.spec
    ```
*   **Simple one-file build:**
    ```bash
    pyinstaller --onefile --windowed --name="ZipGUI" app.py
    ```

The executable will be located in the `dist` folder.

## 🤝 Contributing

Contributions are welcome! If you have suggestions for improvements or find any bugs, please feel free to open an issue or submit a pull request.

1.  Fork the Project
2.  Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3.  Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4.  Push to the Branch (`git push origin feature/AmazingFeature`)
5.  Open a Pull Request

## 📄 License

Distributed under the MIT License. 