I will become the next package

tivars/PIL/TI8caPlugin.py

@@ -1,3 +1,8 @@
+"""
+Plugin for `.8ca` files (`TIImage`)
+"""
+
+
 from tivars import TIImage
 from .common import *
 

tivars/PIL/TI8ciPlugin.py

@@ -1,3 +1,8 @@
+"""
+Plugin for `.8ci` files (`TIPicture`)
+"""
+
+
 from tivars import TIPicture
 from .common import *
 

tivars/PIL/TI8xiPlugin.py

@@ -1,3 +1,8 @@
+"""
+Plugin for `.8xi` files (`TIMonoPicture`)
+"""
+
+
 from tivars import TIMonoPicture
 from .common import *
 

tivars/PIL/__init__.py

@@ -1,3 +1,8 @@
+"""
+PIL plugin to support TI pictures and images
+"""
+
+
 from .TI8xiPlugin import TI8xiImageFile
 from .TI8ciPlugin import TI8ciImageFile
 from .TI8caPlugin import TI8caImageFile

tivars/PIL/common.py

@@ -1,3 +1,8 @@
+"""
+Common import for PIL plugins
+"""
+
+
 import numpy as np
 import warnings
 
@@ -57,7 +62,7 @@ def _save(cls, im, fp, format=None, **params):
 
         :param im: The image to save
         :param fp: The file pointer
-        :param format: The format to save with (defaults to the image's known format)
+        :param format: The format to save with (defaults to the image's known format) (unused)
         :param params: Additional encoder parameters (empty)
         """
 

tivars/__init__.py

@@ -1,3 +1,8 @@
+"""
+A library for interacting with TI-(e)z80 (82/83/84 series) calculator files
+"""
+
+
 from .tokenizer import *
 from .types import *
 from .models import *

tivars/models/__init__.py

@@ -1,3 +1,8 @@
+"""
+Utilities for managing calc models and OS versions
+"""
+
+
 from .model import *
 from .versions import *
 

tivars/models/model.py

@@ -1,3 +1,8 @@
+"""
+Model and feature definitions
+"""
+
+
 import os
 
 from functools import total_ordering

tivars/models/versions.py

@@ -1,3 +1,8 @@
+"""
+OS version definitions
+"""
+
+
 import tivars.tokenizer.tokens.scripts.parse as parse
 
 from .model import *

tivars/tokenizer/__init__.py

@@ -1,3 +1,8 @@
+"""
+Tokenization utilities derived from the token sheets
+"""
+
+
 from typing import ByteString
 
 from tivars.data import String

tivars/types/__init__.py

@@ -1,3 +1,9 @@
+"""
+Parsers for the TI var types
+"""
+
+
+# Makes pydoctor happy
 from typing import TYPE_CHECKING
 
 from .appvar import *