Simyan


NameSimyan JSON
Version 1.4.0 PyPI version JSON
download
home_pageNone
SummaryA Python wrapper for the Comicvine API.
upload_time2024-12-20 03:33:35
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseGPL-3.0-or-later
keywords comic comics metadata
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Simyan

[![PyPI - Python](https://img.shields.io/pypi/pyversions/Simyan.svg?logo=Python&label=Python&style=flat-square)](https://pypi.python.org/pypi/Simyan/)
[![PyPI - Status](https://img.shields.io/pypi/status/Simyan.svg?logo=Python&label=Status&style=flat-square)](https://pypi.python.org/pypi/Simyan/)
[![PyPI - Version](https://img.shields.io/pypi/v/Simyan.svg?logo=Python&label=Version&style=flat-square)](https://pypi.python.org/pypi/Simyan/)
[![PyPI - License](https://img.shields.io/pypi/l/Simyan.svg?logo=Python&label=License&style=flat-square)](https://opensource.org/licenses/GPL-3.0)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-informational?logo=pre-commit&style=flat-square)](https://github.com/pre-commit/pre-commit)
[![Ruff](https://img.shields.io/badge/ruff-enabled-informational?logo=ruff&style=flat-square)](https://github.com/astral-sh/ruff)

[![Github - Contributors](https://img.shields.io/github/contributors/Metron-Project/Simyan.svg?logo=Github&label=Contributors&style=flat-square)](https://github.com/Metron-Project/Simyan/graphs/contributors)
[![Github Action - Testing](https://img.shields.io/github/actions/workflow/status/Metron-Project/Simyan/testing.yaml?branch=main&logo=Github&label=Testing&style=flat-square)](https://github.com/Metron-Project/Simyan/actions/workflows/testing.yaml)
[![Github Action - Publishing](https://img.shields.io/github/actions/workflow/status/Metron-Project/Simyan/publishing.yaml?branch=main&logo=Github&label=Publishing&style=flat-square)](https://github.com/Metron-Project/Simyan/actions/workflows/publishing.yaml)

[![Read the Docs](https://img.shields.io/readthedocs/simyan?label=Read-the-Docs&logo=Read-the-Docs&style=flat-square)](https://simyan.readthedocs.io/en/stable)

A [Python](https://www.python.org/) wrapper for the [Comicvine API](https://comicvine.gamespot.com/api/).

## Installation

```console
pip install --user Simyan
```

### Example Usage

```python
from simyan.comicvine import Comicvine
from simyan.sqlite_cache import SQLiteCache

session = Comicvine(api_key="Comicvine API Key", cache=SQLiteCache())

# Search for Publisher
results = session.list_publishers(params={"filter": "name:DC Comics"})
for publisher in results:
    print(f"{publisher.id} | {publisher.name} - {publisher.site_url}")

# Get details for a Volume
result = session.get_volume(volume_id=26266)
print(result.summary)
```

## Documentation

- [Simyan](https://simyan.readthedocs.io/en/stable)
- [Comicvine API](https://comicvine.gamespot.com/api/documentation)

## Bugs/Requests

Please use the [GitHub issue tracker](https://github.com/Metron-Project/Simyan/issues) to submit bugs or request features.

## Contributing

- When running a new test for the first time, set the environment variable `COMICVINE__API_KEY` to your Comicvine API key.
  The responses will be cached in the `tests/cache.sqlite` database without your key.

## Socials

[![Social - Matrix](https://img.shields.io/matrix/metron-general:matrix.org?label=Metron%20General&logo=matrix&style=for-the-badge)](https://matrix.to/#/#metron-general:matrix.org)
[![Social - Matrix](https://img.shields.io/matrix/metron-devel:matrix.org?label=Metron%20Development&logo=matrix&style=for-the-badge)](https://matrix.to/#/#metron-development:matrix.org)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "Simyan",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "BuriedInCode <BuriedInCode@tuta.io>",
    "keywords": "comic, comics, metadata",
    "author": null,
    "author_email": "BuriedInCode <BuriedInCode@tuta.io>",
    "download_url": "https://files.pythonhosted.org/packages/9e/e1/36f7e42d481401c1078783a2fd7edf670ab40d1a3e157a4a6085024a2d60/simyan-1.4.0.tar.gz",
    "platform": null,
    "description": "# Simyan\n\n[![PyPI - Python](https://img.shields.io/pypi/pyversions/Simyan.svg?logo=Python&label=Python&style=flat-square)](https://pypi.python.org/pypi/Simyan/)\n[![PyPI - Status](https://img.shields.io/pypi/status/Simyan.svg?logo=Python&label=Status&style=flat-square)](https://pypi.python.org/pypi/Simyan/)\n[![PyPI - Version](https://img.shields.io/pypi/v/Simyan.svg?logo=Python&label=Version&style=flat-square)](https://pypi.python.org/pypi/Simyan/)\n[![PyPI - License](https://img.shields.io/pypi/l/Simyan.svg?logo=Python&label=License&style=flat-square)](https://opensource.org/licenses/GPL-3.0)\n\n[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-informational?logo=pre-commit&style=flat-square)](https://github.com/pre-commit/pre-commit)\n[![Ruff](https://img.shields.io/badge/ruff-enabled-informational?logo=ruff&style=flat-square)](https://github.com/astral-sh/ruff)\n\n[![Github - Contributors](https://img.shields.io/github/contributors/Metron-Project/Simyan.svg?logo=Github&label=Contributors&style=flat-square)](https://github.com/Metron-Project/Simyan/graphs/contributors)\n[![Github Action - Testing](https://img.shields.io/github/actions/workflow/status/Metron-Project/Simyan/testing.yaml?branch=main&logo=Github&label=Testing&style=flat-square)](https://github.com/Metron-Project/Simyan/actions/workflows/testing.yaml)\n[![Github Action - Publishing](https://img.shields.io/github/actions/workflow/status/Metron-Project/Simyan/publishing.yaml?branch=main&logo=Github&label=Publishing&style=flat-square)](https://github.com/Metron-Project/Simyan/actions/workflows/publishing.yaml)\n\n[![Read the Docs](https://img.shields.io/readthedocs/simyan?label=Read-the-Docs&logo=Read-the-Docs&style=flat-square)](https://simyan.readthedocs.io/en/stable)\n\nA [Python](https://www.python.org/) wrapper for the [Comicvine API](https://comicvine.gamespot.com/api/).\n\n## Installation\n\n```console\npip install --user Simyan\n```\n\n### Example Usage\n\n```python\nfrom simyan.comicvine import Comicvine\nfrom simyan.sqlite_cache import SQLiteCache\n\nsession = Comicvine(api_key=\"Comicvine API Key\", cache=SQLiteCache())\n\n# Search for Publisher\nresults = session.list_publishers(params={\"filter\": \"name:DC Comics\"})\nfor publisher in results:\n    print(f\"{publisher.id} | {publisher.name} - {publisher.site_url}\")\n\n# Get details for a Volume\nresult = session.get_volume(volume_id=26266)\nprint(result.summary)\n```\n\n## Documentation\n\n- [Simyan](https://simyan.readthedocs.io/en/stable)\n- [Comicvine API](https://comicvine.gamespot.com/api/documentation)\n\n## Bugs/Requests\n\nPlease use the [GitHub issue tracker](https://github.com/Metron-Project/Simyan/issues) to submit bugs or request features.\n\n## Contributing\n\n- When running a new test for the first time, set the environment variable `COMICVINE__API_KEY` to your Comicvine API key.\n  The responses will be cached in the `tests/cache.sqlite` database without your key.\n\n## Socials\n\n[![Social - Matrix](https://img.shields.io/matrix/metron-general:matrix.org?label=Metron%20General&logo=matrix&style=for-the-badge)](https://matrix.to/#/#metron-general:matrix.org)\n[![Social - Matrix](https://img.shields.io/matrix/metron-devel:matrix.org?label=Metron%20Development&logo=matrix&style=for-the-badge)](https://matrix.to/#/#metron-development:matrix.org)\n",
    "bugtrack_url": null,
    "license": "GPL-3.0-or-later",
    "summary": "A Python wrapper for the Comicvine API.",
    "version": "1.4.0",
    "project_urls": {
        "Documentation": "https://simyan.readthedocs.io/en/latest/",
        "Homepage": "https://pypi.org/project/Simyan",
        "Issues": "https://github.com/Metron-Project/Simyan/issues",
        "Source": "https://github.com/Metron-Project/Simyan"
    },
    "split_keywords": [
        "comic",
        " comics",
        " metadata"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "272c0a40eb50f0c9664b545cae055f2abf245f80db5d066ec6245e07071f5576",
                "md5": "f45e6addb4def0f5ff453dd9824b6955",
                "sha256": "b3caaa1f34e9c9e833c96d704530380608acd635b2e6818d911641bf131f4cf5"
            },
            "downloads": -1,
            "filename": "simyan-1.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f45e6addb4def0f5ff453dd9824b6955",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 33215,
            "upload_time": "2024-12-20T03:33:33",
            "upload_time_iso_8601": "2024-12-20T03:33:33.027583Z",
            "url": "https://files.pythonhosted.org/packages/27/2c/0a40eb50f0c9664b545cae055f2abf245f80db5d066ec6245e07071f5576/simyan-1.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9ee136f7e42d481401c1078783a2fd7edf670ab40d1a3e157a4a6085024a2d60",
                "md5": "d9366368e0e7fdb8cbe25f799fa82c50",
                "sha256": "796b9ee67b83a3e19c4a14ae6dd89299abc72205bd6e14eb255f21534dcc5ef4"
            },
            "downloads": -1,
            "filename": "simyan-1.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "d9366368e0e7fdb8cbe25f799fa82c50",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 4955334,
            "upload_time": "2024-12-20T03:33:35",
            "upload_time_iso_8601": "2024-12-20T03:33:35.544468Z",
            "url": "https://files.pythonhosted.org/packages/9e/e1/36f7e42d481401c1078783a2fd7edf670ab40d1a3e157a4a6085024a2d60/simyan-1.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-20 03:33:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Metron-Project",
    "github_project": "Simyan",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "simyan"
}
        
Elapsed time: 0.40502s