User Options: move loading to the common role

Improve the group_vars/README comments and instructions.

Remove --extra-vars comments in mythtv.yml

Add the only list of Free BSD packages I've found in a README.

Author: Bill Meek

group_vars/README

@@ -1,25 +1,31 @@
 The user_options.yml file is NOT maintained by git. It's here for
 users to add information unique to their MythTV Ansible playbook
-runs.
+runs. A git pull won't overwrite it.
 
-The Ansible precedence list can be found here:
+Variables set here will override those in the all.yml file in this
+directory. The full Ansible precedence list can be found here:
 https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_variables.html
+Command line settings (like: --extra-vars='{"qt6": true}') would override settings
+here.
 
-The contents of a user_options.yml file would look like the following -
-everything between the long underscore lines:
-_____________________________________________________________________
+The contents of a user_options.yml file could look like the following -
+things between the long underscore lines:
+_______________________________________________________________________
 
 ---
 
-# Create a Python Virtual Environment:
+# Set to false to enable use of the Single Role
+use_old_roles: false
+
+# Set to true to create a Python Virtual Environment:
 venv_active: true
 
 # Change the default Virtual Environment path from ~/.virtualenvs/mythtv
 # to somewhere else:
 # venv_path: /something/you_prefer
 
-# Turn this on to load Qt6 packages rather than Qt5:
+# Set this to true to load Qt6 packages rather than Qt5:
 qt6: false
 
 ...
-_____________________________________________________________________
+_______________________________________________________________________

mythtv.yml

@@ -12,13 +12,6 @@
 # <host> = one of the names under 'hosts:' in the hosts.yml file. See
 # README.md for help.
 #
-# The following will get removed or moved to README.md
-#     With: --extra-vars='{"qt6": true}'             # Single Role WIP for Qt6
-#     With: --extra-vars='{"use_old_roles": false}'  # Single Role WIP
-#     With: --extra-vars='{"venv_active": true}'     # Builds a Python venv
-#     With: --extra-vars='{"venv_path": 'new path'}' # Allows changing the
-#           default venv_path which is ~/.virtualenvs/mythtv
-#
 
 ---
 

roles/common/tasks/main.yml

@@ -41,6 +41,14 @@
       - "ansible_version.full:               {{ ansible_version.full }}"
   when: ansible_lsb.major_release is undefined
 
+- name: Load a user_options.yml file if it exists
+  include_vars:
+    file: '{{ item }}'
+  with_first_found:
+    - group_vars/user_options.yml
+    - /dev/null
+  ignore_errors: true
+
 ...
 
 # vim: set expandtab tabstop=2 shiftwidth=2 smartindent noautoindent colorcolumn=2,80:

roles/mythtv/tasks/main.yml

@@ -12,13 +12,6 @@
     distro: '{{ ansible_distribution | regex_replace("[/ ]", "_") | lower }}'
     version: '{{ ansible_distribution_major_version | int }}'
 
-- name: Load a user_options.yml file if it exists
-  include_vars:
-    file: '{{ item }}'
-  with_first_found:
-    - group_vars/user_options.yml
-    - /dev/null
-
 - name: See if special setup tasks exist
   stat:
     path:  '{{ playbook_dir }}/roles/mythtv/tasks/{{ ansible_pkg_mgr }}_{{ distro }}.yml'

roles/mythtv/vars/freebsd/README

@@ -0,0 +1,101 @@
+From a 2006 post here: https://www.freshports.org/multimedia/mythtv
+Although it says it was updated in 2024.
+
+# Build dependencies:
+yasm
+input.h
+py311-setuptools>0
+py311-mysqlclient>=0
+py311-future>=0
+py311-lxml>=0
+py311-requests>=0
+py311-simplejson>=0
+p5-DBI>=0
+p5-DBD-mysql>=0
+p5-Net-UPnP>=0
+p5-IO-Socket-INET6>=2.51
+p5-XML-Simple>=0
+p5-HTTP-Request-Params>=0
+p5-LWP-UserAgent-Determined>=0
+gmake>=4.4.1
+pkgconf>=1.3.0_1
+python3.11
+xorgproto>=0
+x11.pc
+xv.pc
+xrandr.pc
+xxf86vm.pc
+xinerama.pc
+xext.pc
+xcb.pc
+perl5>=5.36<5.37
+qt5-buildtools>=5.15
+linguist
+qt5-qmake>=5.15
+# Test dependencies:
+python3.11
+# Runtime dependencies:
+tv_check
+wget
+py311-mysqlclient>=1.2.2
+py311-sqlite3>0
+py311-lxml>=0
+py311-requests>0
+py311-requests-cache>0
+py311-simplejson>=3
+p5-DBI>=0
+p5-DBD-mysql>=0
+p5-Net-UPnP>=0
+p5-IO-Socket-INET6>=2.51
+p5-XML-Simple>=0
+p5-HTTP-Request-Params>=0
+p5-LWP-UserAgent-Determined>=0
+python3.11
+x11.pc
+xv.pc
+xrandr.pc
+xxf86vm.pc
+xinerama.pc
+xext.pc
+xcb.pc
+perl5>=5.36<5.37
+libqtiff.so
+libqsqlmysql.so
+# Library dependencies:
+liblzo2.so
+libmp3lame.so
+libsamplerate.so
+libtag.so
+libexiv2.so
+libva.so
+libbluray.so
+libass.so
+libfftw3_threads.so
+libfftw3f.so
+libfreetype.so
+libdav1d.so
+libaom.so
+libdrm.so
+libpulse.so
+libjack.so
+libSoundTouch.so
+libasound.so
+libsndio.so
+libgnutls.so
+libzip.so
+libexpat.so
+libhdhomerun.so
+libvdpau.so
+libGL.so
+libxml2.so
+libmysqlclient.so.21
+libQt5Core.so
+libQt5DBus.so
+libQt5Gui.so
+libQt5Multimedia.so
+libQt5Network.so
+libQt5OpenGL.so
+libQt5Script.so
+libQt5Sql.so
+libQt5Widgets.so
+libQt5Xml.so