Metadata-Version: 2.1
Name: newsapi-python-client
Version: 0.2.4
Summary: A Python client to interact with News API from NewApi.org
Home-page: https://github.com/roachseb/NewsAPI-Python-Client
Author: Roach Sebastien
Author-email: sebastien.r.r@hotmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE

Based on the updated structure of your library, here's a revised README:

# NewsAPI Python Client

## Description

This project provides a Python client for accessing the NewsAPI. It simplifies the process of integrating news search capabilities into your applications. Whether you're building a news aggregation service, a stock trading platform that needs financial news, or a social media app that wants to display relevant news to users, this library is here to assist.

## Features

- Intuitive Python interface for NewsAPI.
- Leverages the `requests` library for HTTP requests.
- Employs an object-oriented model for both requests and responses.
- Supports all parameters of the NewsAPI, including advanced search queries and filtering.
- Designed for flexibility and extensibility, allowing for customization as needed.

## Installation

```bash
pip install newsapi-python-client
```

## Usage

First, you need to initialize the `NewsAPIService` with your NewsAPI key.

```python
import os
from newsApi.service import NewsAPIService  

news_api_service = NewsAPIService(os.environ.get('NEWS_API_KEY'))
```

Then you can use the service to make requests. Here is an example for retrieving news about finance:

```python
from newsApi.models.request import EverythingRequestModel

request_model = EverythingRequestModel(
    q='finance',
)

response = news_api_service.everything(request_model)

for article in response.articles:
    print(f"Title: {article.title}")
    print(f"URL: {article.url}")
    print("---")
```

Note: Remember to replace placeholder values in the `EverythingRequestModel` with actual values.

## Requirements

- Python 3.6 or later
- `requests` package

## Future Plans

- Enhance error handling and validation.
- Include more examples and use cases.
- Develop comprehensive documentation.

## Contributing

Contributions from the community are welcome. Please refer to the CONTRIBUTING.md file for more details.

## License

This project is licensed under the MIT License. See the LICENSE file for more details.


