RESTFiddle

An Enterprise-grade API Management Tool for Teams. RESTFiddle helps you design, develop, test and release APIs.

Why RESTFiddle?

We all usually work as a team- be it software development or testing. What consumes most of your time while working in a group? Collaboration. You need to share stuff with your colleague. It is a painful exercise with a lot of limitations and doesn't work seamlessly.

How does RESTFiddle help you?

If you are developing or testing REST APIs, it will help you do that with ease. It will let a team or multiple teams work together effortlessly. You just have to focus on your APIs. Rest all is taken care by the tool.

Time is valuable, so productivity is important. We have crafted RESTFiddle to avoid you fiddling with sharing or collaboration work and increase your productivity!

How to Collaborate?

We are in the process of implementing access-control module which will give you the option to share workspace/project with others in which the whole team can work on a shared workspace.

Cloud support?

As the output of the build is a war file so it can be deployed over any server and can also be used as a cloud based hosted web application.

Initial Design

Building From Source

Prerequisites

• JDK 7 or later

• Maven 3.0+

• MySQL (optional)

Build

mvn clean install

Run

mvn spring-boot:run

Access

Default email / password : rf@example.com / rf

Debug

mvn spring-boot:run -Drun.jvmArguments="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000"

Note : To avoid java.lang.OutOfMemoryError: PermGen space, use the following command:

MAVEN_OPTS="-XX:PermSize=256m -XX:MaxPermSize=512m" mvn spring-boot:run 

MySQL configuration:

Go to src/main/resources/env-development.properties and update database url, username and password. Here is how the sample configuration looks like:

database.driver=com.mysql.jdbc.Driver

database.url=jdbc:mysql://localhost:3306/restfiddle

database.username=root

database.password=

To use Hsqldb as in-memory database, use the following configuration:

database.driver=org.hsqldb.jdbcDriver

database.url=jdbc:hsqldb:mem:restfiddle

database.username=sa

database.password=

Deployment

You can deploy the war file to Tomcat 7.0.52, Jetty, or any other container, as long as it supports servlet 3.0.

Technology Stack

• Spring (http://spring.io/)

• Hibernate (http://hibernate.org/)

• HttpComponents (http://hc.apache.org/)

• Logback (http://logback.qos.ch/)

• jQuery (http://jquery.com/)

• Bootstrap (http://getbootstrap.com/)

• Backbone (http://backbonejs.org/)

• MySQL (http://www.mysql.com/)

• Tomcat (http://tomcat.apache.org/)

Contribute

You're interested in contributing to RESTFiddle? AWESOME. Here are the basic steps:

• Make sure you have a GitHub Account
• Fork RESTFiddle from here : https://github.com/ranjan-rk/restfiddle/
• Clone your fork
• Make your changes
• Make sure everything is working fine
• Format your code (see below)
• Submit a pull request

Code formatting :

• If you're an Eclipse user, use the following code formatter : https://github.com/ranjan-rk/restfiddle/blob/master/tools/restfiddle_code_formatter.xml
• You should also activate automatic formatting and organizing imports on save.

GitHub help :

• Forking a repo - https://help.github.com/articles/fork-a-repo
• Creating a pull request - https://help.github.com/articles/creating-a-pull-request
• Syncing a fork - https://help.github.com/articles/syncing-a-fork

Google Group :

https://groups.google.com/forum/#!forum/restfiddle

Releases

https://github.com/ranjan-rk/restfiddle/releases

Copyright and License

Copyright 2014 Ranjan Kumar

Licensed under Apache License, Version 2.0