Create new Julia packages, the easy way
Go to file
2019-12-17 13:35:53 +07:00
.github/workflows Add a TagBot plugin 2019-12-17 13:21:27 +07:00
docs Add a CompatHelper plugin 2019-12-17 13:21:27 +07:00
src Fix some typos, make CompatHelper a default plugin 2019-12-17 13:35:53 +07:00
templates Rework TagBot to fit the new options 2019-12-17 13:21:28 +07:00
test Fix some typos, make CompatHelper a default plugin 2019-12-17 13:35:53 +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 Drop 1.2 from CI 2019-12-17 12:15:00 +07:00
LICENSE Check and warn for unused keywords, update some metadata 2019-10-06 16:16:31 +07:00
Manifest.toml Freeze doc manifests in reference tests 2019-12-17 12:15:00 +07:00
Project.toml Correct verision string to indicate this is unreleased (#115) 2019-11-26 07:30:28 +07:00
README.md Add Notice to readme pointing to stable version (#114) 2019-11-27 18:43:11 +07:00

NOTICE: This version is not yet released

The current stable release is 0.6, you can find that version here.
PkgTemplates has undergone large internal changes (see #61 especially), and at present the user-facing API is still catching up.
Do not fear, while right now it looks very different (e.g. in the dev docs), it will not be incredibly breaking. But right now if you do use master it will be.


PkgTemplates

Stable Dev Build Status Codecov Code Style: Blue

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}(),
    ],
)

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