Metadata-Version: 2.1
Name: create_unity_package
Version: 1.0.4
Summary: CLI tool for generating boilerplate Unity packages
Home-page: https://github.com/ShiJbey/create_unity_package
Author: Shi Johnson-Bey
Author-email: shijbey@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/ShiJbey/create_unity_package/issues
Keywords: unity 3d,unity,automation,cli
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Games/Entertainment
Classifier: Typing :: Typed
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

<h1 align="center">
  <img
    width="64"
    height="64"
    src="https://user-images.githubusercontent.com/11076525/190913978-f17fed38-e1d1-4a3c-9547-9d685b9e4a13.png"
  >
  Create Unity Package
</h1>

<p align="center">
  <img src="https://img.shields.io/pypi/dm/create-unity-package">
  <img src="https://img.shields.io/pypi/l/create-unity-package">
  <img src="https://img.shields.io/pypi/v/create-unity-package">
</p>

This is a simple command line tool that automates the creation of
Unity packages. It creates the boilerplate package structure and
inserts user-specific information. This package is inspired by
other developer CLI tools such as CreateReactApp.

This application follows the instructions offered by
[Unity](https://docs.unity3d.com/Manual/CustomPackages.html). It
creates new local packages in the directory that the application
is run.

Please file any issues for bugs or desired features.
Good luck with your development!

## Usage

### How to install

This tool is Python-based. So, you will need to install Python 3 if you
don't already have it installed.

**Option #1**: Install from Pip: `pip install create_unity_package`

**Option #2**: Install from GitHub: `pip install git+https://github.com/ShiJbey/create_unity_package.git`

### How to create a new Unity Package

Run the following command in a terminal and answer the prompts: `create-unity-package`

By default, this creates a new folder with the unique package
name entered during the prompts. If you would like to name the
folder differently, you can change the folder name afterward or
use the `--output` argument when generating the package. For more
help use the `--help`.

```
create-unity-package --output <YourPackageName>
```

In your current working directory it will create a new package
directory with the name of your package. The directory structure
of the package is shown below. Your package will be ready to import
and configured for editor scripts, runtime scripts like MonoBehaviours,
and UnityTestRunner tests.

```
<root>
  ├── package.json
  ├── README.md
  ├── CHANGELOG.md
  ├── LICENSE.md  # Defaults to MIT License
  ├── .gitignore  # If --git is used
  ├── Third Party Notices.md
  ├── Editor
  │   ├── [company-name].[package-name].Editor.asmdef
  ├── Runtime
  │   ├── [company-name].[package-name].asmdef
  ├── Tests
  │   ├── Editor
  │   │   ├── [company-name].[package-name].Editor.Tests.asmdef
  │   └── Runtime
  │        ├── [company-name].[package-name].Tests.asmdef
  ├── Samples~
  │        └── [empty]
  └── Documentation~
       └── [package-name].md
```

### How to import and edit package in Unity

Unity has detailed instructions for developing a local package.
You can instructions for installing a local package
[here](https://docs.unity3d.com/Manual/upm-ui-local.html).

Now you should see the your package name in the `Packages` directory
in Unity's file explorer.
