IVE_TANIM - Image-Video-Email Functionality from Tanim, for Tanim

NPRSTUFF is a repository that started off with tools that downloaded public radio programs like NPR Fresh Air, Wait Wait…Don’t Tell Me, and This American Life. I then expanded it to become a grab bag of altogether different types of functionalities. Dependency managament was stupidly onerous.

This repository, IVE_TANIM (pronounced ivy), carves out the image-video-email low-level functionality and command line executables into their own repository. This functionality continues and deprecated-land lives for now in NPRSTUFF, but in the relatively immediate big-rock-candy-mountain future I will move the older “relying on NPRSTUFF” dependencies into IVE_TANIM. Single but obvious big benefit:

• IVE_TANIM contains a few, easy-to-meet Python module dependencies.

The comprehensive documentation lives in HTML created with Sphinx, and now in the IVE_TANIM Sphinx Page for this project. To generate the documentation, go to the docsrc subdirectory. In that directory, run make html. Load docsrc/build/html/index.html into a browser to see the documentation.

There’s also a demonstration presentation! I am/have (depending on whether you’re from the past/future) made a presentation to the Sacramento Python Meetup on Thursday, 3 NOVEMBER 2022.

• Link to the powerpoint presentation.

• Link to the keynote presentation.

• Link to the YouTube presentation.

• Link to the full video.

Back then I called it IV_TANIM.

Installation Instructions

Installing this Python module is easy.

• If you want to get it from Github, then run this command,

  python3 -m pip install --user git+https://github.com/tanimislam/ive_tanim#egginfo=ive_tanim
  

• If you want to have more control, follow these several steps.

  git clone https://github.com/tanimislam/ive_tanim
  cd ive_tanim
  python3 -m pip install --user -e .
  

Both installation workflows install IVE_TANIM into your user Python folder (~/.local by default on Linux and Mac OS X systems). Its executables are installed into ~/.local/bin by default on Linux or Mac OS X systems.

Table of Contents

• 1. Core Functionality
  • 1.1. autoCropImage
  • 1.2. convertImage
    • 1.2.1. convertImage movie
    • 1.2.2. convertImage aspected
    • 1.2.3. convertImage fromimages
  • 1.3. myrst2html
  • 1.4. simple_email_config
    • 1.4.1. simple_email_config show_me and set_me
    • 1.4.2. simple_email_config set_smtp and show_smtp
    • 1.4.3. simple_email_config show_aliases, add_alias, remove_aliases
  • 1.5. simple_email
• 2. Initialization API
  • baseConfDir
  • configFile
  • create_config()
• 3. Core APIs
  • 3.1. autocrop_image module
    • autocrop_image()
    • autocrop_perproc()
    • crop_pdf()
    • crop_pdf_singlepage()
    • get_boundingbox()
  • 3.2. convert_image module
    • create_images2mp4dict()
    • make_aspected_mp4video()
    • mp4fromimages()
    • mp4togif()
    • pdf2png()
    • png2png()
  • 3.3. rst2html module
    • MyHTMLTranslator
    • check_valid_RST()
    • cid_out_mimeMultiMessage()
    • config_email_alias()
    • config_email_default_sender()
    • config_email_default_smtp()
    • convert_string_RST()
    • create_collective_email_full()
    • create_rfc5322_email()
    • get_attachment_object()
    • parse_rfc5322_email()
    • send_email_localsmtp()