Metadata-Version: 2.2
Name: ppydfs
Version: 1.1
Summary: Python Parallel Distributed File System (PPYDFS)
Home-page: http://blog.cycleuser.org
Author: cycleuser
Author-email: cycleuser@cycleuser.org
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pywebio
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# PPYDFS - Python Parallel Distributed File System

PPYDFS is a lightweight parallel distributed file system implemented in Python. It provides a reliable way to store and access files across multiple server nodes with automatic replication and failure recovery.

## Features

- **Distributed Storage**: Files are split into blocks and distributed across multiple data servers
- **Data Replication**: Configurable replication factor ensures data redundancy and availability
- **Fault Tolerance**: Automatic block re-replication when servers fail
- **Web Monitoring Interface**: Real-time monitoring of system status and file distribution
- **Command Line Interface**: Easy-to-use commands for system management and file operations

## Architecture

PPYDFS consists of three main components:

1. **Name Server**: Manages file metadata and coordinates data servers
2. **Data Servers**: Store the actual file blocks with replication
3. **Client**: Interface for users to upload, download, and manage files

## Installation

### Install from PyPI

```bash
pip install pywebio
pip install ppydfs
```

### Run from Code

```bash
git clone https://github.com/EasyCam/PPYDFS.git
cd PPYDFS
pip install -r requirements.txt
python install ppydfs
```

## Usage

### Starting a Name Server

```bash
python -m ppydfs nameserver [web_port]
```

Example:

```bash
python -m ppydfs nameserver 8080
```

This starts a name server with a web monitoring interface accessible at http://localhost:8080.

### Starting a Data Server

```bash
python -m ppydfs dataserver [host] [port] [storage_dir] [name_server]
```

Example:
```bash
python -m ppydfs dataserver localhost 9001 ./storage localhost:9000
```

### Client Operations

#### Upload a file

```bash
python -m ppydfs client upload myfile.txt [remote_name]
```

#### Download a file

```bash
python -m ppydfs client download remote_file [local_path]
```

#### List all files

```bash
python -m ppydfs client list
```

#### Delete a file

```bash
python -m ppydfs client delete remote_file
```

## Web Interface

The web interface provides:

- Real-time monitoring of data servers
- File upload/download functionality
- File and block management
- System status information

## Configuration

Default settings:
- Name server port: 9000
- Web interface port: 8080
- Replication factor: 2
- Block size: 4MB


## License

GPLv3
