talklib 3.7.8__tar.gz → 3.7.10__tar.gz

{talklib-3.7.8/src/talklib.egg-info → talklib-3.7.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: talklib
-Version: 3.7.8
+Version: 3.7.10
 Summary: A package to automate processing of shows/segments airing on the TL
 Author-email: Ben Weddle <ben.weddle@gmail.com>
 Maintainer-email: Ben Weddle <ben.weddle@gmail.com>
@@ -54,7 +54,7 @@ Requires-Dist: pycparser==2.22
 Requires-Dist: pydantic==2.9.1
 Requires-Dist: pydantic_core==2.23.3
 Requires-Dist: Pygments==2.20.0
-Requires-Dist: PyJWT==2.13.0
+Requires-Dist: PyJWT==2.15.1
 Requires-Dist: PyNaCl==1.6.2
 Requires-Dist: pyparsing==3.0.9
 Requires-Dist: pyproject_hooks==1.0.0
@@ -73,7 +73,7 @@ Requires-Dist: tomli==2.0.1
 Requires-Dist: twilio==9.0.2
 Requires-Dist: twine==4.0.2
 Requires-Dist: typing_extensions==4.15.0
-Requires-Dist: urllib3==2.7.0
+Requires-Dist: urllib3==2.8.0
 Requires-Dist: wrapt==1.16.0
 Requires-Dist: yarl==1.22.0
 Requires-Dist: zipp==3.23.0
@@ -108,7 +108,7 @@ This package automates two categories of things:
 ## Requirements<a id="requirements"></a>
 
 ### -[Python](https://www.python.org/downloads/)
-Use Python 3.10 or higher.
+Use Python 3.12 or higher.
 
 Make sure to select "add to PATH" during installation.
 
@@ -249,7 +249,7 @@ required for all RSS or permalink shows
 
 *required* for "local" shows
 - tells the module whether this is a local show
-- must be set to `True` if it is a local show
+- set to `True` if it is a local show (this needs to be deprecated!)
 - default is `False`
 
 `local_file`
@@ -274,7 +274,7 @@ required for "permalink" shows
 
 optional
 - whether or not you want to remove yesterday's files (if any exists)
-- if set to `True`, it will delete any file matching the show_filename attribute you set.
+- if set to `True`, it will delete any file matching the show_filename attribute you set. That is ANY file matching `<show_filename>*.wav`
 - default is `False`. 
 
 `include_date`
@@ -283,7 +283,7 @@ optional
 
 optional
 - whether or not you want to include today's date in the filename
-- if set to `True`, the date will be appended as such: `WP-MMDDYY.wav`
+- if set to `True`, the date will be appended as such: `WPMMDDYY.wav`
 - if not set, or set to `False`, the resulting filename will be: `WP.wav`
 - Generally, for TL programs, if it is a daily show, like the New York Times, etc., you need the date in the filename, as this is what WireReady will match.
 - the default is `False`
@@ -349,6 +349,8 @@ optional
 
 The minimum attributes you must set are `show`, `show_filename`, and `url`.
 
+For RSS shows, the first `<item>` in the feed must have a `<pubDate>` containing today's date in `ddd, DD Mon YYYY` format (for example, `Wed, 07 Oct 2026`), using the date on the computer running the script. `TLShow` checks only the first item and retries the check up to three times. If that item is not dated today, processing stops without downloading audio or removing existing destination files, and an error notification is sent if notifications are enabled. The script does not search later items or fall back to an older episode.
+
 Here is an example script:
 
 ````python
@@ -378,7 +380,7 @@ MWB = TLShow(
     show = 'Magical World of Bees',
     show_filename = 'MWB',
     is_local = True,
-    local_file = 'D:Production\path\to\the\file.wav'
+    local_file = r'D:Production\path\to\the\file.wav'
     )
 
 MWB.run()
@@ -469,6 +471,19 @@ SD.run()
 
 ### Prerequisites
 
+Podcast publishing and the podcast-related CLI commands connect to the Assets server over SSH/SFTP using the host alias `assets`. You must configure SSH prior to running any scripts.
+
+Keep the SSH private key in the home directory under `~/.ssh`. In that same directory, create a file named `config` with a host entry like this, replacing the placeholders with your server hostname, username, and key filename:
+
+````text
+Host assets
+    HostName YOUR_ASSETS_SERVER_HOSTNAME
+    User YOUR_SSH_USERNAME
+    IdentityFile ~/.ssh/YOUR_PRIVATE_KEY_FILENAME
+````
+
+The `Host assets` alias must match the host used by `talklib`. Run `ssh assets` from on the PC to verify the connection before scheduling automation. For unattended runs, key authentication must work without an interactive password or passphrase prompt.
+
 Before starting to podcast a new show, you must log in to the server, create a directory, and upload some files. The `talklib` CLI has several functions to help you with this. Run `talklib --help` in your terminal to see a list of these helper functions.
 
 The directory should be named the same as the base name of the audio files for that show. For example, The Nashville Scene audio files are labelled as SceneMMDDYY. The directory name on the server should be `scene` in all lower-case.
@@ -602,3 +617,10 @@ nyt.run()
     - You must be connected to the internet to run the tests.
     - To update the version on PyPI, you must increment the version number in `pyproject.toml`
 
+If you add or upgrade third-party packages, don't forget to update `requirements.txt` from your activated virtual environment:
+
+````bash
+pip freeze --exclude talklib > requirements.txt
+````
+
+The `--exclude talklib` option keeps this project's editable installation out of its own dependency list.

{talklib-3.7.8 → talklib-3.7.10}/README.md

@@ -27,7 +27,7 @@ This package automates two categories of things:
 ## Requirements<a id="requirements"></a>
 
 ### -[Python](https://www.python.org/downloads/)
-Use Python 3.10 or higher.
+Use Python 3.12 or higher.
 
 Make sure to select "add to PATH" during installation.
 
@@ -168,7 +168,7 @@ required for all RSS or permalink shows
 
 *required* for "local" shows
 - tells the module whether this is a local show
-- must be set to `True` if it is a local show
+- set to `True` if it is a local show (this needs to be deprecated!)
 - default is `False`
 
 `local_file`
@@ -193,7 +193,7 @@ required for "permalink" shows
 
 optional
 - whether or not you want to remove yesterday's files (if any exists)
-- if set to `True`, it will delete any file matching the show_filename attribute you set.
+- if set to `True`, it will delete any file matching the show_filename attribute you set. That is ANY file matching `<show_filename>*.wav`
 - default is `False`. 
 
 `include_date`
@@ -202,7 +202,7 @@ optional
 
 optional
 - whether or not you want to include today's date in the filename
-- if set to `True`, the date will be appended as such: `WP-MMDDYY.wav`
+- if set to `True`, the date will be appended as such: `WPMMDDYY.wav`
 - if not set, or set to `False`, the resulting filename will be: `WP.wav`
 - Generally, for TL programs, if it is a daily show, like the New York Times, etc., you need the date in the filename, as this is what WireReady will match.
 - the default is `False`
@@ -268,6 +268,8 @@ optional
 
 The minimum attributes you must set are `show`, `show_filename`, and `url`.
 
+For RSS shows, the first `<item>` in the feed must have a `<pubDate>` containing today's date in `ddd, DD Mon YYYY` format (for example, `Wed, 07 Oct 2026`), using the date on the computer running the script. `TLShow` checks only the first item and retries the check up to three times. If that item is not dated today, processing stops without downloading audio or removing existing destination files, and an error notification is sent if notifications are enabled. The script does not search later items or fall back to an older episode.
+
 Here is an example script:
 
 ````python
@@ -297,7 +299,7 @@ MWB = TLShow(
     show = 'Magical World of Bees',
     show_filename = 'MWB',
     is_local = True,
-    local_file = 'D:Production\path\to\the\file.wav'
+    local_file = r'D:Production\path\to\the\file.wav'
     )
 
 MWB.run()
@@ -388,6 +390,19 @@ SD.run()
 
 ### Prerequisites
 
+Podcast publishing and the podcast-related CLI commands connect to the Assets server over SSH/SFTP using the host alias `assets`. You must configure SSH prior to running any scripts.
+
+Keep the SSH private key in the home directory under `~/.ssh`. In that same directory, create a file named `config` with a host entry like this, replacing the placeholders with your server hostname, username, and key filename:
+
+````text
+Host assets
+    HostName YOUR_ASSETS_SERVER_HOSTNAME
+    User YOUR_SSH_USERNAME
+    IdentityFile ~/.ssh/YOUR_PRIVATE_KEY_FILENAME
+````
+
+The `Host assets` alias must match the host used by `talklib`. Run `ssh assets` from on the PC to verify the connection before scheduling automation. For unattended runs, key authentication must work without an interactive password or passphrase prompt.
+
 Before starting to podcast a new show, you must log in to the server, create a directory, and upload some files. The `talklib` CLI has several functions to help you with this. Run `talklib --help` in your terminal to see a list of these helper functions.
 
 The directory should be named the same as the base name of the audio files for that show. For example, The Nashville Scene audio files are labelled as SceneMMDDYY. The directory name on the server should be `scene` in all lower-case.
@@ -521,3 +536,10 @@ nyt.run()
     - You must be connected to the internet to run the tests.
     - To update the version on PyPI, you must increment the version number in `pyproject.toml`
 
+If you add or upgrade third-party packages, don't forget to update `requirements.txt` from your activated virtual environment:
+
+````bash
+pip freeze --exclude talklib > requirements.txt
+````
+
+The `--exclude talklib` option keeps this project's editable installation out of its own dependency list.

{talklib-3.7.8 → talklib-3.7.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "talklib"
-version = "3.7.8"
+version = "3.7.10"
 description = "A package to automate processing of shows/segments airing on the TL"
 readme = "README.md"
 license = "MIT-open-group"

{talklib-3.7.8 → talklib-3.7.10}/requirements.txt

@@ -42,7 +42,7 @@ pycparser==2.22
 pydantic==2.9.1
 pydantic_core==2.23.3
 Pygments==2.20.0
-PyJWT==2.13.0
+PyJWT==2.15.1
 PyNaCl==1.6.2
 pyparsing==3.0.9
 pyproject_hooks==1.0.0
@@ -61,7 +61,7 @@ tomli==2.0.1
 twilio==9.0.2
 twine==4.0.2
 typing_extensions==4.15.0
-urllib3==2.7.0
+urllib3==2.8.0
 wrapt==1.16.0
 yarl==1.22.0
 zipp==3.23.0

{talklib-3.7.8 → talklib-3.7.10}/src/talklib/pod.py

@@ -341,18 +341,16 @@ class Episode(BaseModel):
 
 class TLPod(BaseModel):
     '''
-    everything should be in lower case!
+    Everything should be in lower case!
 
-    display_name: generic name for the show/program. WIll be displayed as the
-    episode "Title" in the podcast feed. type=string
+    display_name: Generic name for the show/program. Will be displayed as the episode "Title" in the podcast feed.
 
-    filename_to_match: the base name of the show we want to match. do not include the date.
-    for example, to match RollingStone091322, use 'RollingStone'. type=string
+    filename_to_match: The base name of the show we want to match. Do not include the date.
+    For example, to match RollingStone091322, use 'RollingStone'.
 
-    bucket_folder: the name of the folder on S3 where the audio and RSS files are stored.
-    should be lower case. type=string
+    bucket_folder: The name of the folder on the Assets server where the audio and RSS files are stored.
 
-    max_episodes_in_feed: the max number of episodes that should be in the feed after you add the episode.
+    max_episodes_in_feed: The max number of episodes that should be in the feed after you add the episode.
     '''
     display_name: str = Field(min_length=1)
     filename_to_match: str = Field(min_length=1)
@@ -370,7 +368,7 @@ class TLPod(BaseModel):
     @model_validator(mode='after')
     def post_update(self):
         '''
-        the name of the bucket folder should match the base name of the file. If bucket_folder is not explicitly set
+        The name of the bucket folder should match the base name of the file. If bucket_folder is not explicitly set
         by the user, use the filename. However, if filename_override is being used, strip out the digits first.
         '''
         if not self.bucket_folder:
@@ -391,7 +389,7 @@ class TLPod(BaseModel):
     
     @model_validator(mode='after')
     def check_apache_assets_server(self):
-        '''check that the Assets server is reachable via HTTP and notify staff if not. Do not hault automation'''
+        '''Check that the Assets server is reachable via HTTP and notify staff if not. Do not hault automation'''
         url: str = "https://assets.library.nashville.gov"
         req_get = requests.get(url=url)
         req_post = requests.post(url=url)

{talklib-3.7.8 → talklib-3.7.10/src/talklib.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: talklib
-Version: 3.7.8
+Version: 3.7.10
 Summary: A package to automate processing of shows/segments airing on the TL
 Author-email: Ben Weddle <ben.weddle@gmail.com>
 Maintainer-email: Ben Weddle <ben.weddle@gmail.com>
@@ -54,7 +54,7 @@ Requires-Dist: pycparser==2.22
 Requires-Dist: pydantic==2.9.1
 Requires-Dist: pydantic_core==2.23.3
 Requires-Dist: Pygments==2.20.0
-Requires-Dist: PyJWT==2.13.0
+Requires-Dist: PyJWT==2.15.1
 Requires-Dist: PyNaCl==1.6.2
 Requires-Dist: pyparsing==3.0.9
 Requires-Dist: pyproject_hooks==1.0.0
@@ -73,7 +73,7 @@ Requires-Dist: tomli==2.0.1
 Requires-Dist: twilio==9.0.2
 Requires-Dist: twine==4.0.2
 Requires-Dist: typing_extensions==4.15.0
-Requires-Dist: urllib3==2.7.0
+Requires-Dist: urllib3==2.8.0
 Requires-Dist: wrapt==1.16.0
 Requires-Dist: yarl==1.22.0
 Requires-Dist: zipp==3.23.0
@@ -108,7 +108,7 @@ This package automates two categories of things:
 ## Requirements<a id="requirements"></a>
 
 ### -[Python](https://www.python.org/downloads/)
-Use Python 3.10 or higher.
+Use Python 3.12 or higher.
 
 Make sure to select "add to PATH" during installation.
 
@@ -249,7 +249,7 @@ required for all RSS or permalink shows
 
 *required* for "local" shows
 - tells the module whether this is a local show
-- must be set to `True` if it is a local show
+- set to `True` if it is a local show (this needs to be deprecated!)
 - default is `False`
 
 `local_file`
@@ -274,7 +274,7 @@ required for "permalink" shows
 
 optional
 - whether or not you want to remove yesterday's files (if any exists)
-- if set to `True`, it will delete any file matching the show_filename attribute you set.
+- if set to `True`, it will delete any file matching the show_filename attribute you set. That is ANY file matching `<show_filename>*.wav`
 - default is `False`. 
 
 `include_date`
@@ -283,7 +283,7 @@ optional
 
 optional
 - whether or not you want to include today's date in the filename
-- if set to `True`, the date will be appended as such: `WP-MMDDYY.wav`
+- if set to `True`, the date will be appended as such: `WPMMDDYY.wav`
 - if not set, or set to `False`, the resulting filename will be: `WP.wav`
 - Generally, for TL programs, if it is a daily show, like the New York Times, etc., you need the date in the filename, as this is what WireReady will match.
 - the default is `False`
@@ -349,6 +349,8 @@ optional
 
 The minimum attributes you must set are `show`, `show_filename`, and `url`.
 
+For RSS shows, the first `<item>` in the feed must have a `<pubDate>` containing today's date in `ddd, DD Mon YYYY` format (for example, `Wed, 07 Oct 2026`), using the date on the computer running the script. `TLShow` checks only the first item and retries the check up to three times. If that item is not dated today, processing stops without downloading audio or removing existing destination files, and an error notification is sent if notifications are enabled. The script does not search later items or fall back to an older episode.
+
 Here is an example script:
 
 ````python
@@ -378,7 +380,7 @@ MWB = TLShow(
     show = 'Magical World of Bees',
     show_filename = 'MWB',
     is_local = True,
-    local_file = 'D:Production\path\to\the\file.wav'
+    local_file = r'D:Production\path\to\the\file.wav'
     )
 
 MWB.run()
@@ -469,6 +471,19 @@ SD.run()
 
 ### Prerequisites
 
+Podcast publishing and the podcast-related CLI commands connect to the Assets server over SSH/SFTP using the host alias `assets`. You must configure SSH prior to running any scripts.
+
+Keep the SSH private key in the home directory under `~/.ssh`. In that same directory, create a file named `config` with a host entry like this, replacing the placeholders with your server hostname, username, and key filename:
+
+````text
+Host assets
+    HostName YOUR_ASSETS_SERVER_HOSTNAME
+    User YOUR_SSH_USERNAME
+    IdentityFile ~/.ssh/YOUR_PRIVATE_KEY_FILENAME
+````
+
+The `Host assets` alias must match the host used by `talklib`. Run `ssh assets` from on the PC to verify the connection before scheduling automation. For unattended runs, key authentication must work without an interactive password or passphrase prompt.
+
 Before starting to podcast a new show, you must log in to the server, create a directory, and upload some files. The `talklib` CLI has several functions to help you with this. Run `talklib --help` in your terminal to see a list of these helper functions.
 
 The directory should be named the same as the base name of the audio files for that show. For example, The Nashville Scene audio files are labelled as SceneMMDDYY. The directory name on the server should be `scene` in all lower-case.
@@ -602,3 +617,10 @@ nyt.run()
     - You must be connected to the internet to run the tests.
     - To update the version on PyPI, you must increment the version number in `pyproject.toml`
 
+If you add or upgrade third-party packages, don't forget to update `requirements.txt` from your activated virtual environment:
+
+````bash
+pip freeze --exclude talklib > requirements.txt
+````
+
+The `--exclude talklib` option keeps this project's editable installation out of its own dependency list.

{talklib-3.7.8 → talklib-3.7.10}/src/talklib.egg-info/requires.txt

@@ -42,7 +42,7 @@ pycparser==2.22
 pydantic==2.9.1
 pydantic_core==2.23.3
 Pygments==2.20.0
-PyJWT==2.13.0
+PyJWT==2.15.1
 PyNaCl==1.6.2
 pyparsing==3.0.9
 pyproject_hooks==1.0.0
@@ -61,7 +61,7 @@ tomli==2.0.1
 twilio==9.0.2
 twine==4.0.2
 typing_extensions==4.15.0
-urllib3==2.7.0
+urllib3==2.8.0
 wrapt==1.16.0
 yarl==1.22.0
 zipp==3.23.0