Metadata-Version: 2.1
Name: overcast_parser
Version: 0.1.0
Summary: Overcast podcast link parser especially for pythonista.
Home-page: https://github.com/hbmartin/overcast_parser
Author: Harold Martin
Author-email: harold.martin@gmail.com
License: MIT
Project-URL: Bug Reports, https://github.com/hbmartin/overcast_parser/issues
Keywords: podcast,parser,rss,feed,pythonista,overcast,shortcuts,ios
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: iOS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Markup :: XML
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: podcastparser
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: pythonista-stubs; extra == "dev"
Provides-Extra: lint
Requires-Dist: ruff; extra == "lint"
Requires-Dist: pyroma; extra == "lint"
Requires-Dist: pytype; extra == "lint"
Requires-Dist: types-python-dateutil; extra == "lint"
Requires-Dist: types-requests; extra == "lint"

# 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)
