Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rootslab/peela
Peela, a tiny (LIFO) stack.
https://github.com/rootslab/peela
lifo stack
Last synced: 8 days ago
JSON representation
Peela, a tiny (LIFO) stack.
- Host: GitHub
- URL: https://github.com/rootslab/peela
- Owner: rootslab
- License: mit
- Created: 2014-04-26T02:50:20.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-02-10T14:41:11.000Z (almost 7 years ago)
- Last Synced: 2024-10-26T22:19:23.996Z (about 2 months ago)
- Topics: lifo, stack
- Language: JavaScript
- Size: 23.4 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
### Peela
[](https://www.npmjs.org/package/peela)
[](https://www.codacy.com/public/44gatti/peela)
[](https://codeclimate.com/github/rootslab/peela)
[](https://github.com/rootslab/peela#mit-license)
[](http://travis-ci.org/rootslab/peela)
[](https://david-dm.org/rootslab/peela)
[](https://david-dm.org/rootslab/peela#info=devDependencies)
[](http://npm-stat.com/charts.html?package=peela)
[](https://nodei.co/npm/peela/)
> **_Peela_**, a tiny (LIFO) **Stack**.
> If you need a fast (FIFO) __Queue__, try __[Train](https://github.com/rootslab/train)__.
### Install
```bash
$ npm install peela [-g]
// clone repo
$ git clone [email protected]:rootslab/peela.git
```
> __require__
```javascript
var Peela = require( 'peela' );
```
> See [examples](example/).
### Run Tests
```bash
$ cd peela/
$ npm test
```
### Constructor
> Create an instance, optionally with an Array of elements.
```javascript
Peela( [ Array elements ] )
// or
new Peela( [ Array elements ] )
```
### Properties
```javascript
// an array representing the stack.
Peela.stack : Array
```
### Methods
> Arguments within [ ] are optional.
```javascript
/*
* Push one or multiple objects into the stack. it uses
* the same signature as Array#push.
* It returns the current number of items.
*/
Peela#push( [ Object obj1 [, Object obj2 .. ] ] ) : Number
/*
* Concatenate an Array to the stack head, optionally reversing it
* before the operation.
* It returns the current Peela instance.
*
* NOTE: It accepts a single argument, that could be also
* a generic element.
* NOTE: the action of reversing the array to concatenate, could be
* useful if you want to re-push ( previously popped ) K items into
* the stack, for example, try:
* var p = Peela( [ 0, 1, 2, 3, 4 ] );
* p.concat( p.pop( 3 ), true )
*/
Peela#concat( [ Array array [, Boolean reverse ] ] ) : Peela
/*
* Evict one or multiple elements, if a number k was specified,
* it returns an array of K elements, with K <= k.
* If k > size(), all elements are returned.
*
* NOTE: #pop() a single element from the stack, it does not
* return an Array, but the element itself.
* NOTE: For popping all elements you could also do Peela#pop( Infinity )
*/
Peela#pop( [ Number k ] ) : Array
/*
* Get the head element or an element at a certain index.
*/
Peela#head( [ Number index ] ) : Object
/*
* Get an element starting from the tail.
*/
Peela#tail( [ Number index ] ) : Object
/*
* Get the stack size.
*/
Peela#size() : Number
/*
* Return the index of an element in the stack, optionally
* starting the search from an offset index.
* If element was not found, it returns -1.
*/
Peela#indexOf( Object el [, Number offset ] ) : Object
/*
* Empty the stack for default.
* If bool is set to false, no action will be done.
* It returns the number of elements evicted.
*/
Peela#flush( [ Boolean bool ] ) : Number
```
------------------------------------------------------------------------
### MIT License
> Copyright (c) 2013-present < Guglielmo Ferri : [email protected] >
> Permission is hereby granted, free of charge, to any person obtaining
> a copy of this software and associated documentation files (the
> 'Software'), to deal in the Software without restriction, including
> without limitation the rights to use, copy, modify, merge, publish,
> distribute, sublicense, and/or sell copies of the Software, and to
> permit persons to whom the Software is furnished to do so, subject to
> the following conditions:
> __The above copyright notice and this permission notice shall be
> included in all copies or substantial portions of the Software.__
> THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
> EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
> MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
> IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
> CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
> TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
> SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.