https://github.com/jonnyzzz/named-java-frames

Java Library to include text messages into stack traces
https://github.com/jonnyzzz/named-java-frames

Last synced: 15 days ago
JSON representation

Java Library to include text messages into stack traces

• Host: GitHub
• URL: https://github.com/jonnyzzz/named-java-frames
• Owner: jonnyzzz
• License: mit
• Created: 2014-04-19T22:28:59.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2019-10-25T08:00:22.000Z (about 5 years ago)
• Last Synced: 2024-10-04T16:29:34.139Z (about 1 month ago)
• Language: Java
• Size: 188 KB
• Stars: 12
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
[ ![Download](https://api.bintray.com/packages/jonnyzzz/maven/named-frames/images/download.svg) ](https://bintray.com/jonnyzzz/maven/named-frames/_latestVersion) [ ![Build Status](https://travis-ci.org/jonnyzzz/named-java-frames.svg?branch=master)](https://travis-ci.org/jonnyzzz/named-java-frames)

named-frames

============

This is a tiny java library to include any text messages

into Java stack traces.

For example, one needs to include the message ```this is my named frame```

into the application stacktrace. The resulting stacktrace should be the

following:

        java.lang.Exception

        	at com.some.corp.something.Object.run

        	at _.this is my named frame._(JavaGeneratorTemplate.java:24)

        	at com.some.corp.something.toTheJob(SomeSource.java:50)

This is done via the following code with the library

        NamedStackFrame.global().forName("YOUR NAME").run(() -> 

                //the code is called from a method with YOUR NAME in the full name

        });

There could be a number of nice use-cases for the library, for example

- include product version on each stack trace

- include heavy task details into the stack

- and much more!

For more details, see the related [blog post](http://blog.jonnyzzz.name/2014/04/named-stack-frames-for-jvm.html)

Dependencies

------------

The library does not have any non-optional dependencies to allow it

to be widely used without dependencies resolution hell

License

-------

*MIT License*

For more details, see LICENSE.txt in the repository

Building

--------

The project is build with gradle

Binaries

--------

[ ![Download](https://api.bintray.com/packages/jonnyzzz/maven/named-frames/images/download.svg) ](https://bintray.com/jonnyzzz/maven/named-frames/_latestVersion) 

Binaries are uploaded to *jcenter*

Gradle: just add

```

repositories {

  jcenter()

}

dependencies {

  compile 'org.jonnyzzz.named-frames:named-frames:'

}

```

See [here](https://bintray.com/jonnyzzz/maven/named-frames) for more details

Please note, the `0.1.x` version is not compatible to `0.2.x` version!

Note

====

This is my (Eugene Petrenko) private home project