Metadata-Version: 2.1
Name: newspy
Version: 1.2.1
Summary: The news client written in Python that fetches and curates the world news across the web.
Home-page: https://github.com/onemoola/newspy
License: MIT
Author: Sechaba Mofokeng
Author-email: sechaba@onemoola.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: requests (==2.31.0)
Project-URL: Bug Tracker, https://github.com/onemoola/newspy/issues
Project-URL: Documentation, https://github.com/onemoola/newspy#readme
Project-URL: Repository, https://github.com/onemoola/newspy
Description-Content-Type: text/markdown

# Newspy

The news client written in Python that fetches and curates the world news across the web.

## Requirements

* Python 3.10
* Poetry 1.3.1+ (for dependency management)
* yarn (for the semantic-release versioning)
* API Key from the New API Organisation: https://newsapi.org/

## News Sources

- [X] News API. Requires API Key from: https://newsapi.org/
- [ ] RSS feeds

## Getting started

1. Install and confirm the Python version

```bash
python --version
```

2. Create the virtual environment

```bash
python -m venv .venv

# Activate virtual environment
.venv/bin/activate # Linux or MacOS
.venv/Script/activate # Windows
```

3. Install the requirements

```bash
poetry install
```

4. Install the git hook scripts

```bash
pre-commit install
```

5. Yarn install semantic-release dependencies

```bash
yarn install
```

6. Set up husky pre-commit hook

```bash
yarn husky add .husky/commit-msg 'yarn commitlint --edit $1'
```

## Chores

- [X] Add GitHub Action for Continuous Integration (CI)
- [X] Add GitHub Action for Continuous Deployment (CD)

