Skip to content
This repository has been archived by the owner on Sep 13, 2019. It is now read-only.

Commit

Permalink
Merge pull request #12 from Floofies/master
Browse files Browse the repository at this point in the history
Added full node and npm support, added contribution doc, reorganized readme
  • Loading branch information
Floofies authored Aug 27, 2017
2 parents 8072446 + 7f94aaf commit 5917570
Show file tree
Hide file tree
Showing 4 changed files with 61 additions and 25 deletions.
20 changes: 20 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# :pencil2: Contributing
## Pre-requisites
- `node`
- `make`

### Testing
> The makefile installs a local copy of `jasmine` to run tests.
**Node Tests**: `make test`

**Browser Tests**: Open `SpecRunner.html` in a web browser.

### Building
> The makefile installs a local copy of `uglify-es` for beautification/minification.
**Production Build**: `make prod`
Saves comment-less and minified versions of `src/differentia.js` into a `prod-build` directory.

### Clean Build/Test
Add `clean` at the end to remove `node_modules` afterwards.
39 changes: 17 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,16 @@
Differentia.js
===
An Object Algorithm Library for JavaScript.



---

# :page_facing_up: Supported Data Types
DataType|Clone|Diff
---|---|---
Function|:x:|:x:
Symbol|:x:|:x:
Blob|:x:|:x:
Object|:white_check_mark:|:white_check_mark:
Array|:white_check_mark:|:white_check_mark:
String|:white_check_mark:|:white_check_mark:
Number|:white_check_mark:|:white_check_mark:
Boolean|:white_check_mark:|:white_check_mark:
RegExp|:white_check_mark:|:white_check_mark:
---

# :closed_book: Documentation
Differentia.js provides a basic suite of Object/Array focused utilities. They are all "deep" algorithms, and fully traverse all child Objects/Arrays/properties unless given a search index object with specifies otherwise.
This library provides a basic suite of Object/Array focused functions. They are all "deep" algorithms, and fully traverse all child Objects/Arrays/properties unless given a search index object with specifies otherwise.

- Deep Object Cloning
- Deep Object Diffing
- Deep Freezing/Sealing
- Differential Deep Object Cloning
- A small compliment of higher-order functions.

---

# :closed_book: Documentation
## Functions
- [Main Functions](#main-functions)
- [iddfs](#iddfs)
Expand All @@ -43,6 +25,19 @@ Differentia.js provides a basic suite of Object/Array focused utilities. They ar
- [some](#some)
- [every](#every)

# :page_facing_up: Supported Data Types
DataType|Clone|Diff
---|---|---
Function|:x:|:x:
Symbol|:x:|:x:
Blob|:x:|:x:
Object|:white_check_mark:|:white_check_mark:
Array|:white_check_mark:|:white_check_mark:
String|:white_check_mark:|:white_check_mark:
Number|:white_check_mark:|:white_check_mark:
Boolean|:white_check_mark:|:white_check_mark:
RegExp|:white_check_mark:|:white_check_mark:

---

# Main Functions
Expand Down
2 changes: 1 addition & 1 deletion makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
noargs :
@printf "+------------------------------+\n| Differentia.js Build Options |\n+------------------------------+\-> Run Tests: 'make test'\n-> Production: 'make prod'\n-> Clean Build: 'make prod clean'\n"
@printf "+------------------------------+\n| Differentia.js Build Options |\n+------------------------------+\n-> Run Tests: 'make test'\n-> Production Build: 'make prod'\n-> Clean Build: 'make prod clean'\n"

node_modules/uglify-es/bin/uglifyjs :
@printf "Downloading uglifyjs from GitHub...\n"
Expand Down
25 changes: 23 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,31 @@
{
"name": "Differentia.js",
"name": "differentia",
"version": "1.0.2",
"description": "An Object Algorithm library for JavaScript",
"description": "An Object Algorithm library for JavaScript",
"keywords": [
"objects",
"diff",
"deep",
"library",
"higher-order-functions",
"iterator",
"graph-algorithms",
"clone",
"iddfs",
"traverse",
"search-algorithm",
"deepfreeze",
"deep-search",
"graph-theory",
"graph-search"
],
"homepage": "https://github.com/Floofies/Differentia.js#readme",
"repository": {
"type": "git",
"url": "https://github.com/Floofies/Differentia.js.git"
},
"bugs": {
"url": "https://github.com/Floofies/Differentia.js/issues"
},
"devDependencies": {
"jasmine": "^2.8.0",
Expand Down

0 comments on commit 5917570

Please sign in to comment.