Create new Julia packages, the easy way
Go to file
2019-09-28 11:21:45 +07:00
docs Update docs with interactive stuff 2019-09-28 11:21:45 +07:00
src Update docs with interactive stuff 2019-09-28 11:21:45 +07:00
templates Add another set of reference tests, fix a bug they found 2019-09-28 10:31:55 +07:00
test Add another set of reference tests, fix a bug they found 2019-09-28 10:31:55 +07:00
.gitattributes More tests, more Windows fiddling 2019-09-26 00:32:04 +07:00
.gitignore Remove /docs/site from Documenter's gitignore 2019-09-26 10:42:03 +07:00
.travis.yml Lots of documentation changes 2019-09-26 00:32:05 +07:00
LICENSE Use METADATA-compatible UUIDs 2019-02-05 09:55:16 -06:00
Manifest.toml Add prehooks/posthooks for more fine-grained plugin control 2019-09-26 00:32:05 +07:00
Project.toml Add a compat entry for Mustache 2019-09-28 09:46:12 +07:00
README.md Improve documentation clarity 2019-09-26 00:32:07 +07:00

PkgTemplates

Stable Dev Build Status Codecov

PkgTemplates creates new Julia packages in an easy, repeatable, and customizable way.

Installation

Install with Pkg, just like any other registered Julia package:

pkg> add PkgTemplates  # Press ']' to enter te Pkg REPL mode.

Usage

Creating a Template is as simple as:

using PkgTemplates
t = Template()

The no-keywords constructor assumes the existence of some preexisting Git configuration (set with git config --global):

  • user.name: Your real name, e.g. John Smith.
  • user.email: Your email address, eg. john.smith@acme.corp.
  • github.user: Your GitHub username: e.g. john-smith.

Once you have a Template, use it to generate a package:

t("MyPkg")

However, it's probably desirable to customize the template to your liking with various options and plugins:

t = Template(;
    dir="~/code",
    plugins=[
        Git(; manifest=true, ssh=true),
        Codecov(),
        TravisCI(; x86=true),
        Documenter{TravisCI}(),
o    ],
)

You can also create a Template interactively by following a set of prompts:

julia> t = Template(; interactive=true)

For a much more detailled overview, please see the documentation.