Add illustration of text resources in packages

Author: gjbex

source-code/README.md

@@ -35,3 +35,5 @@ was used to develop it.
 1. `error-handling`: simple illustration of error handling.
 1. `pyinstaller`: illustration of how to use `pyinstaller` to create
    standalone executables.
+1. `text-resources`: illustration on how to include text resources in
+   a package and conveniently access them.

source-code/text-resources/README.md

@@ -0,0 +1,15 @@
+# Text resources
+
+It can be convenient to bundle text files in a package for convenient
+distribution and access.
+
+
+## What is it?
+
+1. `show_text.py`: script that reads a text file from the package, and
+   prints it to standard output.
+1. `lib/utils': package with a text file.
+1. `lib/utils/text_data.txt`: text file that contains some text.
+1. `run_show_text.sh`: Bash script that runs the `show_text.py` script.  It
+   sets the `PYTHONPATH` environment variable to include the `lib` directory to
+   find the `utils` package.

source-code/text-resources/lib/utils/__init__.py

@@ -0,0 +1,4 @@
+This is a text
+with multiple lines
+to see how text resources
+work.

source-code/text-resources/lib/utils/text_data.txt

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+export PYTHONPATH=lib
+
+python show_text.py

source-code/text-resources/run_show_text.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env python
+
+import importlib.resources
+
+
+text = importlib.resources.read_text('utils', 'text_data.txt')
+print(text)