# cc.extend

> A javascript class creation and inheritance system.

Latest version **0.14.0** (published 2012-07-01) · 0 weekly downloads

## Install

```sh
npm install cc.extend
pnpm add cc.extend
yarn add cc.extend
bun add cc.extend
```

## 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.14.0 |
| Published | 2012-07-01 |
| First published | 2012-06-23 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.4.0 |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| Author | James Pike |
| Maintainers | jpike |

## Links

- npm: https://www.npmjs.com/package/cc.extend
- npm.io page: https://npm.io/package/cc.extend

## Dependencies (3)

- [cc.ake](https://npm.io/package/cc.ake.md) 0.5.0
- [cc.loader](https://npm.io/package/cc.loader.md) 1.2.1
- [coffee-script](https://npm.io/package/coffee-script.md) 1.3.3

## Recent versions

- 0.14.0 (latest) — 2012-07-01
- 0.13.0 — 2012-06-30
- 0.12.0 — 2012-06-27
- 0.11.3 — 2012-06-26
- 0.11.2 — 2012-06-26
- 0.11.0 — 2012-06-26
- 0.10.1 — 2012-06-26
- 0.10.0 — 2012-06-25
- 0.9.1 — 2012-06-25
- 0.9.0 — 2012-06-24
- 0.4.0 — 2012-06-23

## README

# cc.extend
A simple class creation system allowing methods, attributes and access to
super methods from classes.

# installation
To install globally:
```
sudo npm install -g cc.extend
```

# usage
## cc.extend - class inheritance
```javascript
var Animal = cc.extend(Function, {})
// same: var Animal = cc.Class.extend({})
```

## constructors and methods
cc.extend adds ".extend" as an instance method of the returned class which
can be used to simplify subclassing:
```javascript
var Cat = Animal.extend({
  init: function(name) {
    // init is called as a constructor
    console.log('cat')
  },
  talk: function(word) {
    console.log('hiss (' + word + ')')
  }
})
```

## attributes and calling super methods
"this.parent" can be used in a method to call the parent version of that method if it exists. Non-function values in an extend object become class attributes.
```javascript
var HouseCat = Cat.extend({
  type: 'friendly cat',
  talk: function(word) {
    console.log(this.type + ': meow')
    this.parent(word)
  }
})

// construction of the housecat will log 'cat'
var animal = new HouseCat,
    isTrue = (animal instanceof Animal)

animal.talk('mose') // logs "friendly cat: meow", "hiss(mose)"
```

## note on copying of attributes
When a new object is constructed all attributes of type Object are deep cloned from the prototype into the new object unless:
* They are HTML Elements.
* They are an instance of cc.Class.

Objects of the following class would be copied into attributes of newly constructed classes:
```javascript
var Animal = cc.extend(Function, { ... })
```

The following object would be referenced in attributes due to being an instance of cc.Class.
```javascript
var Animal = cc.Class.extend({ ... })
```

## using inject to modify a class in place
cc.extend returns a new child class whilst cc.inject can be used to modify a class. Inside of a method overridden with cc.inject, "this.parent" refers to the overridden method.
```javascript
// a class created with cc.extend also gets a static "inject" method.
HouseCat.inject({
  talk: function(word) {
    // call non-injected version of HouseCat.talk().
    this.parent(word)
    log('prr')
  }
}).inject({
  talk: function(word) {
    log('prr prr')
    this.parent(word) // call inject function defined above
  }
})

animal.talk('kit') // logs "prr prr", "friendly cat: meow", "hiss(kit)", "prr"
```

## using with cc.loader
```javascript
// file lib/project/Cat.js
// creates class accessible via "project.Cat"
cc.module('project.Cat').defines(function() {
  this.set(Class.extend({ ... }))
})
```

```javascript
// file lib/project/HouseCat.js
// requires lib/project/Cat.js file and sets project.Cat as parent of project.HouseCat
cc.module('HouseCat').parent('project.Cat').jClass({ ... })
```

# testing
```
% git clone git://github.com/nuisanceofcats/cc.extend.git
% cd cc.extend
% npm test
cc.extend test server listening on: 8013
please go to http://localhost:8013/
```

# faq
 * The API is a (mainly) compatible rewrite and extension of [ImpactJS' class system](http://impactjs.com/documentation/class-reference/class). The technical details are explained [here](http://blog.buymeasoda.com/understanding-john-resigs-simple-javascript-i).

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