Yt-videos-list

- **BUGFIX**
- fix `pip` installation problem due to incorrectly formatted
version specifiers
- update video duration extraction to correctly
extract the duration of each video and avoid
writing 'N/A'

- **FEATURE IMPROVEMENTS**
- improve identification of seen videos in csv files by
- avoiding potentially brittle regular expression matching
- parsing each row of the csv file and extracting the
(Video ID|Video URL) value from the corresponding column directly
- normalize whitespace to avoid including newlines,
carriage returns, and multiple consecutive whitespace characters
in the video title
- improve logging messages by including `time.time()` and
`time.perf_counter()` when logging the time taken to perform
an operation

- **PERFORMANCE IMPROVEMENTS**
- increase write efficiency by completely avoiding writing to a
temporary file when no new videos found for an existing file

- **INTERNAL IMPROVEMENT**
- the following change does not affect the functionality of the program
- add unit tests for the video title whitespace normalization

- **BUGFIX**
- around mid-late October, YouTube rolled out a new UI that changed
rendering of different parts of the website, including the videos
page
- this broke the previous scraping logic, and this release fixes
the endpoints to correctly extract video information
- for more information, see the following references:
- https://techcrunch.com/2022/10/24/youtube-rolls-out-new-design-with-pinch-to-zoom-on-ios-and-android-and-other-updates/
- https://blog.youtube/news-and-events/an-updated-look-and-feel-for-youtube/
- https://www.youtube.com/watch?v=zC8hYQwiEy4
- https://www.youtube.com/watch?v=lYVtgYjJvuo

- **BINARY UPDATES**
- Mozilla Firefox
- geckodriver v0.32.0 (Firefox versions ≥ 104)
- geckodriver v0.31.0 (Firefox versions ≥ 99)
- Opera Stable 82, 83, 84, 85, 88, 89, 90, 91, 92 & 93
- operadriver v.107.0.5304.88 (Opera Stable 93)
- operadriver v.106.0.5249.119 (Opera Stable 92)
- operadriver v.105.0.5195.102 (Opera Stable 91)
- operadriver v.104.0.5112.81 (Opera Stable 90)
- operadriver v.103.0.5060.66 (Opera Stable 89)
- operadriver v.102.0.5005.61 (Opera Stable 88)
- there was no operadriver release specifically for version 101 (Opera Stable 87)
- there was no operadriver release specifically for version 100 (Opera Stable 86)
- operadriver v.99.0.4844.51 (Opera Stable 85)
- operadriver v.98.0.4758.82 (Opera Stable 84)
- operadriver v.97.0.4692.71 (Opera Stable 83)
- operadriver v.96.0.4664.45 (Opera Stable 82)
- Google Chrome version 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, & 108 (updated version 97 binaries)
- chromedriver 108.0.5359.22
- chromedriver 107.0.5304.62
- chromedriver 106.0.5249.61
- chromedriver 105.0.5195.52
- chromedriver 104.0.5112.79
- chromedriver 103.0.5060.134
- chromedriver 102.0.5005.61
- chromedriver 101.0.4951.41
- chromedriver 100.0.4896.60
- chromedriver 99.0.4844.51
- chromedriver 98.0.4758.102
- chromedriver 97.0.4692.71 (previously 97.0.4692.20)
- Brave Browser version 96, 97, 98, 99, 102, 103, 104, 105, 106, & 107
- bravedriver v.107.0.5304.88 (uses operadriver binaries)
- bravedriver v.106.0.5249.119 (uses operadriver binaries)
- bravedriver v.105.0.5195.102 (uses operadriver binaries)
- bravedriver v.104.0.5112.81 (uses operadriver binaries)
- bravedriver v.103.0.5060.66 (uses operadriver binaries)
- bravedriver v.102.0.5005.61 (uses operadriver binaries)
- there was no operadriver release specifically for version 101
- there was no operadriver release specifically for version 100
- bravedriver v.99.0.4844.51 (uses operadriver binaries)
- bravedriver v.98.0.4758.82 (uses operadriver binaries)
- bravedriver v.97.0.4692.71 (uses operadriver binaries)
- bravedriver v.96.0.4664.45 (uses operadriver binaries)
- Microsoft Edge version 100, 101, 102, 103, 104, 105, 106, 107, 108, & 109 (updated version 96, 97, & 98 binaries)
- msedgedriver 109.0.1481.0
- msedgedriver 108.0.1462.15
- msedgedriver 107.0.1418.42
- msedgedriver 106.0.1370.52
- msedgedriver 105.0.1343.53
- msedgedriver 104.0.1293.91
- msedgedriver 103.0.1264.77
- msedgedriver 102.0.1245.62
- msedgedriver 101.0.1210.53
- msedgedriver 100.0.1185.60
- there was no msedgedriver release specifically for version 99
- msedgedriver 98.0.1085.0 (previously 98.0.1086.0)
- msedgedriver 97.0.1072.76 (previously 97.0.1072.8)
- msedgedriver 96.0.1054.75 (previously 96.0.1054.26)
- **MINOR BUGFIXES**
- Update URL for Quanta Magazine channel (commit 06fa9d8fd0ae52022912aa93cb313363e248ff6e)
- Update time duration for video 130 in test reference files (commit b8641f75288192152e22f010fbf79281c523c4fb)
- Use `call` command to properly run helper batch script (commit d519edfc83f2a06eb5ca507a7cd2f485ffc68b63)
- Make browser version detection more robust
- commit 4fbaa6f8794b3be89a45258fa6593ca10cc06d4f
- commit 9b8ba0177271ac5243fc57898b6498fecc44abba
- commit 90c532208ffbea1df33d8523de4d368ac205fbb0
- commit c297e21dbb234ab13756e7fc4bc503448da21195
- commit 02584be29e185b213a9f26ad7fdb0545a1f1ec65
- **INTERNAL IMPROVEMENTS**
- Update save_thread_result package dependency version number → 0.0.9 (commit b5a9f14b51fd5219fdcc2eebfa38ce32fd20a640)
- Support browser versions up to 120 (commit a155c05d3d6189efe0551590c155badb68b24994)

- **BUGFIXES**
<details>
<summary><strong>update XPath for blocking cookies button</strong></summary>

- commit 62464aa9cf803c8f8b45bbffcb748f691595bf1c
</details>

<details>
<summary><strong>make <code>url</code> a required positional argument</strong></summary>

- commit 93029fababed9506677505e9485197c9f4ce9498
</details>

- **FEATURE IMPROVEMENTS**
<details>
<summary><strong><code>raise</code> error instead of <code>print</code>ing message and then <code>sys.exit()</code>ing</strong></summary>

- see commits with a commit message starting with "Raise"
- also, see commit d43ef6a7b0721e2b8c1660fd2a2255ac9c8dbd71
</details>

<details>
<summary><strong>use explicit exception chaining</strong></summary>

- see the following commits for more details:
- commit e6057bba68bee85db57c66209a49fdc4e6d7c6fa
- commit 784ef61b41269acde38b8041d937ab1386c244b7
- commit 57c6a99bf7ce4e7a1881b20a07cbd59005f5b838
</details>
<details>
<summary><strong>show warning for users on unsupported operating systems</strong></summary>

- see the following commits for more details:
- commit 67f519602e6d05913d5554138ad5a14ce639540b
- commit cdcb5f48acb87e5fd7b1271d7e62f666013e1821
- commit 01314c63f043af617bbbf07d6ac073b4a88fd0c3
- commit c146baf39efa3866723a25573e02e29dd3e2296a
- commit a5fddafca47e791a76b8e75147cff2e54c5e2385
- commit 77ffc95237fb37676c2b4a2b2042c8df4f9107c9
- commit 136dba035c43b3bb0427c04c4894406c2899ee8f
- commit 912e54a6d1ba9a1e7594078d63d42d530daf91d0
- commit c94a5a6594a03bbbdbb58d20a4a6bc7e9ee1aa23
</details>

<details>
<summary><strong>include real time taken by program</strong></summary>

- see commits with a commit message
- starting with "Include real time"
- including `log_time_taken`
</details>

- **PERFORMANCE IMPROVEMENTS**
<details>
<summary><strong>optimize multithreading for <code>create_list_from</code> function</strong></summary>

- see commit 67d94a0886fbcd1a200694926dd40ca3a466cb14 for more details
- NOTE: `create_thread_from` mentioned in this commit message was a typo and should be `create_list_from`
- see the following commits for related changes:
- commit 22a77d1bae6f3d9cc97ba463506b08fc9bdc7a3b
- commit 41d6a962d7f7342fd885f93645d5f25eec0441cf
- commit 67d94a0886fbcd1a200694926dd40ca3a466cb14
- commit b3a902d2ff8b6bdd823449e9b8f8a3ee794dfefb
- commit 4a07eff4b33c6d661442b5025f3ccff54d9807d7
- commit 53cfd1a1b73578497e0d680194d5280117262d34
- commit e46ebf84309d390d9b708b04559646a0d11dcc35
- commit 5062cef05086e7d6cde3147364c4153e3e0ec073
- commit b56720a2cfd9a28bc8ab77e8397e31861391607a
- commit ff0806bfbe6f178854b1456160a0a9833b019b1e
- commit 6aa54715ab85a1d79e5bdad95fd46b73568cfd31
- commit d6c6e1a5c17b59f782eece2190c0a5e072001d51
- commit cb4485be5c13aa18d2b475fda68a78ccf255ae47
- commit 9f6049e4dbb7b49ead7da44e8f97986e94e437f5
- commit 99380adb738c41fcf8767a4f43433e64a49f7666
- commit c7f4ab86912f56672c025cf952141da491608d37
- commit e182962a46aa94ae2018197b36343a86e1f8146a
- commit ee1094a25e5741cb0ec29c78dba2b9a5984ce738
- commit 5c5ef4ed6f79370ac180960371de6dfce1cd66d3
</details>

- **INTERNAL IMPROVEMENTS**
<details>
<summary><strong>these changes do not affect the functionality of the program</strong></summary>

- interesting changes
- commit 96398e7f22fad73c9117acf3f22885eba2c73e35
- commit 1211f1a4216e35fe2b3860ffc94469f8acd9f15b
- commit 34cc678578acbc1bdfe090ad5bff936d913c0dd7
- commit 7f4d28a0fae0a10cb6ea6334a5161312f54172c0
- commit b84795ca237728f35dfd297623ddb3d9ff7bf5d8
- commit 3bdd29a4b40e39e040f73bb28dba913f9e0b6fa3
- displayed debugging information changes
- commit cea29fee822e0cbbf4aa77a38b1d788dc3e59b5b
- commit f838764d1a862c4d29ab57451f8d0b3bfb7bb075
- commit 3da2ce66c9a200bd3c2064cf19d15c463c5fa6bf
- testing/building changes
- commit 155c06e1633276e6039316a528a3f514e4ed6d04
- commit b5177051d6287bdca8e30bc88ef5c93dc21040e2
- bug from commit 773fcb613d2f93946419143a051413a15dc6224c
- commit 1f80d6b009965bc517bb8cab7d77f9558c8376bc
- commit 3cf637f37555ab65e902734b17f5a5febc1f5ec2
- commit 23cec086011c150c6c119fa3a1385a48c3e4ee3b
- commit 512e7a7d024c02f5fc21160fbaab745f26990d5b
- commit 90eecb3be4dd1658efe249bd10240cd99f0737ad
- commit 1c14e1dc2bf68d0a2d546cb56058c4f4287bd8eb
- commit 9d32a8fb2b810da97aded35dcb7492c2488f627c
- commit 8e54376d43ef3b2e7b13f8b0eb22b676c609f3f9
- commit 722eeb76e2bd406dac33b15a0026940babed8ccf
- commit 02f92d87c979b99bb9fcbbaa11be8e03fb65c56e
- commit e9c6fb3bf369cae6317fe61adc8daddd65e39a5b
- refactoring changes
- rename variables to be more descriptive
- rename functions to be more descriptive
- reorganize code for readability
- remove unneccesary intermediate variables
- add intermediate variables for clarity
- documentation changes
- improve error messages
- improve README
- improve docstrings
</details>

- **BINARY UPDATES**
- Mozilla Firefox
- geckodriver v0.30.0 (Firefox versions ≥ 92)
- Opera Stable 77, 78, 79, 80, & 81
- operadriver v.95.0.4638.54 (Opera Stable 81)
- operadriver v.94.0.4606.61 (Opera Stable 80)
- operadriver v.93.0.4577.63 (Opera Stable 79)
- operadriver v.92.0.4515.107 (Opera Stable 78)
- operadriver v.91.0.4472.77 (Opera Stable 77)
- Google Chrome version 92, 93, 94, 95, 6, & 97 (updated version 91 binaries)
- chromedriver 97.0.4692.20
- chromedriver 96.0.4664.45
- chromedriver 95.0.4638.69
- chromedriver 94.0.4606.113
- chromedriver 93.0.4577.63
- chromedriver 92.0.4515.107
- chromedriver 91.0.4472.101 (previously 91.0.4472.19)
- Brave Browser version 91, 92, 93, 94, & 95
- operadriver v.95.0.4638.54 (uses operadriver binaries)
- operadriver v.94.0.4606.61 (uses operadriver binaries)
- operadriver v.93.0.4577.63 (uses operadriver binaries)
- operadriver v.92.0.4515.107 (uses operadriver binaries)
- operadriver v.91.0.4472.77 (uses operadriver binaries)
- Microsoft Edge version 93, 94, 95, 96, 97, & 98 (updated version 90, 91, & 92 binaries)
- msedgedriver 98.0.1086.0
- msedgedriver 97.0.1072.8
- msedgedriver 96.0.1054.26
- msedgedriver 95.0.1020.53
- msedgedriver 94.0.992.58
- msedgedriver 93.0.961.52
- msedgedriver 92.0.902.84 (previously 92.0.881.0)
- msedgedriver 91.0.864.71 (previously 91.0.864.19)
- msedgedriver 90.0.818.66 (previously 90.0.818.56)
- **MINOR BUGFIXES**
- handle videos with no "Video Duration" field (commit 2f538e14e574f9435c13a544fb3018d347890f4a)
- this is an **extremely** rare edge case
- based on anecdotal data, occurs about 1 in every 70000 videos
- update URLs shown in exception messages (commit 3f0961283836713cbc65592c6171693dcc808705 & commit 99ed682abec835304664e40e18d220fa0d4204b9)
- correctly handle unfinished threads in `create_list_from()` method (commit aa4ff3de648f84891a96a5e7a33a8efb00fc0b19)
- generalize URL normalization for removing trailing parameters (commit 0789a3e66b9965f4d29259c23860488714d81a3a)
- this removes any trailing tracking parameters that might be associated with a video URL
- e.g. youtube.com/watch?v=abcdefghijk?pp=sAQB → youtube.com/watch?v=abcdefghijk
- verify page has videos (commit 82a48563a1a6bcdcac944d51516dcec079d0691e)
- prevents crashing on channels with 0 public videos
- **LOGGING IMPROVEMENTS**
- include total number of videos in each file after each run
- commit 83827694160542cba28e1e7f7b24e6c5526ece1d
- commit 3282089af25b2188206b0457475d55e21fcd0689
- commit 94f5acb7e2b5ac2d0d41311aa1e9847665ff401e
- commit c9f2671ae6d827c3b9d35013016610bda799590e
- **INTERNAL CHANGES**
- refactor code to:
- reduce code duplication
- make variable and function names more context specific
- place repeated code inside variables
- make browser naming more specific (commit 81144cb88f5ac8c99a9fe27198b6cebf9bafdde2)

- see the following commits for more details:
- commit e21a79ccc27c7cdc8741ade01162012e1cc718a8
- commit 3e6262d3166c41350f300cbfca423197d689c627
- commit 0c817f228041e91a56ff0345bc157752125f5edf
- commit 5453b14719eb241e08f01d0c1fe5af96f1e4b6ef