spotifywebapiPython 1.0.88__py3-none-any.whl → 1.0.90__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of spotifywebapiPython might be problematic. Click here for more details.

Files changed (20) hide show
  1. {spotifywebapiPython-1.0.88.dist-info → spotifywebapiPython-1.0.90.dist-info}/METADATA +1 -1
  2. {spotifywebapiPython-1.0.88.dist-info → spotifywebapiPython-1.0.90.dist-info}/RECORD +20 -20
  3. spotifywebapipython/const.py +1 -1
  4. spotifywebapipython/docs/__init__.html +19 -2
  5. spotifywebapipython/docs/index.html +2 -2
  6. spotifywebapipython/docs/search.js +1 -1
  7. spotifywebapipython/docs/spotifywebapiPython/const.html +3 -3
  8. spotifywebapipython/docs/spotifywebapiPython/saappmessages.html +2 -2
  9. spotifywebapipython/docs/spotifywebapiPython/sautils.html +2 -2
  10. spotifywebapipython/docs/spotifywebapiPython/spotifyapierror.html +2 -2
  11. spotifywebapipython/docs/spotifywebapiPython/spotifyapimessage.html +2 -2
  12. spotifywebapipython/docs/spotifywebapiPython/spotifyauthtoken.html +2 -2
  13. spotifywebapipython/docs/spotifywebapiPython/spotifyclient.html +77 -22
  14. spotifywebapipython/docs/spotifywebapiPython/spotifydiscovery.html +2 -2
  15. spotifywebapipython/docs/spotifywebapiPython/spotifywebapiauthenticationerror.html +2 -2
  16. spotifywebapipython/docs/spotifywebapiPython/spotifywebapierror.html +2 -2
  17. spotifywebapipython/spotifyclient.py +102 -25
  18. {spotifywebapiPython-1.0.88.dist-info → spotifywebapiPython-1.0.90.dist-info}/LICENSE +0 -0
  19. {spotifywebapiPython-1.0.88.dist-info → spotifywebapiPython-1.0.90.dist-info}/WHEEL +0 -0
  20. {spotifywebapiPython-1.0.88.dist-info → spotifywebapiPython-1.0.90.dist-info}/top_level.txt +0 -0
spotifywebapipython/docs/spotifywebapiPython/spotifydiscovery.html CHANGED
@@ -9,7 +9,7 @@
9
9
  </title>
10
10
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
11
11
  <!-- build env - Package Name = "spotifywebapiPython" -->
12
- <!-- build env - Package Version = "1.0.88" -->
12
+ <!-- build env - Package Version = "1.0.90" -->
13
13
  <!-- pdoc module.modulename = "spotifywebapipython.spotifydiscovery" -->
14
14
  <!-- pdoc module.is_package = "False" -->
15
15
  <!-- pdoc root_module_name = "None" -->
@@ -71,7 +71,7 @@
71
71
 
72
72
  <footer class="footertext">
73
73
  spotifywebapiPython</br>
74
- Version 1.0.88</br>
74
+ Version 1.0.90</br>
75
75
  <a href="https://developer.spotify.com/documentation/web-api" target="_blank">
76
76
  <img src="../spotifywebapipython.ico" alt="brand icon" style="width:32px; height:32px; padding:4px;"/>
77
77
  A Spotify Web Api Client
spotifywebapipython/docs/spotifywebapiPython/spotifywebapiauthenticationerror.html CHANGED
@@ -9,7 +9,7 @@
9
9
  </title>
10
10
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
11
11
  <!-- build env - Package Name = "spotifywebapiPython" -->
12
- <!-- build env - Package Version = "1.0.88" -->
12
+ <!-- build env - Package Version = "1.0.90" -->
13
13
  <!-- pdoc module.modulename = "spotifywebapipython.spotifywebapiauthenticationerror" -->
14
14
  <!-- pdoc module.is_package = "False" -->
15
15
  <!-- pdoc root_module_name = "None" -->
@@ -74,7 +74,7 @@
74
74
 
75
75
  <footer class="footertext">
76
76
  spotifywebapiPython</br>
77
- Version 1.0.88</br>
77
+ Version 1.0.90</br>
78
78
  <a href="https://developer.spotify.com/documentation/web-api" target="_blank">
79
79
  <img src="../spotifywebapipython.ico" alt="brand icon" style="width:32px; height:32px; padding:4px;"/>
80
80
  A Spotify Web Api Client
spotifywebapipython/docs/spotifywebapiPython/spotifywebapierror.html CHANGED
@@ -9,7 +9,7 @@
9
9
  </title>
10
10
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
11
11
  <!-- build env - Package Name = "spotifywebapiPython" -->
12
- <!-- build env - Package Version = "1.0.88" -->
12
+ <!-- build env - Package Version = "1.0.90" -->
13
13
  <!-- pdoc module.modulename = "spotifywebapipython.spotifywebapierror" -->
14
14
  <!-- pdoc module.is_package = "False" -->
15
15
  <!-- pdoc root_module_name = "None" -->
@@ -71,7 +71,7 @@
71
71
 
72
72
  <footer class="footertext">
73
73
  spotifywebapiPython</br>
74
- Version 1.0.88</br>
74
+ Version 1.0.90</br>
75
75
  <a href="https://developer.spotify.com/documentation/web-api" target="_blank">
76
76
  <img src="../spotifywebapipython.ico" alt="brand icon" style="width:32px; height:32px; padding:4px;"/>
77
77
  A Spotify Web Api Client
spotifywebapipython/spotifyclient.py CHANGED
@@ -1351,9 +1351,10 @@ class SpotifyClient:
1351
1351
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1352
1352
 
1353
1353
 
1354
- def CheckAlbumFavorites(self,
1355
- ids:str
1356
- ) -> dict:
1354
+ def CheckAlbumFavorites(
1355
+ self,
1356
+ ids:str=None,
1357
+ ) -> dict:
1357
1358
  """
1358
1359
  Check if one or more albums is already saved in the current Spotify user's
1359
1360
  'Your Library'.
@@ -1365,6 +1366,7 @@ class SpotifyClient:
1365
1366
  A comma-separated list of the Spotify IDs for the albums.
1366
1367
  Maximum: 20 IDs.
1367
1368
  Example: `6vc9OTcyd3hyzabCmsdnwE,2noRn2Aes5aoNVsU6iWThc`
1369
+ If null, the currently playing album uri id value is used.
1368
1370
 
1369
1371
  Returns:
1370
1372
  A dictionary of the ids, along with a boolean status for each that indicates
@@ -1395,6 +1397,14 @@ class SpotifyClient:
1395
1397
  apiMethodParms.AppendKeyValue("ids", ids)
1396
1398
  _logsi.LogMethodParmList(SILevel.Verbose, "Check if one or more albums are saved in a user's favorites", apiMethodParms)
1397
1399
 
1400
+ # if ids not specified, then return currently playing album id value.
1401
+ if (ids is None) or (len(ids.strip()) == 0):
1402
+ uri = self._GetPlayerNowPlayingAlbumUri()
1403
+ if uri is not None:
1404
+ ids = SpotifyClient.GetIdFromUri(uri)
1405
+ else:
1406
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1407
+
1398
1408
  # build spotify web api request parameters.
1399
1409
  urlParms:dict = \
1400
1410
  {
@@ -1422,6 +1432,7 @@ class SpotifyClient:
1422
1432
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1423
1433
  return result
1424
1434
 
1435
+ except SpotifyApiError: raise # pass handled exceptions on thru
1425
1436
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1426
1437
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1427
1438
  except Exception as ex:
@@ -1435,9 +1446,10 @@ class SpotifyClient:
1435
1446
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1436
1447
 
1437
1448
 
1438
- def CheckArtistsFollowing(self,
1439
- ids:str,
1440
- ) -> dict:
1449
+ def CheckArtistsFollowing(
1450
+ self,
1451
+ ids:str=None,
1452
+ ) -> dict:
1441
1453
  """
1442
1454
  Check to see if the current user is following one or more artists.
1443
1455
 
@@ -1448,6 +1460,7 @@ class SpotifyClient:
1448
1460
  A comma-separated list of Spotify artist ID's to check.
1449
1461
  Maximum: 50 ID's.
1450
1462
  Example: `2CIMQHirSU0MQqyYHq0eOx,1IQ2e1buppatiN1bxUVkrk`
1463
+ If null, the currently playing artist uri id value is used.
1451
1464
 
1452
1465
  Returns:
1453
1466
  A dictionary of the IDs, along with a boolean status for each that indicates
@@ -1482,6 +1495,14 @@ class SpotifyClient:
1482
1495
  if ids is not None:
1483
1496
  ids = ids.replace(' ','')
1484
1497
 
1498
+ # if ids not specified, then return currently playing artist id value.
1499
+ if (ids is None) or (len(ids.strip()) == 0):
1500
+ uri = self._GetPlayerNowPlayingArtistUri()
1501
+ if uri is not None:
1502
+ ids = SpotifyClient.GetIdFromUri(uri)
1503
+ else:
1504
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1505
+
1485
1506
  # build spotify web api request parameters.
1486
1507
  urlParms:dict = \
1487
1508
  {
@@ -1510,6 +1531,7 @@ class SpotifyClient:
1510
1531
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1511
1532
  return result
1512
1533
 
1534
+ except SpotifyApiError: raise # pass handled exceptions on thru
1513
1535
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1514
1536
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1515
1537
  except Exception as ex:
@@ -1523,9 +1545,10 @@ class SpotifyClient:
1523
1545
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1524
1546
 
1525
1547
 
1526
- def CheckAudiobookFavorites(self,
1527
- ids:str
1528
- ) -> dict:
1548
+ def CheckAudiobookFavorites(
1549
+ self,
1550
+ ids:str=None,
1551
+ ) -> dict:
1529
1552
  """
1530
1553
  Check if one or more audiobooks is already saved in the current Spotify user's
1531
1554
  'Your Library'.
@@ -1537,6 +1560,7 @@ class SpotifyClient:
1537
1560
  A comma-separated list of the Spotify IDs for the audiobooks.
1538
1561
  Maximum: 50 IDs.
1539
1562
  Example: `74aydHJKgYz3AIq3jjBSv1,4nfQ1hBJWjD0Jq9sK3YRW8,3PFyizE2tGCSRLusl2Qizf`
1563
+ If null, the currently playing audiobook uri id value is used.
1540
1564
 
1541
1565
  Returns:
1542
1566
  A dictionary of the ids, along with a boolean status for each that indicates
@@ -1567,6 +1591,14 @@ class SpotifyClient:
1567
1591
  apiMethodParms.AppendKeyValue("ids", ids)
1568
1592
  _logsi.LogMethodParmList(SILevel.Verbose, "Check if one or more audiobooks are saved in a user's favorites", apiMethodParms)
1569
1593
 
1594
+ # if ids not specified, then return currently playing id value.
1595
+ if (ids is None) or (len(ids.strip()) == 0):
1596
+ uri = self._GetPlayerNowPlayingAudiobookUri()
1597
+ if uri is not None:
1598
+ ids = SpotifyClient.GetIdFromUri(uri)
1599
+ else:
1600
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1601
+
1570
1602
  # build spotify web api request parameters.
1571
1603
  urlParms:dict = \
1572
1604
  {
@@ -1594,6 +1626,7 @@ class SpotifyClient:
1594
1626
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1595
1627
  return result
1596
1628
 
1629
+ except SpotifyApiError: raise # pass handled exceptions on thru
1597
1630
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1598
1631
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1599
1632
  except Exception as ex:
@@ -1607,9 +1640,10 @@ class SpotifyClient:
1607
1640
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1608
1641
 
1609
1642
 
1610
- def CheckEpisodeFavorites(self,
1611
- ids:str
1612
- ) -> dict:
1643
+ def CheckEpisodeFavorites(
1644
+ self,
1645
+ ids:str=None,
1646
+ ) -> dict:
1613
1647
  """
1614
1648
  Check if one or more episodes is already saved in the current Spotify user's
1615
1649
  'Your Library'.
@@ -1621,6 +1655,7 @@ class SpotifyClient:
1621
1655
  A comma-separated list of the Spotify IDs for the episodes.
1622
1656
  Maximum: 50 IDs.
1623
1657
  Example: `1kWUud3vY5ij5r62zxpTRy,2takcwOaAZWiXQijPHIx7B`
1658
+ If null, the currently playing episode uri id value is used.
1624
1659
 
1625
1660
  Returns:
1626
1661
  A dictionary of the ids, along with a boolean status for each that indicates
@@ -1651,6 +1686,14 @@ class SpotifyClient:
1651
1686
  apiMethodParms.AppendKeyValue("ids", ids)
1652
1687
  _logsi.LogMethodParmList(SILevel.Verbose, "Check if one or more episodes are saved in a user's favorites", apiMethodParms)
1653
1688
 
1689
+ # if ids not specified, then return currently playing id value.
1690
+ if (ids is None) or (len(ids.strip()) == 0):
1691
+ uri = self._GetPlayerNowPlayingUri('episode')
1692
+ if uri is not None:
1693
+ ids = SpotifyClient.GetIdFromUri(uri)
1694
+ else:
1695
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1696
+
1654
1697
  # build spotify web api request parameters.
1655
1698
  urlParms:dict = \
1656
1699
  {
@@ -1678,6 +1721,7 @@ class SpotifyClient:
1678
1721
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1679
1722
  return result
1680
1723
 
1724
+ except SpotifyApiError: raise # pass handled exceptions on thru
1681
1725
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1682
1726
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1683
1727
  except Exception as ex:
@@ -1764,6 +1808,7 @@ class SpotifyClient:
1764
1808
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1765
1809
  return result
1766
1810
 
1811
+ except SpotifyApiError: raise # pass handled exceptions on thru
1767
1812
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1768
1813
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1769
1814
  except Exception as ex:
@@ -1777,9 +1822,10 @@ class SpotifyClient:
1777
1822
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1778
1823
 
1779
1824
 
1780
- def CheckShowFavorites(self,
1781
- ids:str
1782
- ) -> dict:
1825
+ def CheckShowFavorites(
1826
+ self,
1827
+ ids:str=None,
1828
+ ) -> dict:
1783
1829
  """
1784
1830
  Check if one or more shows is already saved in the current Spotify user's
1785
1831
  'Your Library'.
@@ -1791,6 +1837,7 @@ class SpotifyClient:
1791
1837
  A comma-separated list of the Spotify IDs for the shows.
1792
1838
  Maximum: 50 IDs.
1793
1839
  Example: `1kWUud3vY5ij5r62zxpTRy,2takcwOaAZWiXQijPHIx7B`
1840
+ If null, the currently playing show uri id value is used.
1794
1841
 
1795
1842
  Returns:
1796
1843
  A dictionary of the ids, along with a boolean status for each that indicates
@@ -1821,6 +1868,14 @@ class SpotifyClient:
1821
1868
  apiMethodParms.AppendKeyValue("ids", ids)
1822
1869
  _logsi.LogMethodParmList(SILevel.Verbose, "Check if one or more shows are saved in a user's favorites", apiMethodParms)
1823
1870
 
1871
+ # if ids not specified, then return currently playing id value.
1872
+ if (ids is None) or (len(ids.strip()) == 0):
1873
+ uri = self._GetPlayerNowPlayingShowUri()
1874
+ if uri is not None:
1875
+ ids = SpotifyClient.GetIdFromUri(uri)
1876
+ else:
1877
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1878
+
1824
1879
  # build spotify web api request parameters.
1825
1880
  urlParms:dict = \
1826
1881
  {
@@ -1848,6 +1903,7 @@ class SpotifyClient:
1848
1903
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1849
1904
  return result
1850
1905
 
1906
+ except SpotifyApiError: raise # pass handled exceptions on thru
1851
1907
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1852
1908
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1853
1909
  except Exception as ex:
@@ -1861,9 +1917,10 @@ class SpotifyClient:
1861
1917
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
1862
1918
 
1863
1919
 
1864
- def CheckTrackFavorites(self,
1865
- ids:str
1866
- ) -> dict:
1920
+ def CheckTrackFavorites(
1921
+ self,
1922
+ ids:str=None,
1923
+ ) -> dict:
1867
1924
  """
1868
1925
  Check if one or more tracks is already saved in the current Spotify user's
1869
1926
  'Your Library'.
@@ -1875,6 +1932,7 @@ class SpotifyClient:
1875
1932
  A comma-separated list of the Spotify IDs for the tracks.
1876
1933
  Maximum: 50 IDs.
1877
1934
  Example: `1kWUud3vY5ij5r62zxpTRy,2takcwOaAZWiXQijPHIx7B`
1935
+ If null, the currently playing track uri id value is used.
1878
1936
 
1879
1937
  Returns:
1880
1938
  A dictionary of the ids, along with a boolean status for each that indicates
@@ -1905,6 +1963,14 @@ class SpotifyClient:
1905
1963
  apiMethodParms.AppendKeyValue("ids", ids)
1906
1964
  _logsi.LogMethodParmList(SILevel.Verbose, "Check if one or more tracks are saved in a user's favorites", apiMethodParms)
1907
1965
 
1966
+ # if ids not specified, then return currently playing id value.
1967
+ if (ids is None) or (len(ids.strip()) == 0):
1968
+ uri = self._GetPlayerNowPlayingUri()
1969
+ if uri is not None:
1970
+ ids = SpotifyClient.GetIdFromUri(uri)
1971
+ else:
1972
+ raise SpotifyApiError(SAAppMessages.ARGUMENT_REQUIRED_ERROR % (apiMethodName, 'ids'), logsi=_logsi)
1973
+
1908
1974
  # build spotify web api request parameters.
1909
1975
  urlParms:dict = \
1910
1976
  {
@@ -1932,6 +1998,7 @@ class SpotifyClient:
1932
1998
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
1933
1999
  return result
1934
2000
 
2001
+ except SpotifyApiError: raise # pass handled exceptions on thru
1935
2002
  except SpotifyWebApiError: raise # pass handled exceptions on thru
1936
2003
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
1937
2004
  except Exception as ex:
@@ -2020,6 +2087,7 @@ class SpotifyClient:
2020
2087
  _logsi.LogDictionary(SILevel.Verbose, TRACE_METHOD_RESULT % apiMethodName, result)
2021
2088
  return result
2022
2089
 
2090
+ except SpotifyApiError: raise # pass handled exceptions on thru
2023
2091
  except SpotifyWebApiError: raise # pass handled exceptions on thru
2024
2092
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
2025
2093
  except Exception as ex:
@@ -11752,6 +11820,7 @@ class SpotifyClient:
11752
11820
  # no results to process - this is pass or fail.
11753
11821
  return
11754
11822
 
11823
+ except SpotifyApiError: raise # pass handled exceptions on thru
11755
11824
  except SpotifyWebApiError: raise # pass handled exceptions on thru
11756
11825
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
11757
11826
  except Exception as ex:
@@ -11779,7 +11848,7 @@ class SpotifyClient:
11779
11848
  A comma-separated list of the Spotify IDs for the audiobooks.
11780
11849
  Maximum: 50 IDs.
11781
11850
  Example: `3PFyizE2tGCSRLusl2Qizf,7iHfbu1YPACw6oZPAFJtqe`
11782
- If null, the currently playing track album uri id value is used.
11851
+ If null, the currently playing audiobook uri id value is used.
11783
11852
 
11784
11853
  Raises:
11785
11854
  SpotifyWebApiError:
@@ -11841,6 +11910,7 @@ class SpotifyClient:
11841
11910
  # no results to process - this is pass or fail.
11842
11911
  return
11843
11912
 
11913
+ except SpotifyApiError: raise # pass handled exceptions on thru
11844
11914
  except SpotifyWebApiError: raise # pass handled exceptions on thru
11845
11915
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
11846
11916
  except Exception as ex:
@@ -11868,7 +11938,7 @@ class SpotifyClient:
11868
11938
  A comma-separated list of the Spotify IDs for the episodes.
11869
11939
  Maximum: 50 IDs.
11870
11940
  Example: `6kAsbP8pxwaU2kPibKTuHE,4rOoJ6Egrf8K2IrywzwOMk`
11871
- If null, the currently playing context uri id value is used.
11941
+ If null, the currently playing episode uri id value is used.
11872
11942
 
11873
11943
  Raises:
11874
11944
  SpotifyWebApiError:
@@ -11930,6 +12000,7 @@ class SpotifyClient:
11930
12000
  # no results to process - this is pass or fail.
11931
12001
  return
11932
12002
 
12003
+ except SpotifyApiError: raise # pass handled exceptions on thru
11933
12004
  except SpotifyWebApiError: raise # pass handled exceptions on thru
11934
12005
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
11935
12006
  except Exception as ex:
@@ -12136,7 +12207,7 @@ class SpotifyClient:
12136
12207
  A comma-separated list of the Spotify IDs for the shows.
12137
12208
  Maximum: 50 IDs.
12138
12209
  Example: `6kAsbP8pxwaU2kPibKTuHE,4rOoJ6Egrf8K2IrywzwOMk`
12139
- If null, the currently playing context uri id value is used.
12210
+ If null, the currently playing show uri id value is used.
12140
12211
 
12141
12212
  Raises:
12142
12213
  SpotifyWebApiError:
@@ -12198,6 +12269,7 @@ class SpotifyClient:
12198
12269
  # no results to process - this is pass or fail.
12199
12270
  return
12200
12271
 
12272
+ except SpotifyApiError: raise # pass handled exceptions on thru
12201
12273
  except SpotifyWebApiError: raise # pass handled exceptions on thru
12202
12274
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
12203
12275
  except Exception as ex:
@@ -12224,7 +12296,7 @@ class SpotifyClient:
12224
12296
  A comma-separated list of the Spotify IDs for the tracks.
12225
12297
  Maximum: 50 IDs.
12226
12298
  Example: `1kWUud3vY5ij5r62zxpTRy,4eoYKv2kDwJS7gRGh5q6SK`
12227
- If null, the currently playing context uri id value is used.
12299
+ If null, the currently playing track uri id value is used.
12228
12300
 
12229
12301
  Raises:
12230
12302
  SpotifyWebApiError:
@@ -12576,6 +12648,7 @@ class SpotifyClient:
12576
12648
  # no results to process - this is pass or fail.
12577
12649
  return
12578
12650
 
12651
+ except SpotifyApiError: raise # pass handled exceptions on thru
12579
12652
  except SpotifyWebApiError: raise # pass handled exceptions on thru
12580
12653
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
12581
12654
  except Exception as ex:
@@ -12603,6 +12676,7 @@ class SpotifyClient:
12603
12676
  A comma-separated list of the Spotify IDs for the audiobooks.
12604
12677
  Maximum: 50 IDs.
12605
12678
  Example: `3PFyizE2tGCSRLusl2Qizf,7iHfbu1YPACw6oZPAFJtqe`
12679
+ If null, the currently playing audiobook uri id value is used.
12606
12680
 
12607
12681
  Raises:
12608
12682
  SpotifyWebApiError:
@@ -12664,6 +12738,7 @@ class SpotifyClient:
12664
12738
  # no results to process - this is pass or fail.
12665
12739
  return
12666
12740
 
12741
+ except SpotifyApiError: raise # pass handled exceptions on thru
12667
12742
  except SpotifyWebApiError: raise # pass handled exceptions on thru
12668
12743
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
12669
12744
  except Exception as ex:
@@ -12691,7 +12766,7 @@ class SpotifyClient:
12691
12766
  A comma-separated list of the Spotify IDs for the episodes.
12692
12767
  Maximum: 50 IDs.
12693
12768
  Example: `6kAsbP8pxwaU2kPibKTuHE,4rOoJ6Egrf8K2IrywzwOMk`
12694
- If null, the currently playing context uri id value is used.
12769
+ If null, the currently playing episode uri id value is used.
12695
12770
 
12696
12771
  Raises:
12697
12772
  SpotifyWebApiError:
@@ -12753,6 +12828,7 @@ class SpotifyClient:
12753
12828
  # no results to process - this is pass or fail.
12754
12829
  return
12755
12830
 
12831
+ except SpotifyApiError: raise # pass handled exceptions on thru
12756
12832
  except SpotifyWebApiError: raise # pass handled exceptions on thru
12757
12833
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
12758
12834
  except Exception as ex:
@@ -12780,7 +12856,7 @@ class SpotifyClient:
12780
12856
  A comma-separated list of the Spotify IDs for the shows.
12781
12857
  Maximum: 50 IDs.
12782
12858
  Example: `6kAsbP8pxwaU2kPibKTuHE,4rOoJ6Egrf8K2IrywzwOMk`
12783
- If null, the currently playing context uri id value is used.
12859
+ If null, the currently playing show uri id value is used.
12784
12860
 
12785
12861
  Raises:
12786
12862
  SpotifyWebApiError:
@@ -12842,6 +12918,7 @@ class SpotifyClient:
12842
12918
  # no results to process - this is pass or fail.
12843
12919
  return
12844
12920
 
12921
+ except SpotifyApiError: raise # pass handled exceptions on thru
12845
12922
  except SpotifyWebApiError: raise # pass handled exceptions on thru
12846
12923
  except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
12847
12924
  except Exception as ex:
@@ -12868,7 +12945,7 @@ class SpotifyClient:
12868
12945
  A comma-separated list of the Spotify IDs for the tracks.
12869
12946
  Maximum: 50 IDs.
12870
12947
  Example: `6vc9OTcyd3hyzabCmsdnwE,382ObEPsp2rxGrnsizN5TX,2noRn2Aes5aoNVsU6iWThc`
12871
- If null, the currently playing context uri id value is used.
12948
+ If null, the currently playing track uri id value is used.
12872
12949
 
12873
12950
  Raises:
12874
12951
  SpotifyWebApiError: