All Versions
10
Latest Version
Avg Release Cycle
87 days
Latest Release
199 days ago

Changelog History

  • v2.2.0 Changes

    November 27, 2025

    ✨ Added

    • 🆕 New API exceptions (TooManyRequestsError, FreeAppLimitedError, DisabledForFreeAppError, WrongFormatStructureError, InvalidFormatError).
    • ⚡️ Public Config class with support for in-memory runtime overrides (update, clear_overrides, get).
    • Masking of sensitive values (e.g., API tokens) in string representations.
    • 🔦 Exposed Config at the top-level package for external usage.

    🛠 🐛 Fixed

    • Improved _ChunkedFileWrapper to rewind file streams before upload, preventing EMPTY_FILE errors and truncated uploads. Added __len__, __iter__, and __next__ methods for better streaming client compatibility and chunk iteration.
    • Improved JSON response detection in vertopal.api.interface._Interface.send_request
      to correctly handle Content-Type headers with parameters (e.g. application/json; charset=utf-8).

    Full Changelog: v2.1.0...v2.2.0

  • v2.1.0 Changes

    November 05, 2025

    ✨ Added

    • 👌 Support for configurable upload and download chunk sizes:
      • New settings: stream_upload_chunk_size and stream_download_chunk_size (fall back to stream_chunk_size if unset).
      • New _ChunkedFileWrapper internal utility to enforce fixed chunk sizes during streaming.
      • New _Interface.upload_chunk_size and _Interface.download_chunk_size properties to resolve effective chunk sizes.
      • API.upload_file now accepts an optional chunk_size parameter, defaulting to configuration values.

    🛠 🐛 Fixed

    • 🛠 Fixed _ChunkedFileWrapper.read(-1) to return the full file instead of a single chunk, preventing truncated uploads for binary files.
    • Corrected send_request JSON validation logic to check the Content-Type header instead of endpoint path, preventing errors when handling binary responses (e.g., file downloads).
    • Explicitly use .value for InterfaceStrategyMode and InterfaceSublistMode to ensure consistent string output across Python versions (avoiding f-string differences introduced after Python 3.10).

    🛠 Changed

    • 🔨 Refactored type hints to use built-in generics (list, dict, and tuple) instead of typing.List, typing.Dict, and typing.Tuple.
    • ⚡️ Updated README installer instructions to use a unified endpoint for macOS and Linux (https://run.vertopal.com/cli/unix).

    Full Changelog: v2.0.3...v2.1.0

  • v2.0.3 Changes

    September 01, 2025

    🛠 🐛 Fixed

    • ⚡️ Updated GitHub Actions build matrix to replace ubuntu-20.04 with ubuntu-22.04 in preparation for the deprecation and removal of the ubuntu-20.04 runner image on GitHub Actions (April 1, 2025). This ensures continued availability of Linux builds and avoids scheduled brownout outages.

    Full Changelog: v2.0.2...v2.0.3

  • v2.0.2 Changes

    September 01, 2025

    Note

    🏗 This version was published to PyPI but no binary build using GitHub Actions was created.
    🚀 2.0.3 is the latest patch release and should be preferred.

    🛠 🐛 Fixed

    • ✂ Removed slots=True from @dataclass declarations to restore compatibility with Python 3.9.

    Full Changelog: v2.0.1...v2.0.2

  • v2.0.1 Changes

    September 01, 2025

    Note

    🏗 This version was published to PyPI but no binary build using GitHub Actions was created.
    🚀 2.0.3 is the latest patch release and should be preferred.

    🛠 🐛 Fixed

    • ⚡️ Updated GitHub Actions workflow to replace deprecated actions/upload-artifact@v3 and actions/download-artifact@v3 with v4 equivalents.
    • 🚀 Adjusted artifact download step to use pattern and merge-multiple for collecting OS-specific build artifacts in a single directory during release.

    Full Changelog: v2.0.0...v2.0.1

  • v2.0.0 Changes

    September 01, 2025

    Note

    🏗 This version was published to PyPI but no binary build using GitHub Actions was created.
    🚀 2.0.3 is the latest patch release and should be preferred.

    📦 Migration Guide (from 1.x to 2.0.0)

    ⬆️ If you are upgrading from Vertopal CLI 1.x, please review and apply the following changes to ensure a smooth transition:

    1. Reconfigure private credentials

    0️⃣ 2. Note the new public default credential

    💥 For full details, see the Breaking Changes and Added sections below.

    🚚 🚨 Removed (Breaking Changes)

    • ⬇️ Dropped support for Python 3.7 and 3.8 — the package now requires Python 3.9 or later (see pyproject.toml).

    • ✂ Removed support for legacy import/layout patterns; the project now uses the src/ package layout as the canonical layout.

    • Removed several legacy public symbols previously exported from the package root to provide a smaller, stable public surface (see vertopal/ __init__.py).

    • ✂ Removed the top-level re-export of internal API classes. Consumers should import low-level clients directly from their modules (for example vertopal.api.v1.API).

    • ✂ Removed several command-line flags from the vertopal command: --app, --token, --overwrite, and --silent.

    • 💅 Configuration key changed — the application ID is now stored under the INI-style key api.app in the user configuration file (previously api.appid).
      Users upgrading from earlier versions must reconfigure their private credentials to continue using them.

    ✨ Added

    • 👌 Improvements to the vertopal CLI (see vertopal convert --help):

      • Bulk conversion support: accept files, directories, globs and brace/range patterns (e.g. {a,b}, {1..5}, **/*).
      • Read from stdin by using - as an input source.
      • Write to stdout by passing --output -.
      • Accept a file list as input and override output filename or output directory per invocation.
      • Recursive directory traversal and exclude-by-pattern support.
      • Filter inputs by modification date using an ISO 8601 --modified-since filter.

    • ➕ Added credential management to centralize application ID and security token handling (see vertopal/api/credential.py).

    • 🔨 Introduced a new cli subpackage and refactored command managers for clearer separation of concerns (see vertopal/cli).

    • 👀 Reworked the CLI entry point and argument parser for clearer help, subcommands, and argument validation (see vertopal/vertopal.py).

    • Added Readable and Writable I/O protocols and three adapter modules: file, in-memory, and stdio for consistent I/O abstractions (see vertopal/io/protocols.py, and vertopal/io/ __init__.py).

    • ➕ Added structured API response wrappers and richer helpers to the v1 client to simplify caller code (vertopal/api/v1.py).

    • ➕ Added a centralized settings module, enums, types, and Prism terminal styling helper for consistency across the codebase (see vertopal/settings.py, vertopal/enums.py, vertopal/types.py, and vertopal.utils.prism).

    • ➕ Added a public default credential to simplify first-run experience: the CLI ships with a non-authenticated, limited credential (app: free, token: FREE-TOKEN) so users can try the service without creating an account. This credential is intended for personal testing and evaluation and is subject to daily rate limits; production workloads should configure a private credential in the user config.

    🛠 Changed

    • 👀 Moved terminal and CLI internals into the new cli subpackage; command registration and adapter responsibilities were reorganized into dedicated manager modules (see vertopal/cli).
    • Converted API client methods to return lightweight, structured response wrappers rather than raw dicts/tuples to improve ergonomics and error handling (see vertopal/api/v1.py, and vertopal/utils/data_wrappers.py).
    • 📇 Stabilized packaging and metadata to the src/ layout and modern build metadata (see pyproject.toml, and setup.py).
    • 🚚 Moved API exception types into the top-level vertopal.exceptions module and simplified exception usage across modules.
    • 🏗 Relocated the build helper into tools/build.py for clearer separation of tooling code.
    • 👀 Reworked the configuration module to use a singleton Config and safer load/write semantics (see vertopal/utils/config.py).
    • 🔧 Redesigned vertopal.api.v1.API to be an instantiable client object rather than a module-level static; this enables per-instance configuration and better testability.
    • ⚡️ Updated the vertopal config subcommand: the command's interface and behavior for modifying the user configuration file has been redesigned. It now exposes clearer interactive and non-interactive options, safer write semantics, and explicit flags for common keys (see vertopal config --help).

    🛠 🐛 Fixed

    • 🛠 Fixed multiple resource leaks and inconsistent timeout usages in HTTP calls; timeouts are now applied uniformly for requests, uploads, and downloads.

    Full Changelog: v1.1.0...v2.0.0

  • v1.1.0 Changes

    January 07, 2024

    🚀 Features

    • ➕ Add optional --beautify (flag) argument to the vertopal api command to pretty-print to the standard output.
    • Add 3 new vertopal.api.v1.API methods: format_get(), convert_graph(), and convert_formats().

    🛠 🐛 Bug Fixes

    • 📦 Use minimum version for package dependencies.

    Full Changelog: v1.0.6...v1.1.0

  • v1.0.6 Changes

    December 18, 2023

    🛠 🐛 Bug Fixes

    • Build Windows binary using PyInstaller 5.7.0 and a compiled bootloader to prevent false-positive antivirus alerts.

    Full Changelog: v1.0.5...v1.0.6

  • v1.0.5 Changes

    October 25, 2023

    🚀 Features

    • Introducing api command for sending authenticated HTTP requests to the Vertopal API.
      To view the full api command help, execute vertopal api --help in the terminal.

    Full Changelog: v1.0.4...v1.0.5

  • v1.0.4 Changes

    October 10, 2023

    🚀 Features

    • Introducing Converter class for easier file convert implementation in your projects.
    • ➕ Added custom exceptions to give developers better control on the conversion errors.

    📈 Improvements

    • 📦 Use different product names in User-Agent to distinguish between the requests of CLI and Python package.

    🛠 🐛 Bug Fixes

    • Increase the connection timeout for the upload and the download tasks for upload/downloading the bigger-sized files.

    Full Changelog: v1.0.3...v1.0.4