Metadata-Version: 2.4
Name: tivals-easyos
Version: 1.0.0
Summary: A simple, powerful Python wrapper for common operating-system tasks.
Author: Tivalsdeveloper
License: MIT
Project-URL: Homepage, https://github.com/tivalsdeveloper-oss/easyos
Project-URL: Repository, https://github.com/tivalsdeveloper-oss/easyos
Project-URL: Issues, https://github.com/tivalsdeveloper-oss/easyos/issues
Keywords: os,filesystem,automation,system,utilities
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# easyos

**Simple Python OS utilities by Tivalsdeveloper.**

`easyos` provides a clean, beginner-friendly interface over Python's standard-library operating-system tools. It has **no third-party runtime dependencies**, making it suitable for offline installation.

## Install

```bash
pip install easyos
```

For a local/offline wheel:

```bash
pip install --no-index easyos-1.0.0-py3-none-any.whl
```

## Quick start

```python
from easyos import OS

system = OS()

print(system.cwd())
system.files.create("hello.txt", "Hello from easyos!")
print(system.files.read("hello.txt"))
print(system.info.all())
```

## API

### Files

```python
system.files.create("hello.txt", "Hello")
system.files.read("hello.txt")
system.files.write("hello.txt", "New content")
system.files.append("hello.txt", "\nMore")
system.files.copy("hello.txt", "copy.txt")
system.files.move("copy.txt", "archive/copy.txt")
system.files.rename("hello.txt", "greeting.txt")
system.files.delete("greeting.txt")
system.files.info("archive/copy.txt")
```

### Directories

```python
system.directories.create("project/src")
system.directories.list(".")
system.directories.walk(".")
print(system.directories.tree("."))
system.directories.delete("project", recursive=True)
```

### Paths

```python
system.paths.join("src", "main.py")
system.paths.basename("/tmp/main.py")
system.paths.dirname("/tmp/main.py")
system.paths.extension("main.py")
system.paths.absolute("main.py")
```

### Environment

```python
system.env.set("APP_NAME", "Tivelop")
print(system.env.get("APP_NAME"))
print(system.env.has("APP_NAME"))
```

### Commands

```python
result = system.commands.run("python --version")
print(result.stdout)

# Avoid shell parsing when passing separate arguments.
result = system.commands.exec(["python", "--version"])
```

### System information

```python
print(system.info.platform())
print(system.info.python_version())
print(system.info.username())
print(system.info.home())
print(system.info.cpu_count())
print(system.info.all())
```

## Design

```text
OS
├── files
├── directories
├── paths
├── env
├── commands
└── info
```

## Requirements

- Python 3.9+
- No third-party runtime dependencies
- Cross-platform Python implementation

## License

MIT
