Welcome to power-daps
About
power-daps is a build tool that can build apps in multiple languages. It also has templates to speed up creation of "hello world" apps in different languages. It has a plugin architecture which allows people to add support for more languages and styles easily.
Installation
Across platforms with Python 3
pip3 install power-daps
Mac OS (not yet supported)
brew install power-daps
CentOS or RedHat (not yet supported)
yum install power-daps
Ubuntu or Debian (not yet supported)
apt-get install power-daps
Usage (currently)
Create a new app
Specify the type of app by specifying which meta model you want to use.
Meta models can be specified by the --meta-model
or -m
flag
Few built-in meta models are provided with power-daps: Java, Python 3, ES 6 and Rust. Here is how you initialize apps with dap in these languages.
Java
dap init --meta-model power_daps/java9
Python
dap init --meta-model power_daps/python3
ECMA Script
dap init --meta-model power_daps/es6
Rust
dap init --meta-model power_daps/rust
Build the app
If you have initialized the application with dap init
, then just dap
will do what is needed
by looking at actions.yml
at the root of your project. However, you can use the following commands
depending on the language:
-
dap deps
to install dependencies -
dap compile
if your language requires compiling dap compile_test
dap unit_test
dap package
Adding dependencies
Edit dependencies.yml at the root level of your project and add dependencies. 'default' here will eventually be 'run' or 'test' etc depending the scope of the dependency. A given app can have dependencies using different package managers. For example, sometimes you may want something that is installed using 'brew_cask' in a python app.
Examples:
Java
default:
junit:
version: "4.12"
installer: jar
group_id: junit
Python
default:
pyyaml:
version: 5.3
installer: pip3
ES6
default:
bulma:
version: latest
installer: npm
Cargo / Rust
default:
ripgrep:
version: latest
installer: cargo
Usage (eventually)
As a suite of tools
Creating something new
dap create suite
dap create app <app-name>
dap create data-source <app-name>/<data-source-name>[:<data-source-type>]
where <data-source-type>
is postgres
, mysql
, oracle
, mongodb
, cassandra
, csv-fetch
etc.
Working with existing application suites
The basic structure for using dap is: dap <target>
. This will run all preceding targets in the chain, unless you tell it to only run that target by running dap only <target>
. Only targets that need to run will run unless you force it by running dap force <target>
. If you only want to force one target, run dap force only <target>
.
The following targets are provided by default for Java development:
-
deps
: Resolve, download and verify dependencies. -
compile
: Compile application and test code for compiled languages. -
unit-test
: Run unit tests. -
package
: Package the jar or the war or the pip or the gem or the rpm or the docker image. -
deploy
: Spin up necessary environment, and deploy the necessary components and apps. -
functional-test
: Run functional tests on the deployed app.
As stand-alone tools
Each Power Daps target comes as a stand-alone command:
dap-create
dap-deps
dap-compile
dap-unit-test
dap-package
dap-deploy
dap-functional-test
Appendix
Complete target tree:
-
all
ordefault
or if you omit a target-
deps
resolve-deps
download-deps
verify-deps
validate
-
compile
compile-app
compile-test
unit-test
-
package
orjar
orwar
-
deploy
-
deploy-machines
check-machines
stop-machines
clean-machines
start-machines
deploy-dependencies
-
load-data
check-data-stores
clean-data-stores
create-schema
populate-data
migrate-schema
migrate-data
-
component-test
contract-test
integration-test
functional-test
-
Details of what happens when creating a new application suite
Create a new suite by running dap create suite [dir]
. This will create the following directory structure in the current directory or the specified directory:
apps
bin
dashboard
env
-
test
integration-test
functional-test
Details of what happens when creating a new application in the current suite
dap create app <name>
will create the following structure under the <name>
directory under apps
:
config
identity
data
-
sources
-
sample-rdbms
-
schema-migrations
000-initial-schema.sql
-
data-migrations
000-000-initial-data.sql
-
-
src
-
test
unit-test
component-test
contract-test
Creating a data source for an app
dap create data-source <app-name>/<data-source-name>[:<data-source-type>]
where <data-source-type>
is postgres
, mysql
, oracle
, mongodb
, cassandra
, csv-fetch
etc.
csv-fetch
will allow you to setup a periodic sftp download of CSV files from multiple sources and load them into a particular location accessible to the application.
License
Power Daps is released under GNU Public License v3.0
Copyright
Copyright © 2016, Prasanna Pendse