fedorenkosergiy/grabli

A bunch of solutions and ideas for Unity3d

Grabli

Grabli is a bunch of solutions and ideas for Unity3d. All the code are under MIT license. The main purpose of this project is to share solutions for everyday tasks and gather feedback. And of course, all the ideas about how to make this code better, more stable and more flexible are welcome.

Releases

There are no releases yet

Content

Pools

This solution provides pools for generic list objects. For example, if you create a List object each frame you can avoid additional allocation by using ListPool.Get() and ListPool.Release() methods. One more case - StringBuilder. You can reuse string builder objects with StringBuilderPool solution.

Extensions

This section contains a lot of extension methods that can make your code easier to read. For example, ObjectEx is an extension class for object. It contains such methods as object.Is(), object.IsNull(). StringEx contains such method as string.IsSmth() which means that string instance is not null and is not empty.

Utils

This section contains useful algorigthms. For example Checksum class calculates a checksum of an object including all the references it has. So, you can use it for tracking changes.

WrappedUnity

Here is a wrapper around Unity3d API which makes your code coverable by unit tests. For example, the wrapper for UnityEngine.Time makes possible mocking it and using fake implementations for performing unit tests.

Installation

This repository follows Unity3d package layout convention. It means, you can import it into your project as a package. Also, you can attach it to your project as a git submodule.

Install through the package manager

1. Prepare the repository URL. You need to select one according to your purpose.

• For fetching the latest release

https://github.com/fedorenkosergiy/Grabli.git

• For fetching the specific version. Where x.y.z is a version. For example, 0.0.1.

https://github.com/fedorenkosergiy/Grabli.git#x.y.z

• For fetching the latest commit of the development branch

https://github.com/fedorenkosergiy/Grabli.git#develop

2. Open the package manager. Use menu item Window->Package Manager
3. Click on + button. And select a context menu item Add package from git URL...

4. Paste the repository URL into the appeared text field. And press Add

In case you want to know better all the details of installing a package from git URL you can visit a Unity3d manual page

Install as a git submodule

Install dependencies

Moq

Grabli uses Moq framework to perform unit tests. You have to install it to be able running all the tests in your project. Here is an awesome tutorial that will help you to install Moq framework.