{"id":13814340,"url":"https://github.com/kurtmckee/listparser","last_synced_at":"2025-04-07T12:09:03.554Z","repository":{"id":587772,"uuid":"221762","full_name":"kurtmckee/listparser","owner":"kurtmckee","description":"Parse OPML subscription lists in Python","archived":false,"fork":false,"pushed_at":"2024-09-26T20:41:08.000Z","size":741,"stargazers_count":75,"open_issues_count":1,"forks_count":3,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-14T18:33:24.874Z","etag":null,"topics":["foaf","igoogle","opml","python","rdf"],"latest_commit_sha":null,"homepage":"https://listparser.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kurtmckee.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"kurtmckee","ko_fi":"kurtmckee"}},"created_at":"2009-06-08T17:26:46.000Z","updated_at":"2024-09-26T20:41:11.000Z","dependencies_parsed_at":"2023-10-02T13:43:06.753Z","dependency_job_id":"e0ec6a0f-b3db-474c-ab6d-bf8fbd36df65","html_url":"https://github.com/kurtmckee/listparser","commit_stats":{"total_commits":393,"total_committers":3,"mean_commits":131.0,"dds":0.03816793893129766,"last_synced_commit":"b722d0522f89ee96366053be5dd6f9e29347b0a1"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurtmckee%2Flistparser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurtmckee%2Flistparser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurtmckee%2Flistparser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kurtmckee%2Flistparser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kurtmckee","download_url":"https://codeload.github.com/kurtmckee/listparser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247648978,"owners_count":20972945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["foaf","igoogle","opml","python","rdf"],"created_at":"2024-08-04T04:01:54.292Z","updated_at":"2025-04-07T12:09:03.532Z","avatar_url":"https://github.com/kurtmckee.png","language":"Python","funding_links":["https://github.com/sponsors/kurtmckee","https://ko-fi.com/kurtmckee"],"categories":["Python"],"sub_categories":[],"readme":"..\n    This file is part of listparser.\n    Copyright 2009-2025 Kurt McKee \u003ccontactme@kurtmckee.org\u003e\n    SPDX-License-Identifier: MIT\n\n..  image:: docs/_static/banner.png\n    :alt: listparser: Parse OPML subscription lists in Python.\n\n-------------------------------------------------------------------------------\n\nIf you're building a feed reader and you need to parse OPML subscription lists,\nyou've come to the right place!\n\nlistparser makes it easy to parse and use subscription lists in multiple formats.\nIt supports OPML and RDF+FOAF, and runs on Python 3.9+ and on PyPy 3.10.\n\n\n\nUsage\n=====\n\n..  code-block:: pycon\n\n    \u003e\u003e\u003e import listparser\n    \u003e\u003e\u003e result = listparser.parse(open(\"feeds.opml\").read())\n\nA dictionary will be returned with several keys:\n\n*   ``meta``: a dictionary of information about the subscription list\n*   ``feeds``: a list of feeds\n*   ``lists``: a list of subscription lists\n*   ``version``: a format identifier like \"opml2\"\n*   ``bozo``: True if there is a problem with the list, False otherwise\n*   ``bozo_exception``: (if ``bozo`` is 1) a description of the problem\n\nFor convenience, the result dictionary supports attribute access for its keys.\n\nContinuing the example:\n\n..  code-block:: pycon\n\n    \u003e\u003e\u003e result.meta.title\n    'listparser project feeds'\n    \u003e\u003e\u003e len(result.feeds)\n    2\n    \u003e\u003e\u003e result.feeds[0].title, result.feeds[0].url\n    ('listparser blog', 'https://kurtmckee.org/tag/listparser')\n\nMore extensive documentation is available in the ``docs/`` directory\n`and online \u003chttps://listparser.readthedocs.io/en/latest/\u003e`_.\n\n\nBugs\n====\n\nThere are going to be bugs. The best way to handle them will be to\nisolate the simplest possible document that susses out the bug, add\nthat document as a test case, and then find and fix the problem.\n\n...you can also just report the bug and leave it to someone else\nto fix the problem, but that won't be as much fun for you!\n\n`Bugs can be reported on GitHub \u003chttps://github.com/kurtmckee/listparser/issues\u003e`_.\n\n\nGit workflow\n============\n\nlistparser basically follows the git-flow methodology:\n\n*   Features and changes are developed in branches off the ``main`` branch.\n    They merge back into the ``main`` branch.\n*   Feature releases branch off the ``main`` branch.\n    The project metadata is updated (like the version and copyright years),\n    and then the release branch merges into the ``releases`` branch.\n    The ``releases`` branch is then tagged, and then it is merged back into ``main``.\n*   Hotfixes branch off the ``releases`` branch.\n    As with feature releases, the project metadata is updated,\n    the hotfix branch merges back into the ``releases`` branch,\n    which is then tagged and merged back into ``main``.\n\n\nDevelopment\n===========\n\nTo set up a development environment, follow these steps at a command line:\n\n..  code-block:: shell\n\n    # Set up a virtual environment.\n    python -m venv .venv\n\n    # Activate the virtual environment in Linux:\n    . .venv/bin/activate\n\n    # ...or in Windows Powershell:\n    \u0026 .venv/Scripts/Activate.ps1\n\n    # Install dependencies.\n    python -m pip install -U pip setuptools wheel\n    python -m pip install poetry pre-commit tox scriv\n    poetry install --all-extras\n\n    # Enable pre-commit.\n    pre-commit install\n\n    # Run the unit tests.\n    tox\n\n\nWhen submitting a PR, be sure to create and edit a changelog fragment.\n\n..  code-block:: shell\n\n    scriv create\n\n\nThe changelog fragment will be created in the ``changelog.d/`` directory.\nEdit the file to describe the changes you've made.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurtmckee%2Flistparser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkurtmckee%2Flistparser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkurtmckee%2Flistparser/lists"}