Giter VIP home page Giter VIP logo

dynamicreports-documentation's Introduction

Master

Build Status codecov

Development

Build Status codecov

Dynamic Reports

DynamicReports is an open source Java reporting library based on JasperReports. It allows to create dynamic report designs and it doesn't need a visual report designer. You can very quickly create reports and produce documents that can be displayed, printed or exported into many popular formats such as PDF, Excel, Word and others.

The original source code was first hosted on sourceforge and interactions were carried out through [dynamicreports.org]. After using this project and libraries, we the maintainers felt compelled to support the development for it has been a great tool. However the source code has not been easily accessible and the original hosting website on which this project was first created is no longer responsive and we do not want to see a great project go down and disappear like that.

Project Goals

This project aims to maintain the original source code of the same using familiar tools, like maven in a way that is accessible to allow contributions. It is based on version 5.1.0 of dynamic reports and Jasper Reports version 6.5.1. We are not trying to rewrite the whole thing, but rather to enhance that which is a already a great work.

These are the main goals of the project

  • Make the source code easily accessible and assessable
  • Enhance the build tools. Not to replace maven, but to make it possible to rebuild the project and all artifacts from a local machine
  • Upgrade dependencies. The project works, but could still have more features, one was to include latest open source tools available
  • In order to support the former, we need to first increase out test coverage to make sure nothing breaks
  • Create a wiki with comprehensive explanations and illustrations on the usage of the library
  • Enhance the documentation in the source code that would make the user clear on what the library is trying to do

Documentation

DynamicReprots documentation available at Readthedocs

Project API documentation

Project Dependencies

A few tools merit to be mentioned:

  • Java version 8
  • Versioning : git
  • Build Tool : maven
  • CI : Travis (yet to fully setup)
  • Code style: google. Enforced by checkstyle. (Setting that up too)
  • Documentation Hosting: readthedocs.org

Usage or Build

DynamicReports is synchronized with a Maven central repository. For Maven projects you just add dependency to your maven configuration. In case you would like to use a development version, add a Sonatype Nexus snapshot repository to your maven configuration.

Maven

Core module

<dependency>
    <groupId>net.sourceforge.dynamicreports</groupId>
    <artifactId>dynamicreports-core</artifactId>
    <version>6.12.0</version>
</dependency>

AdHoc module

<dependency>
    <groupId>net.sourceforge.dynamicreports</groupId>
    <artifactId>dynamicreports-adhoc</artifactId>
    <version>6.12.0</version>
</dependency>

Google Chart addon module

<dependency>
    <groupId>net.sourceforge.dynamicreports</groupId>
    <artifactId>dynamicreports-googlecharts</artifactId>
    <version>6.12.0</version>
</dependency>

For non Maven projects you can to download jar file from maven repository

Build from source

Check release page to download source release files.

Unzip the souces, execute mvnw clean install from project root directory. This compile project sources and create project jar files.

Contributing

See CONTRIBUTING

Raising Issues or bug reports

Before submitting a bug report see this checklist and be sure to follow this approach with as many details as possible. and fill out the issue template

Rules for Mergeable PRs

This is a young project and we would like it to continue to grow, and because of that, kindly be gentle and understanding when it seems like the maintainers are just making stuff up as they go:

  • The travis build must run successfully.
  • The PR must have test cases and must not reduce the code coverage (That needs to be setup)
  • The PR adheres to the template provided
  • Watch this space :)

dynamicreports-documentation's People

Contributors

jan-moxter avatar srbala avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

dynamicreports-documentation's Issues

Hosting API documentation

@jan-moxter @ghacupha create a new repository apidocs or dynamicreports.github.io to host API documentations. We can make use of github hosting of gh-pages.

Please add me the organisation, I am ready to do the setup and configuraitons

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.