# NewsPy

**Repository Path**: haozexu/news-py

## Basic Information

- **Project Name**: NewsPy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Based on the code map, I can now create a comprehensive README for this project. Let me analyze the key components:

**Project Analysis:**
- **newspy.py**: Main Flask application with async task system
- **Tasks**: Periodic tasks for updating Hitokoto (Japanese quotes) and Baidu sports data
- **Frontend**: Custom "PJSK" styled UI with canvas animations, particles, and sound effects
- **Routes**: Flask web routes for settings and main page

# News-Py

A Python async web application with periodic task scheduling, featuring sports data updates and a custom animated frontend interface.

## Features

- **Async Task System**: Custom async/await based task scheduling with `ATask` and `PeriodicTask` classes
- **Periodic Data Updates**: 
  - `UpdateHitokotoTask`: Updates Japanese quotes every 10 minutes
  - `UpdateBaiduSportDataTask`: Scrapes and analyzes sports match data every 4 hours
- **REST API**: Flask-based web interface with settings management
- **Custom UI**: PJSK-themed animated interface with:
  - Canvas particle effects
  - Sound effects (click, load)
  - Message boxes and banners
  - Progress indicators
  - Page transitions

## Requirements

- Python 3.7+
- Flask
- BeautifulSoup4 (for web scraping)
- aiohttp (for async HTTP requests)

## Installation

```bash
pip install flask beautifulsoup4 aiohttp
```

## Usage

Run the application:

```bash
python newspy.py
```

The web server will start and the periodic task main loop will begin automatically.

## Configuration

Access the settings page at `/set/<setting_name>/` to modify application parameters.

## Project Structure

```
.
├── newspy.py              # Main application (Flask + async tasks)
├── static/
│   ├── asset/             # Images and logos
│   ├── css/               # Stylesheets (pjsk UI theme)
│   └── js/                # JavaScript (animations, effects)
└── templates/
    └── index.html         # Main HTML template
```

## License

See LICENSE file for details.