Metadata-Version: 2.1
Name: knewkarma
Version: 7.1.2
Summary: A Reddit data analysis toolkit
License: GPL-3.0+
Keywords: reddit,data-analysis
Author: Richard Mwewa
Author-email: rly0nheart@duck.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Provides-Extra: visualisation
Requires-Dist: kraw (>=0.3.3,<0.4.0)
Requires-Dist: matplotlib (>=3.9.2,<4.0.0) ; extra == "visualisation"
Requires-Dist: pandas (>=2.1.4,<3.0.0)
Requires-Dist: rich-click (>=1.8.3,<2.0.0)
Project-URL: homepage, https://knewkarma.readthedocs.io
Project-URL: issues, https://github.com/knewkarma-io/knewkarma/issues
Project-URL: repository, https://github.com/knewkarma-io/knewkarma
Project-URL: sponsor, https://opencollective.com/knewkarma
Description-Content-Type: text/markdown

<p align="center"><strong>Knew Karma</strong> (/nuː ‘kɑːrmə/) is a Reddit data analysis toolkit designed to provide an extensive range of functionalities for exploring and analysing Reddit data. It includes a <strong>Command-Line Interface</strong> (<strong>CLI</strong>), and an <strong>Application Programming Interface</strong> (<strong>API</strong>) to enable easy integration in other Python projects and/or scripts.</p>

<p align="center">
  <a href="https://github.com/knewkarma-io/knewkarma"><img alt="Code Style" src="https://img.shields.io/badge/code%20style-black-000000?logo=github&link=https%3A%2F%2Fgithub.com%2Frly0nheart%2Fknewkarma"></a>
  <a href="https://pepy.tech/project/knewkarma"><img alt="Downloads" src="https://img.shields.io/pepy/dt/knewkarma?logo=pypi"></a>
  <a href="https://pypi.org/project/knewkarma"><img alt="PyPI - Version" src="https://img.shields.io/pypi/v/knewkarma?logo=pypi&link=https%3A%2F%2Fpypi.org%2Fproject%2Fknewkarma"></a>
  <a href="https://snapcraft.io/knewkarma"><img alt="Snap Version" src="https://img.shields.io/snapcraft/v/knewkarma/latest/stable?logo=snapcraft&color=%23BB431A"></a>
  <!--<a href="https://opencollective.com/knewkarma"><img alt="Open Collective backers and sponsors" src="https://img.shields.io/opencollective/all/knewkarma?logo=open-collective"></a>-->
</p>

```commandline
knewkarma subreddit AskScience --posts
```

```python
import asyncio

import aiohttp
import knewkarma


async def subreddit_posts(subreddit_name, posts_limit):
    subreddit = knewkarma.Subreddit(name=subreddit_name)

    async with aiohttp.ClientSession() as session:
        posts = await subreddit.posts(session=session, limit=posts_limit)

        for post in posts:
            print(post.data.title)


asyncio.run(subreddit_posts(subreddit_name="AskScience", posts_limit=200))
```

## Documentation

Refer to the [documentation](https://knewkarma.readthedocs.io) for *Feature Overview*, *Installation*, *API
Integration*, and *Usage* instructions.

## Sponsorship

If you find Knew Karma useful and would like to support its development, you can sponsor the project through **Open
Collective**.

Your sponsorship will help cover the **costs of ongoing maintenance**, **new feature development**, and **overall
project sustainability**.

### How to Sponsor

You can sponsor the project by visiting Knew Karma's [Open Collective page](https://opencollective.com/knewkarma) and
choosing a sponsorship tier that fits your budget.

Whether you're a company that relies on Knew Karma for data analysis or an individual who appreciates open-source
projects and/or the work put into this project in particular, any sponsorship tier is greatly appreciated.

[Become a Sponsor](https://opencollective.com/knewkarma)

## Star History

<a href="https://star-history.com/#knewkarma-io/knewkarma&Date">
   <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=knewkarma-io/knewkarma&type=Date&theme=dark" />
      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=knewkarma-io/knewkarma&type=Date" />
      <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=knewkarma-io/knewkarma&type=Date" />
   </picture>
</a>

## License

GPL-3.0+ License © [Richard Mwewa](https://gravatar.com/rly0nheart)

