Metadata-Version: 2.1
Name: monkeywork
Version: 0.1
Summary: Write and edit random files in a given directory
Home-page: https://github.com/pylomatic/monkeywork
Author: Pylomatic
Author-email: pylomatic@conelab.ch
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENCE

# Monkeywork

## Description

Are you in need of a Monkey typing on their keyboard and saving files into a random directory? Look no furtherâ€¦

This program was designed to stress test a file synchronization solution by simulating a user who reads, writes, and edits files within a specific directory.
You can specify a working directory where the program will conduct the following operations at a set interval:
-	Create text and binary files with random content.
-	Create random subdirectories.
-	Open and edit files.
-	Rename files and directories.
-	Delete random files.
-	Delete random subdirectories.
All operations are being written into a log file.

The idea behind this program is to run it on both ends of a file sharing or syncing solution. By doing so, you can test whether your solution is capable of handling regular and potentially conflicting user activities.

## !!! CAUTION !!!

The program can and will destroy files in the selected work directory. Be sure to select a dedicated work directory and **review the code before executing it on your system**!

## Installation

You can run the `monkeywork.py`directly from from the console with:

```bash
python monkeywork.py "<Path to your workdir>" [OPTIONS]
```

example:
```bash
python monkeywork.py "L:\\monkeywork-test\\"
```

Options are:
- f | force selected direcotry and delete all contents in set directory

## Installation

Use it as a package

```bash
pip install monkeywork
```
