damvitool

Introduction

This project was inspired by Sandman by Jeff Knupp. Damvitool improves on the original in a few important areas:

• Support for compound queries (on server side (REST API) and client side (UI))
• Extremely flexible and powerful UI (query builder wizard) thanks to SmartClient library by Isomorphic
• Support for column summaries
• Unlimited resulting grid (sorted&filtered) export to CSV file

Resources

• Run/edit damvitool in cloud IDE
• Documentation
• Bug tracker
• Demo
• Code

Frameworks and libraries used

• SQLAlchemy v0.9.8+
• Morepath v0.9+
• AngularJS v1.2.1+
• Isomorphic SmartClient v9.1+
• ng_isc v0.2+

Versioning

Semantic Versioning 2.0.0

Todo

• Ability to save queries
• Extended authorisation support with fine grained control of access to queries/tables
• Editing of records
• Charting engine for data visualization

Quick start

Installation

Use pip to install damvitool:

$ pip install damvitool

Run damvitool from command line:

$ damvitool

When you run damvitool from command line without parameters it connects by default to the demo Chinook Database for SQLite.

To connect to your legacy database run damvitool with your database URL as parameter, like so:

$ damvitool --database sqlite:///damvitool/data/Chinook_Sqlite.sqlite

where sqlite:///damvitool/data/Chinook_Sqlite.sqlite is database URL in SQLAlchemy format (http://docs.sqlalchemy.org/en/rel_0_9/core/engines.html#database-urls).

Admin panel access

Default admin panel URL is http://localhost:8080

Build new database request

1. Click Wizard button.

2. Login with the following credentials: user1/password1.

3. Choose root entity for your data query. If tables needed for your query don't have relations between them you can add another root entity to your query.

4. Choose relevant entities fields.
5. Set filter criteria.
6. View results.

Changelog

Version 0.2.0

• Move RESTful API from /proxy/* to /api/*
• Improved documentation
• Fix backend and frontend e2e tests