overcast-parser


Nameovercast-parser JSON
Version 0.1.0 PyPI version JSON
download
home_pagehttps://github.com/hbmartin/overcast_parser
SummaryOvercast podcast link parser especially for pythonista.
upload_time2024-02-19 00:24:22
maintainer
docs_urlNone
authorHarold Martin
requires_python
licenseMIT
keywords podcast parser rss feed pythonista overcast shortcuts ios
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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"
}
        
Elapsed time: 0.18542s