Create new Julia packages, the easy way
Go to file
Chris de Graaf b3449ee272
Add a fetch ref to the remote, too
We can't add upstream remotes until the remote actually exists, it
seems. So that has to wait until we also create the upstream repo.
2019-10-22 19:24:19 +07:00
docs Add some custom template examples 2019-10-22 16:11:00 +07:00
src Add a fetch ref to the remote, too 2019-10-22 19:24:19 +07:00
templates Add DroneCI plugin for new PkgTemplates 2019-10-06 15:29:50 +07:00
test Update deps/fixtures, skip more tests when Git is not installed 2019-10-16 22:39:46 +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 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.