https://github.com/aaemnnosttv/purity

A conflict-free utility library.
https://github.com/aaemnnosttv/purity

Last synced: 1 day ago
JSON representation

A conflict-free utility library.

• Host: GitHub
• URL: https://github.com/aaemnnosttv/purity
• Owner: aaemnnosttv
• Created: 2018-09-08T20:04:06.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-10T07:07:12.000Z (about 6 years ago)
• Last Synced: 2024-04-13T05:00:29.639Z (6 months ago)
• Language: PHP
• Size: 14.6 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# purity

A conflict-free utility library.

[![Build Status](https://travis-ci.org/aaemnnosttv/purity.svg?branch=master)](https://travis-ci.org/aaemnnosttv/purity)

## Overview

Purity is an experimental library aimed at providing utility functions and classes without the risk of conflicting with any other dependencies (including itself).

This is accomplished primarily by composing the entire codebase with anonymous functions and classes. 

Combined with a simple file-based structure, utilities can be easily accessed by name, without leaving any footprint on any namespace.

## Basic Usage

Because the API is exposed through anonymous components, autoloading via Composer is not possible.

Instead, all components are made available through a Factory which is retrieved by `factory.php`.

```php

# ./ current directory

# ./purity/

$factory = include 'purity/factory.php';

```

From here you can retrieve a component by accessing it as a property, or calling it as a method.

```php

$each = $factory->each;

$each($iterable, function ($item) {

    // do something

});

// OR

$factory->each($iterable, function ($item) {

    // do something

});

```

## Reference Safety

Each instance returned from the factory is a copy of its source, no two are the same.

That means...

```php

$factory->each !== $factory->each

```