# light-traits

> Light traits in javascript with some syntax sugar.

Latest version **0.2.0** (published 2011-06-24) · 0 weekly downloads

## Install

```sh
npm install light-traits
pnpm add light-traits
yarn add light-traits
bun add light-traits
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2011-06-24 |
| First published | 2011-02-17 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.4.x |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 32 |
| Author | Irakli Gozalishvili |
| Keywords | traits |

## Links

- npm: https://www.npmjs.com/package/light-traits
- Repository: https://github.com/Gozala/light-traits
- Homepage: http://github.com/Gozala/light-traits/
- Issues: http://github.com/Gozala/light-traits/issues/
- npm.io page: https://npm.io/package/light-traits

## Recent versions

- 0.2.0 (latest) — 2011-06-24
- 0.1.1 — 2011-06-23
- 0.0.1 — 2011-02-17
- 0.0.2 — 2011-02-17
- 0.0.3 — 2011-02-17
- 0.0.4 — 2011-02-17
- 0.0.5 — 2011-02-17
- 0.0.6 — 2011-02-17
- 0.0.7 — 2011-02-17
- 0.0.8 — 2011-02-17
- 0.1.0 — 2011-02-17

## README

# light-traits #

Very light trait composition library for Javascript based on the new object
manipulation API defined in [Ecmascript-262, Edition 5](ES5)

## Install ##

    npm install selfish

## Require ##

    var Trait = require('https!raw.github.com/Gozala/light-traits/v0.2.0/light-traits.js').Trait

## Traits ##

Traits are a flexible language feature to factor out and recombine reusable
pieces of code. They are a more robust alternative to multiple inheritance or
mixins. They are more robust because name clashes must be resolved explicitly
by composers, and because trait composition is order-independent (hence more
declarative). To put it simply: if you combine two traits that define a method
with the same name, your program will fail. Traits won't automatically give
precedence to either one.

## Light Traits ##

This library is inspired by an awesome [traitsjs] and pretty much follows it's
design with a few slight differences:

### Lighter ###

This implementation is more optimal in terms of object instantiation speed and
memory footprint. This is achieved by not binding `this` pseudo variable in all
accessors and methods of the composed object to an instance, which allows
shared functions across objects, it also matches better overall behavior of the
language. _(BTW Similar can be achieved in traitjs as well in which case the
claim of being more optimal will not longer be true, it's just not a default
behavior at least not yet :)_

### Better ergonomics ###

This is a big statement and maybe not entirely correct but, few API differences
makes working with traits less verbose and there for more pleasant. See
examples section to find a difference.

### Ecmascript 5 shims are not included ###

If your JavaScript engine does not comes with all the shiny [Ecmascript 5][ES5]
features this library is not going to work, luckily there are other libraries
that shim JavaScript engines so that might be an option to go with.

## Examples ##
<a href="https://www.runnable.com/#gozala/light-traits/app.js/launch" target="_blank"><img src="https://www.runnable.com/external/styles/assets/runnablebtn.png" style="width:67px;height:25px;"></a>  

    var Trait = require('https!raw.github.com/Gozala/light-traits/v0.2.0/light-traits.js').Trait
      function ColorTrait(color) {
        return Trait({ color: function() { return color } })
      }
      var pointTrait = Trait.compose(
        ColorTrait('red'), // a color trait
        Trait({
          _x: Trait.required,
          _y: Trait.required,
          get x() { return this._x },
          get y() { return this._y },
          toString: function toString() { return '' + this.x + '@' + this.y }
        })
      )
      function Point(x, y) {
        // result inherits from object being passed to create
        return pointTrait.create({ _x: x, _y: y })
      }
      var point = Point(1, 7)
      point.color() // -> 'red'
      point.toString() // -> 1@7

[traitsjs]:http://www.traitsjs.org/
[ES5]:http://www.ecma-international.org/publications/standards/Ecma-262.htm

---
_Source: https://npm.io/package/light-traits · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._