Create new Julia packages, the easy way
Go to file
Chris de Graaf 4d70635d3a
Add GitHubActions plugin for CI and docs
The docs deployment requires Documenter 0.24 but I'm assuming that
PkgTemplates 0.7 won't be released until after Documenter 0.24.
2019-11-10 11:15:55 +07:00
docs Add GitHubActions plugin for CI and docs 2019-11-10 11:15:55 +07:00
src Add GitHubActions plugin for CI and docs 2019-11-10 11:15:55 +07:00
templates Add GitHubActions plugin for CI and docs 2019-11-10 11:15:55 +07:00
test Add GitHubActions plugin for CI and docs 2019-11-10 11:15: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 Clean up Travis configs and temp name generation 2019-11-01 12:46:18 +07:00
LICENSE Check and warn for unused keywords, update some metadata 2019-10-06 16:16:31 +07:00
Manifest.toml Reduce line length of docstrings 2019-10-06 16:55:32 +07:00
Project.toml Check and warn for unused keywords, update some metadata 2019-10-06 16:16:31 +07:00
README.md Remove interactive stuff (for now) 2019-10-06 14:43:17 +07:00

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.