Skip to content
This repository has been archived by the owner on Oct 18, 2022. It is now read-only.

nusex/nusex

Repository files navigation

nusex

PyPi version PyPI - Status Downloads GitHub last commit License

CI Read the Docs Maintainability Test Coverage

A dynamic, multi-language project templating utility.

CPython versions 3.6 through 3.11-dev and PyPy versions 3.6 through 3.8 are officially supported.

Windows, MacOS, and Linux are all supported.

Features

  • An easy-to-use CLI (command-line interface)
  • Dynamic templating using placeholder variables
  • Template add-ons for use during the whole development lifecycle
  • A profile system for those who maintain personal and organisation-owned projects
  • Automatic dependency installation
  • Premade templates for applications and packages
  • No dependencies!

Installation

You need Python 3.6.0 or greater to run nusex.

To install the latest stable version of nusex, use the following command:

pip install nusex

You can also install the latest development version using the following command:

pip install git+https://github.com/nusex/nusex

You may need to prefix these commands with a call to the Python interpreter depending on your OS and Python configuration.

Quickstart

Before you can build and deploy templates with nusex, you need to initialise it. You only need to do this once, and not for every new project. To initialise nusex, use the following command:

nusex init

Some premade templates will be downloaded for you to experiment with. You can deploy these templates with the following command(s):

# For general applications
nusex deploy nsx_simple_app

# For PyPI packages
nusex deploy nsx_simple_pkg

To learn how to build templates of your own, read the documentation.

Contributing

nusex is open to contributions. To find out where to get started, have a look at the contributing guide.

License

The nusex module for Python is licensed under the BSD 3-Clause License.