0.7.0 (Paving the way for the future)

0.7.0 - 2023-06-05

Highlights

Removed and modified a lot of features standing in the way of what's to come!

Fixed

• Jagged edges with LINES render method of kitty and iterm2 render styles (4d27055).

Added

• UrwidImageScreen.clear_images() (08f4e4d, 8b895ce).
• term_image.utils.get_cell_size() to the public API (#87).
• Support for terminal size-relative frame sizes (#89).
• Manual sizing (#89).
  • Allows setting both width and height explicitly via:
    • BaseImage.set_size()
    • BaseImage.size
• Support for terminal size-relative padding (#91).
• ANIM render method to the iterm2 render style (#92).
• term_image.exceptions.RenderError (#94).

Changed

• KeyboardInterrupt is no longer raised when SIGINT is used to end an animation (fa47742).
• UrwidImageScreen.clear() now clears images also (ed3baa3).
• Improved terminal cell size computation (#87).
• (BREAKING!) InvalidSizeError no longer inherits from ValueError (26ea969).
• (BREAKING!) UrwidImage now raises UrwidImageError instead of ValueError when rendered as a fixed widget (a612b59).
• (BREAKING!) Setting image size with Size.FIT_TO_WIDTH no longer influences size validation (#89).
• (BREAKING!) Redefined BaseImage.set_size() (#89).
  • Now allows specifying both width and height but only as integers.
    • No longer raises ValueError.
    • Now raises TypeError when both width and height are not None but not both are integers.
  • Redefined the maxsize parameter as frame_size.
    • No longer accepts None.
    • Now accepts non-positive integer tuple elements.
  • No longer raises ValueError: Available size too small.
  • No longer checks if the resulting size fits into a given frame size when width or height is also given as an integer.
    • No longer raises InvalidSizeError.
• (BREAKING!) Redefined pad_width and pad_height formatting parameters (#91).
  • No longer accept None.
  • Now accept non-positive integers.
  • Changed default values to 0 and -2 respectively.
• (BREAKING!) Changed N to A in the method field of the iterm2 style-speific render format specification (#92).
• (BREAKING!) term_image.exceptions.StyleError is now raised instead of style-specific exceptions (#93).
• (BREAKING!) term_image.exceptions.RenderError is now raised for errors that occur during rendering (#94).
• (BREAKING!) BaseImage.forced_support can no longer be set via instances (#95).
• (BREAKING!) ITerm2Image.native_anim_max_bytes can no longer be set or deleted via instances (#95).

Removed

• UrwidImage.clear_all() (08f4e4d) and UrwidImage.clear() (8b895ce).
  • Replaced by UrwidImageScreen.clear_images().
• Image scaling (#88).
  • scale parameter of BaseImage, BaseImage.from_file(), BaseImage.from_url(), etc.
  • scale, scale_x and scale_y properties of BaseImage.
  • Replaced by manual sizing (#89).
• Image sizing allowance (#89).
  • h_allow and v_allow parameters of BaseImage.set_size().
  • Replaced by terminal size-relative frame sizes (#89) and padding (#91).
• native and stall_native iterm2 style-specific render parameters (#92).
  • Replaced by the ANIM render method.
• Style-specific exceptions (#93).
  • GraphicsImageError
  • TextImageError
  • BlockImageError
  • ITerm2ImageError
  • KittyImageError
• Render style name property and custom render style class string representation (7d673dd).
  • <Style>Image.style
  • str(<Style>Image)
• term_image.image.ImageMeta from the public API (9168d17).