Skip to main content

A build tool that builds apps in multiple languages

Project description

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/java

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.13"
    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:

  1. deps: Resolve, download and verify dependencies.
  2. compile: Compile application and test code for compiled languages.
  3. unit-test: Run unit tests.
  4. package: Package the jar or the war or the pip or the gem or the rpm or the docker image.
  5. deploy: Spin up necessary environment, and deploy the necessary components and apps.
  6. functional-test: Run functional tests on the deployed app.

As stand-alone tools

Each Power Daps target comes as a stand-alone command:

  1. dap-create
  2. dap-deps
  3. dap-compile
  4. dap-unit-test
  5. dap-package
  6. dap-deploy
  7. dap-functional-test

Appendix

Complete target tree:

  • all or default or if you omit a target
    • deps
      • resolve-deps
      • download-deps
      • verify-deps
    • validate
    • compile
      • compile-app
      • compile-test
    • unit-test
    • package or jar or war
    • 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

power-daps-0.0.6.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

power_daps-0.0.6-py3-none-any.whl (3.4 kB view details)

Uploaded Python 3

File details

Details for the file power-daps-0.0.6.tar.gz.

File metadata

  • Download URL: power-daps-0.0.6.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5

File hashes

Hashes for power-daps-0.0.6.tar.gz
Algorithm Hash digest
SHA256 202e6606c7c0a713548da372bc0b333e6b36306232223ca50949365c66abbe6a
MD5 a7142fcb7743b4ee7fbc968d6175a4d2
BLAKE2b-256 90e6d030aac871f291b606b62719d27873b38792b548fbfe470406571862bd4e

See more details on using hashes here.

File details

Details for the file power_daps-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: power_daps-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 3.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5

File hashes

Hashes for power_daps-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 eaad9aa117e1ecd45d3fd1884d31581dd4645f9f2005f45f681a687ccfb427db
MD5 f73525bec3c7df01920532db48fd799d
BLAKE2b-256 9ba7c7f2b74da115203c9696d96009c137c5c1019ae7f7c441a9be75638c0f56

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page