# Overcast URL to podcast information
[![PyPI](https://img.shields.io/pypi/v/overcast_parser.svg)](https://pypi.org/project/overcast-parser/)
[![Lint](https://github.com/hbmartin/overcast_parser/actions/workflows/lint.yml/badge.svg)](https://github.com/hbmartin/overcast_parser/actions/workflows/lint.yml)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![Code style: black](https://img.shields.io/badge/🐧️-black-000000.svg)](https://github.com/psf/black)
[![Checked with pytype](https://img.shields.io/badge/🦆-pytype-437f30.svg)](https://google.github.io/pytype/)
[![Versions](https://img.shields.io/pypi/pyversions/overcast-to-sqlite.svg)](https://pypi.python.org/pypi/overcast-to-sqlite)
[![twitter](https://img.shields.io/badge/@hmartin-00aced.svg?logo=twitter&logoColor=black)](https://twitter.com/hmartin)
Python library to obtain RSS feed URL from Overcast link, built especially for Pythonista
## Installation / Upgrade
This can be installed one of two ways:
First, it can be installed directly in Pythonista with [StaSh](https://github.com/ywangd/stash)
```
pip install overcast-parser
```
Alternately, you can copy this entire repo to Pythonista and start immediately editing demo.py. This can be done i.e. with a git tool in Pythonista or, on your Mac, copying this to the Pythonista3 iCloud directory.
## Usage
#### See demo.py for full pythonista script
```
from overcast_parser.OvercastParser import OvercastParser
parser = OvercastParser()
data = requests.get(overcast_url).text
(itunes_id, stream_url, overcast_id, title, feed_url) = parser.parse_overcast(data)
```
## Shortcut
demo.py is meant to be used from either the share extension or from an iOS Shortcut. (Note that due to Pythonista limitations share extension cannot call a script in iCloud.)
You can [download a shortcut here](https://www.icloud.com/shortcuts/942bc3f2f69747429960fefdde4ccb2c) or create one like:
![shortcut](shortcut.png)
Where the final URL block is like (adjusted for your path or removing root=icloud)
```
pythonista3://overcast_parser/demo.py?action=run&root=icloud&args=URL Encoded Text
```
## Built With
* [pythonista-stubs](https://github.com/hbmartin/pythonista-stubs) - for desktop development
* [itunes_podcast_rss](https://github.com/wotaen/itunes_podcast_rss) - obtain RSS feed URL from iTunes link (built-in)
* [podcastparser](https://github.com/gpodder/podcastparser) - for parsing podcast feed (dependency)
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## Authors
* [Harold Martin](https://www.linkedin.com/in/harold-martin-98526971/) - harold.martin at gmail
## License
[MIT](LICENSE.txt)
Raw data
{
"_id": null,
"home_page": "https://github.com/hbmartin/overcast_parser",
"name": "overcast-parser",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "podcast,parser,rss,feed,pythonista,overcast,shortcuts,ios",
"author": "Harold Martin",
"author_email": "harold.martin@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3c/c0/f3866e109cc1d20e4174479deb597032589584999592eefeb70f1e34433c/overcast_parser-0.1.0.tar.gz",
"platform": null,
"description": "# Overcast URL to podcast information\n[![PyPI](https://img.shields.io/pypi/v/overcast_parser.svg)](https://pypi.org/project/overcast-parser/)\n[![Lint](https://github.com/hbmartin/overcast_parser/actions/workflows/lint.yml/badge.svg)](https://github.com/hbmartin/overcast_parser/actions/workflows/lint.yml)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![Code style: black](https://img.shields.io/badge/\ud83d\udc27\ufe0f-black-000000.svg)](https://github.com/psf/black)\n[![Checked with pytype](https://img.shields.io/badge/\ud83e\udd86-pytype-437f30.svg)](https://google.github.io/pytype/)\n[![Versions](https://img.shields.io/pypi/pyversions/overcast-to-sqlite.svg)](https://pypi.python.org/pypi/overcast-to-sqlite)\n[![twitter](https://img.shields.io/badge/@hmartin-00aced.svg?logo=twitter&logoColor=black)](https://twitter.com/hmartin)\n\nPython library to obtain RSS feed URL from Overcast link, built especially for Pythonista\n\n## Installation / Upgrade\n\nThis can be installed one of two ways:\n\nFirst, it can be installed directly in Pythonista with [StaSh](https://github.com/ywangd/stash)\n\n```\npip install overcast-parser\n```\n\nAlternately, you can copy this entire repo to Pythonista and start immediately editing demo.py. This can be done i.e. with a git tool in Pythonista or, on your Mac, copying this to the Pythonista3 iCloud directory.\n\n\n## Usage\n\n#### See demo.py for full pythonista script\n\n```\nfrom overcast_parser.OvercastParser import OvercastParser\n\n\nparser = OvercastParser()\n\ndata = requests.get(overcast_url).text\n\n(itunes_id, stream_url, overcast_id, title, feed_url) = parser.parse_overcast(data)\n```\n\n## Shortcut\ndemo.py is meant to be used from either the share extension or from an iOS Shortcut. (Note that due to Pythonista limitations share extension cannot call a script in iCloud.)\n\nYou can [download a shortcut here](https://www.icloud.com/shortcuts/942bc3f2f69747429960fefdde4ccb2c) or create one like:\n![shortcut](shortcut.png)\n\nWhere the final URL block is like (adjusted for your path or removing root=icloud)\n```\npythonista3://overcast_parser/demo.py?action=run&root=icloud&args=URL Encoded Text\n```\n\n## Built With\n\n* [pythonista-stubs](https://github.com/hbmartin/pythonista-stubs) - for desktop development\n* [itunes_podcast_rss](https://github.com/wotaen/itunes_podcast_rss) - obtain RSS feed URL from iTunes link (built-in)\n* [podcastparser](https://github.com/gpodder/podcastparser) - for parsing podcast feed (dependency)\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## Authors\n\n* [Harold Martin](https://www.linkedin.com/in/harold-martin-98526971/) - harold.martin at gmail\n\n\n## License\n\n[MIT](LICENSE.txt)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Overcast podcast link parser especially for pythonista.",
"version": "0.1.0",
"project_urls": {
"Bug Reports": "https://github.com/hbmartin/overcast_parser/issues",
"Homepage": "https://github.com/hbmartin/overcast_parser"
},
"split_keywords": [
"podcast",
"parser",
"rss",
"feed",
"pythonista",
"overcast",
"shortcuts",
"ios"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d4c55db3ade3f953da8d23dd6f1f14657ca82127a99d469da91647bbd6eb174",
"md5": "9d57432904fa253802e10f8f807a1b94",
"sha256": "ea9a16f723f888470b3457cb88c3ead8400d5dd7c3d99494df08f8b412f5e448"
},
"downloads": -1,
"filename": "overcast_parser-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9d57432904fa253802e10f8f807a1b94",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6125,
"upload_time": "2024-02-19T00:24:20",
"upload_time_iso_8601": "2024-02-19T00:24:20.893075Z",
"url": "https://files.pythonhosted.org/packages/4d/4c/55db3ade3f953da8d23dd6f1f14657ca82127a99d469da91647bbd6eb174/overcast_parser-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3cc0f3866e109cc1d20e4174479deb597032589584999592eefeb70f1e34433c",
"md5": "3e942905acc79c908413b5ffeccfd57d",
"sha256": "468cc4ab3b873b29e06adf1ded857bc707cbff5364bccd03dfbebd37f9f90a00"
},
"downloads": -1,
"filename": "overcast_parser-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "3e942905acc79c908413b5ffeccfd57d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7235,
"upload_time": "2024-02-19T00:24:22",
"upload_time_iso_8601": "2024-02-19T00:24:22.630784Z",
"url": "https://files.pythonhosted.org/packages/3c/c0/f3866e109cc1d20e4174479deb597032589584999592eefeb70f1e34433c/overcast_parser-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-19 00:24:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hbmartin",
"github_project": "overcast_parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "overcast-parser"
}