Create new Julia packages, the easy way
Go to file
Chris de Graaf 765d2db0e6
Version + license bump
2020-05-28 09:49:13 -05:00
.github/workflows Default to running TagBot daily (#154) 2020-04-17 15:45:06 -05:00
docs Interactive mode (#145) 2020-05-25 15:20:27 -05:00
src Document Documenter{GithubActions} and add it to interactive mode (#178) 2020-05-28 09:37:41 -05:00
templates Use Julia 1.x for doc builds on Travis and GHA (#174) 2020-05-27 15:17:25 -05:00
test Use Julia 1.x for doc builds on Travis and GHA (#174) 2020-05-27 15:17:25 -05:00
.gitattributes More tests, more Windows fiddling 2019-09-26 00:32:04 +07:00
.gitignore Interactive mode (#145) 2020-05-25 15:20:27 -05:00
.travis.yml Update version to 0.7.0 (#171) 2020-05-25 18:16:51 -05:00
LICENSE Version + license bump 2020-05-28 09:49:13 -05:00
Project.toml Version + license bump 2020-05-28 09:49:13 -05:00
README.md Remove unreleased notice from README 2020-05-25 18:22:09 -05:00

README.md

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 the 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.

Contributing

Issues and pull requests are welcome! For some more specific tips, see the developer documentation.