Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kalkin/ddt

Distribution Development Tool for the Perl 6 Programming Language
https://github.com/kalkin/ddt

authoring-tool command-line developer-tools development-tools module-development perl6 testing utility

Last synced: about 1 month ago
JSON representation

Distribution Development Tool for the Perl 6 Programming Language

Host: GitHub
URL: https://github.com/kalkin/ddt
Owner: kalkin
License: artistic-2.0
Archived: true
Created: 2017-01-15T14:19:30.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2022-11-05T01:16:40.000Z (about 2 years ago)
Last Synced: 2024-09-27T06:40:35.911Z (about 1 month ago)
Topics: authoring-tool, command-line, developer-tools, development-tools, module-development, perl6, testing, utility
Language: Raku
Homepage:
Size: 239 KB
Stars: 10
Watchers: 4
Forks: 4
Open Issues: 8
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        NAME

====

Ddt - Distribution Development Tool

SYNOPSIS

========

    $ ddt --license-name=LGPL new Foo::Bar # create Foo-Bar distribution

    $ cd Foo-Bar

    $ ddt build        # build the distribution and re-generate

                       # README.md & META6.json

    $ ddt -C test      # Run tests when files change

DESCRIPTION

===========

**Ddt** is an authoring and distribution development tool for Raku. It provides scaffolding for generating new distributions, packages, modules, grammers, classes and roles.

WARNING

=======

This project is a technology preview. It may change at any point. The only API which can be considered stable up to the `v1.0` is the command line interface.

USAGE

=====

    ddt [--license-name=«NAME»] new  -- Create new module

    ddt build                                -- Build the distribution and

                                                update README.md

    ddt [-C|--continues] test [ …]    -- Run distribution tests

    ddt release                              -- Make release

    ddt hack  []              -- Checkout a Distribution and

                                                start hacking on it

    ddt generate class                 -- Generate a class

    ddt generate role                  -- Generate a role

    ddt generate package               -- Generate a package

    ddt generate grammar               -- Generate a grammar

    ddt generate module                -- Generate a module

    ddt generate test  [] -- Generate stub test file

    ddt [-v] deps distri                     -- Show all the modules used

    ddt [-u|--update] deps                   -- Update META6.json dependencies

    ddt watch […]                       -- Watch lib/, bin/ & t/ for

                                                changes respecting .gitignore

                                                and execute given cmd

INSTALLATION

============

    # with zef

    > zef install Ddt

Differences to Mi6

==================

  * Support for different licenses via `License::Software`

  * META6 is generated using `META6`

  * Meta test

  * Use prove for tests

  * Run tests on changes

  * Extended .gitignore

  * Support for different licenses

  * Support for Distributions with a hyphen in the name

FAQ

===

  * How can I manage depends, build-depends, test-depends?

Use `ddt -u deps`

  * Where is the spec of META6.json?

The documentation site describes the current practices pretty well at [https://docs.raku.org/language/modules#Distributing_modules](https://docs.raku.org/language/modules#Distributing_modules). The original design document of META6.json is available at [http://design.perl6.org/S22.html](http://design.perl6.org/S22.html).

  * How do I remove the travis badge?

Remove .travis.yml

SEE ALSO

========

  * [https://github.com/skaji/mi6](https://github.com/skaji/mi6)

  * [https://github.com/tokuhirom/Minilla](https://github.com/tokuhirom/Minilla)

  * [https://github.com/rjbs/Dist-Zilla](https://github.com/rjbs/Dist-Zilla)

AUTHOR

======

  * Bahtiar `kalkin-` Gadimov 

  * Shoichi Kaji 

COPYRIGHT AND LICENSE

=====================

  * Copyright © 2015 Shoichi Kaji

  * Copyright © 2016-2017 Bahtiar `kalkin-` Gadimov

This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.