python3: Fix package descriptions

* Fix default Python package description not included in individual package descriptions * Update default Python package description text (from General Python FAQ, "What is Python?") * Add package descriptions for Python module packages * Reduce duplication in package titles Signed-off-by: Jeffery To <jeffery.to@gmail.com>
2025-12-21 21:24:31 +04:00 · 2023-07-13 13:39:35 +08:00
parent 87631ecdd4
commit 329f9a1391
24 changed files with 198 additions and 42 deletions
--- a/lang/python/python3/files/python3-package-asyncio.mk
+++ b/lang/python/python3/files/python3-package-asyncio.mk
@@ -7,10 +7,16 @@

 define Package/python3-asyncio
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) asyncio module
+  TITLE+= asyncio module
  DEPENDS:=+python3-light
 endef

+define Package/python3-asyncio/description
+$(call Package/python3/Default/description)
+
+This package contains the asyncio module.
+endef
+
 $(eval $(call Py3BasePackage,python3-asyncio, \
 	/usr/lib/python$(PYTHON3_VERSION)/asyncio \
 ))
--- a/lang/python/python3/files/python3-package-cgi.mk
+++ b/lang/python/python3/files/python3-package-cgi.mk
@@ -7,16 +7,27 @@

 define Package/python3-cgi
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) cgi module
+  TITLE+= cgi module
  DEPENDS:=+python3-light +python3-email
 endef

 define Package/python3-cgitb
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) cgitb module
+  TITLE+= cgitb module
  DEPENDS:=+python3-light +python3-cgi +python3-pydoc
 endef

+define Package/python3-cgi/description
+$(call Package/python3/Default/description)
+
+This package contains the cgi module.
+endef
+
+define Package/python3-cgitb/description
+$(call Package/python3/Default/description)
+
+This package contains the cgitb module.
+endef

 $(eval $(call Py3BasePackage,python3-cgi, \
 	/usr/lib/python$(PYTHON3_VERSION)/cgi.py \
--- a/lang/python/python3/files/python3-package-codecs.mk
+++ b/lang/python/python3/files/python3-package-codecs.mk
@@ -7,10 +7,16 @@

 define Package/python3-codecs
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) codecs + unicode support
+  TITLE+= codecs/Unicode support
  DEPENDS:=+python3-light
 endef

+define Package/python3-codecs/description
+$(call Package/python3/Default/description)
+
+This package contains codecs and Unicode support.
+endef
+
 $(eval $(call Py3BasePackage,python3-codecs, \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_codecs_cn.$(PYTHON3_SO_SUFFIX) \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_codecs_hk.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-ctypes.mk
+++ b/lang/python/python3/files/python3-package-ctypes.mk
@@ -7,10 +7,16 @@

 define Package/python3-ctypes
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) ctypes module
+  TITLE+= ctypes module
  DEPENDS:=+python3-light +libffi
 endef

+define Package/python3-ctypes/description
+$(call Package/python3/Default/description)
+
+This package contains the ctypes module.
+endef
+
 $(eval $(call Py3BasePackage,python3-ctypes, \
 	/usr/lib/python$(PYTHON3_VERSION)/ctypes \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_ctypes.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-dbm.mk
+++ b/lang/python/python3/files/python3-package-dbm.mk
@@ -7,10 +7,16 @@

 define Package/python3-dbm
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) dbm module
+  TITLE+= dbm module
  DEPENDS:=+python3-light +libgdbm
 endef

+define Package/python3-dbm/description
+$(call Package/python3/Default/description)
+
+This package contains the dbm module.
+endef
+
 $(eval $(call Py3BasePackage,python3-dbm, \
 	/usr/lib/python$(PYTHON3_VERSION)/dbm \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_dbm.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-decimal.mk
+++ b/lang/python/python3/files/python3-package-decimal.mk
@@ -7,10 +7,16 @@

 define Package/python3-decimal
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) decimal module
+  TITLE+= decimal module
  DEPENDS:=+python3-light
 endef

+define Package/python3-decimal/description
+$(call Package/python3/Default/description)
+
+This package contains the decimal module.
+endef
+
 $(eval $(call Py3BasePackage,python3-decimal, \
 	/usr/lib/python$(PYTHON3_VERSION)/decimal.py \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_decimal.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-dev.mk
+++ b/lang/python/python3/files/python3-package-dev.mk
@@ -7,10 +7,17 @@

 define Package/python3-dev
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) development files
+  TITLE+= development files
  DEPENDS:=+python3 +python3-lib2to3
 endef

+define Package/python3-dev/description
+$(call Package/python3/Default/description)
+
+This package contains files for building Python modules, extending the
+Python interpreter, or embedded Python in applications.
+endef
+
 define Py3Package/python3-dev/install
 	$(INSTALL_DIR) $(1)/usr/bin $(1)/usr/lib
 	$(CP) $(PKG_INSTALL_DIR)/usr/bin/python$(PYTHON3_VERSION)-config $(1)/usr/bin
--- a/lang/python/python3/files/python3-package-distutils.mk
+++ b/lang/python/python3/files/python3-package-distutils.mk
@@ -7,10 +7,16 @@

 define Package/python3-distutils
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) distutils module
+  TITLE+= distutils module
  DEPENDS:=+python3-light +python3-email
 endef

+define Package/python3-distutils/description
+$(call Package/python3/Default/description)
+
+This package contains the distutils module.
+endef
+
 $(eval $(call Py3BasePackage,python3-distutils, \
 	/usr/lib/python$(PYTHON3_VERSION)/distutils \
 ))
--- a/lang/python/python3/files/python3-package-email.mk
+++ b/lang/python/python3/files/python3-package-email.mk
@@ -7,10 +7,16 @@

 define Package/python3-email
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) email module
+  TITLE+= email module
  DEPENDS:=+python3-light
 endef

+define Package/python3-email/description
+$(call Package/python3/Default/description)
+
+This package contains the email module.
+endef
+
 $(eval $(call Py3BasePackage,python3-email, \
 	/usr/lib/python$(PYTHON3_VERSION)/email \
 ))
--- a/lang/python/python3/files/python3-package-lib2to3.mk
+++ b/lang/python/python3/files/python3-package-lib2to3.mk
@@ -7,10 +7,16 @@

 define Package/python3-lib2to3
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) lib2to3 module
+  TITLE+= lib2to3 module
  DEPENDS:=+python3
 endef

+define Package/python3-lib2to3/description
+$(call Package/python3/Default/description)
+
+This package contains the lib2to3 module.
+endef
+
 $(eval $(call Py3BasePackage,python3-lib2to3, \
 	/usr/lib/python$(PYTHON3_VERSION)/lib2to3 \
 	, \
--- a/lang/python/python3/files/python3-package-logging.mk
+++ b/lang/python/python3/files/python3-package-logging.mk
@@ -7,10 +7,16 @@

 define Package/python3-logging
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) logging module
+  TITLE+= logging module
  DEPENDS:=+python3-light
 endef

+define Package/python3-logging/description
+$(call Package/python3/Default/description)
+
+This package contains the logging module.
+endef
+
 $(eval $(call Py3BasePackage,python3-logging, \
 	/usr/lib/python$(PYTHON3_VERSION)/logging \
 ))
--- a/lang/python/python3/files/python3-package-lzma.mk
+++ b/lang/python/python3/files/python3-package-lzma.mk
@@ -7,10 +7,16 @@

 define Package/python3-lzma
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) lzma module
+  TITLE+= lzma module
  DEPENDS:=+python3-light +liblzma
 endef

+define Package/python3-lzma/description
+$(call Package/python3/Default/description)
+
+This package contains the lzma module.
+endef
+
 $(eval $(call Py3BasePackage,python3-lzma, \
 	/usr/lib/python$(PYTHON3_VERSION)/lzma.py \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_lzma.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-multiprocessing.mk
+++ b/lang/python/python3/files/python3-package-multiprocessing.mk
@@ -7,10 +7,16 @@

 define Package/python3-multiprocessing
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) multiprocessing
+  TITLE+= multiprocessing module
  DEPENDS:=+python3-light
 endef

+define Package/python3-multiprocessing/description
+$(call Package/python3/Default/description)
+
+This package contains the multiprocessing module.
+endef
+
 $(eval $(call Py3BasePackage,python3-multiprocessing, \
 	/usr/lib/python$(PYTHON3_VERSION)/multiprocessing \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_multiprocessing.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-ncurses.mk
+++ b/lang/python/python3/files/python3-package-ncurses.mk
@@ -7,10 +7,16 @@

 define Package/python3-ncurses
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) ncurses module
+  TITLE+= ncurses module
  DEPENDS:=+python3-light +libncursesw
 endef

+define Package/python3-ncurses/description
+$(call Package/python3/Default/description)
+
+This package contains the ncurses module.
+endef
+
 $(eval $(call Py3BasePackage,python3-ncurses, \
 	/usr/lib/python$(PYTHON3_VERSION)/curses \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_curses.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-openssl.mk
+++ b/lang/python/python3/files/python3-package-openssl.mk
@@ -7,10 +7,16 @@

 define Package/python3-openssl
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) SSL module
+  TITLE+= ssl module
  DEPENDS:=+python3-light +libopenssl +ca-certs
 endef

+define Package/python3-openssl/description
+$(call Package/python3/Default/description)
+
+This package contains the ssl module.
+endef
+
 $(eval $(call Py3BasePackage,python3-openssl, \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_hashlib.$(PYTHON3_SO_SUFFIX) \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_ssl.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-pydoc.mk
+++ b/lang/python/python3/files/python3-package-pydoc.mk
@@ -7,10 +7,16 @@

 define Package/python3-pydoc
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) pydoc module
+  TITLE+= pydoc module
  DEPENDS:=+python3-light
 endef

+define Package/python3-pydoc/description
+$(call Package/python3/Default/description)
+
+This package contains the pydoc module.
+endef
+
 $(eval $(call Py3BasePackage,python3-pydoc, \
 	/usr/lib/python$(PYTHON3_VERSION)/doctest.py \
 	/usr/lib/python$(PYTHON3_VERSION)/pydoc.py \
--- a/lang/python/python3/files/python3-package-readline.mk
+++ b/lang/python/python3/files/python3-package-readline.mk
@@ -7,10 +7,16 @@

 define Package/python3-readline
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) readline module
+  TITLE+= readline module
  DEPENDS:=+python3-light +libreadline
 endef

+define Package/python3-readline/description
+$(call Package/python3/Default/description)
+
+This package contains the readline module.
+endef
+
 $(eval $(call Py3BasePackage,python3-readline, \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/readline.$(PYTHON3_SO_SUFFIX) \
 ))
--- a/lang/python/python3/files/python3-package-sqlite3.mk
+++ b/lang/python/python3/files/python3-package-sqlite3.mk
@@ -7,10 +7,16 @@

 define Package/python3-sqlite3
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) sqlite3 module
+  TITLE+= sqlite3 module
  DEPENDS:=+python3-light +libsqlite3
 endef

+define Package/python3-sqlite3/description
+$(call Package/python3/Default/description)
+
+This package contains the sqlite3 module.
+endef
+
 $(eval $(call Py3BasePackage,python3-sqlite3, \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_sqlite3.$(PYTHON3_SO_SUFFIX) \
 	/usr/lib/python$(PYTHON3_VERSION)/sqlite3 \
--- a/lang/python/python3/files/python3-package-unittest.mk
+++ b/lang/python/python3/files/python3-package-unittest.mk
@@ -7,10 +7,16 @@

 define Package/python3-unittest
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) unittest module
+  TITLE+= unittest module
  DEPENDS:=+python3-light
 endef

+define Package/python3-unittest/description
+$(call Package/python3/Default/description)
+
+This package contains the unittest module.
+endef
+
 $(eval $(call Py3BasePackage,python3-unittest, \
 	/usr/lib/python$(PYTHON3_VERSION)/unittest \
 ))
--- a/lang/python/python3/files/python3-package-urllib.mk
+++ b/lang/python/python3/files/python3-package-urllib.mk
@@ -7,10 +7,16 @@

 define Package/python3-urllib
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) URL library module
+  TITLE+= URL handling modules
  DEPENDS:=+python3-light +python3-email
 endef

+define Package/python3-urllib/description
+$(call Package/python3/Default/description)
+
+This package contains the URL handling modules.
+endef
+
 $(eval $(call Py3BasePackage,python3-urllib, \
 	/usr/lib/python$(PYTHON3_VERSION)/urllib \
 ))
--- a/lang/python/python3/files/python3-package-uuid.mk
+++ b/lang/python/python3/files/python3-package-uuid.mk
@@ -7,10 +7,16 @@

 define Package/python3-uuid
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) UUID module
+  TITLE+= uuid module
  DEPENDS:=+python3-light +libuuid
 endef

+define Package/python3-uuid/description
+$(call Package/python3/Default/description)
+
+This package contains the uuid module.
+endef
+
 $(eval $(call Py3BasePackage,python3-uuid, \
 	/usr/lib/python$(PYTHON3_VERSION)/uuid.py \
 	/usr/lib/python$(PYTHON3_VERSION)/lib-dynload/_uuid.$(PYTHON3_SO_SUFFIX) \
--- a/lang/python/python3/files/python3-package-venv.mk
+++ b/lang/python/python3/files/python3-package-venv.mk
@@ -7,10 +7,16 @@

 define Package/python3-venv
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) venv module
+  TITLE+= venv module
  DEPENDS:=+python3
 endef

+define Package/python3-venv/description
+$(call Package/python3/Default/description)
+
+This package contains the venv module.
+endef
+
 $(eval $(call Py3BasePackage,python3-venv, \
 	/usr/lib/python$(PYTHON3_VERSION)/ensurepip \
 	/usr/lib/python$(PYTHON3_VERSION)/venv \
--- a/lang/python/python3/files/python3-package-xml.mk
+++ b/lang/python/python3/files/python3-package-xml.mk
@@ -7,10 +7,16 @@

 define Package/python3-xml
 $(call Package/python3/Default)
-  TITLE:=Python $(PYTHON3_VERSION) xml libs
+  TITLE+= XML modules
  DEPENDS:=+python3-light +python3-urllib
 endef

+define Package/python3-xml/description
+$(call Package/python3/Default/description)
+
+This package contains the XML modules.
+endef
+
 $(eval $(call Py3BasePackage,python3-xml, \
 	/usr/lib/python$(PYTHON3_VERSION)/xml \
 	/usr/lib/python$(PYTHON3_VERSION)/xmlrpc \