xixu-me/tzst

0 Fork 0

Files

T

xixu-me b5f7fa8dca Enhance documentation with SEO metadata and layout

Added a new custom layout template for SEO and social media meta tags. Updated multiple documentation files with metadata for improved search engine optimization and social sharing. Enhanced Sphinx configuration with additional HTML options and meta tags.

2025-06-06 17:50:43 +08:00

3.2 KiB

Raw Blame History

html_meta

description	keywords	og:title	og:description	twitter:title	twitter:description
Complete tzst API reference - Core functions, CLI tools, and exception handling for tar.zst archives	tzst API, Python API documentation, tar.zst API reference, archive API	tzst API Reference	Complete API reference for tzst - Core functions, CLI tools, and exception handling	tzst API Reference	Complete API reference for tzst - Core functions, CLI tools, and exception handling

API Reference

This section contains the complete API documentation for tzst, providing detailed information about classes, functions, and exceptions.

:maxdepth: 2

core
cli
exceptions

Overview

The tzst library provides both high-level convenience functions and a comprehensive class-based API for working with .tzst/.tar.zst archives. The library is designed with security, performance, and ease of use in mind.

Main Components

{doc}core: Core functionality including TzstArchive class and convenience functions for archive operations
{doc}cli: Command-line interface functions and utilities for batch operations
{doc}exceptions: Custom exception classes for comprehensive error handling and debugging

Architecture Overview

The tzst library follows a layered architecture:

High-Level API: Convenience functions for common operations
Class-Based API: TzstArchive class for advanced control
CLI Interface: Command-line tools for interactive and scripted use
Exception System: Comprehensive error handling for robust applications

Quick Reference

Core Classes

.. currentmodule:: tzst

.. autosummary::
   :nosignatures:
   
   TzstArchive

The main class for archive manipulation with context manager support and comprehensive functionality.

Convenience Functions

.. autosummary::
   :nosignatures:
   
   create_archive
   extract_archive
   list_archive
   test_archive

High-level functions that provide simple interfaces for common archive operations.

CLI Functions

.. currentmodule:: tzst.cli

.. autosummary::
   :nosignatures:
   
   main
   create_parser
   print_banner
   format_size
   validate_compression_level

Command-line interface utilities for interactive and batch operations.

Exception Classes

.. currentmodule:: tzst.exceptions

.. autosummary::
   :nosignatures:
   
   TzstError
   TzstArchiveError
   TzstCompressionError
   TzstDecompressionError

Exception hierarchy for comprehensive error handling and debugging support.

Key Features

🛡️ Security First

Built-in path traversal protection
Multiple security filter options
Safe extraction by default

⚡ High Performance

Zstandard compression with configurable levels
Streaming support for large archives
Memory-efficient operations

🔧 Developer Friendly

Clean, Pythonic API
Comprehensive error handling
Context manager support
Extensive documentation and examples

🌐 Cross-Platform

Works on Windows, macOS, and Linux
Consistent behavior across platforms
Native performance optimizations

3.2 KiB Raw Blame History