# perses

**Repository Path**: mirrors_andyglick/perses

## Basic Information

- **Project Name**: perses
- **Description**: A project to cause (controlled) destruction on your jvm application 
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Perses
[![Build Status](https://travis-ci.org/nicolasmanic/perses.svg?branch=master)](https://travis-ci.org/nicolasmanic/perses)
[![License](https://img.shields.io/pypi/l/ansicolortags.svg)](https://github.com/nicolasmanic/perses/blob/master/LICENSE)
[![Gitter](https://badges.gitter.im/perses-app/community.svg)](https://gitter.im/perses-app/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

## Cause (controlled) destruction to your jvm application 

> **Perses** (Ancient Greek: Πέρσης) was the Titan god of destruction. His name is derived from the Ancient Greek word perthō ("to destroy")


### What is the goal.

Perses allows you to dynamically inject failure/latency at the bytecode level, without the need to add any dependency or restart/deploy the target app. Just load 2 jars at the same enviroment the target JVM is running and execute `java -jar perses-injector.jar <Target Application name>`. 

Perses is designed to enable developpers and QAs to easily reproduce & debug tricky production issues. 

For more information about how **Perses** works under the hood, how to set everything up & how to use it please visit 
the [wiki](https://github.com/nicolasmanic/perses/wiki).

### How to install

All jars are available [here](https://github.com/nicolasmanic/perses/releases). Select the version that matches the target
application.

1. Add `perses-agent.jar` & `perses-injector-jar-with-dependencies.jar` in the same environment as the target application.
2. Execute `java -jar perses-injector.jar <TARGET APPLICATION NAME>`.
3. Execute `java -jar perses.jar`
4. Visit `localhost:8777`


For more information about how **Perses** works under the hood, how to set everything up & how to use it please visit 
the [wiki](https://github.com/nicolasmanic/perses/wiki).