2017 © Pedro Peláez
 

library axiom

A set of interfaces & classes for creating domain driven projects.

image

enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  • Sunday, April 3, 2016
  • by r3oath
  • Repository
  • 2 Watchers
  • 11 Stars
  • 31 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 19 Versions
  • 0 % Grown

The README.md

, (*1)

Build Status Coverage Status Scrutinizer Code Quality, (*2)

Axiom is a collection of PHP PSR-2 compliant interfaces and classes designed to help you flesh out domain driven projects. Sticking to a framework like Axiom will help keep all your projects consistent in their layout, design and implementation, hopefully making your job (and others working on your code) easier., (*3)

Installation

composer require enzyme/axiom

What's included

Atoms

Atoms are wrappers around native php variable types such as int and string. They are used when a service or class expects one of these values and doesn't want to litter the code with type checks such as if (is_string($var)) {...}., (*4)

Bags

Bags are used to carry data around the system, whether from the user, an API or an external service., (*5)

Exceptions

These exceptions are thrown by the collection of concrete classes included when internal errors occur., (*6)

Factories

A factory is responsible for the creation and modification of models. It has intimate knowledge of how a model is built and the various attributes it acquires., (*7)

Models

Models represent objects in your domain. They are unique, have a set of attributes and are the primary resource of your application., (*8)

Recipients

Recipients are parts of your system that require knowledge of when a model is either successfully or unsuccessfully created, updated or destroyed after they have initiated a command., (*9)

Reports

Reports are containers that carry a message and optional details associated with the outcome of some event or action in your domain. For example, when a model failed to be created, a FailureReport can be returned with the details of what went wrong., (*10)

Repositories

Repositories are model collections that allow the system to store and retrieve models from an underlying persistence layer., (*11)

Concrete classes

There are a couple concrete classes included with Axiom that you can use straight out of the box. These are:, (*12)

Atoms

  • IntegerAtom - represents an integer value. This does not include floats.
  • StringAtom - represents a string, either empty or of any size.

Bags

  • ArrayBag - simply stores a collection of key/value pairs using an internal native array.

Reports

  • SimpleReport - provides a basic report implementation that stores a message and optional details.
  • FailureReport - extends the simple report and is purely a more readable means of reporting a failure.

Repositories

  • InMemoryRepository - stores a collection of models in-memory using a simple array.

Generators

Axiom comes with a set of command line generators for quickly creating skeleton implementations of the various interfaces included., (*13)

To use the command line tool, run it from the console at the root of your project as:, (*14)

php vendor/bin/axiom list

When create a resource using the command line tool, you can either specify the namespace and location of the file using the optional parameters --location=LOCATION and --namespace=NAMESPACE or using an axiom.yaml config file (recommended)., (*15)

axiom.yaml

The axiom.yaml file lays out the structure for your generated classes and looks something like:, (*16)

repositories:
    - namespace: Acme\Repositories
    - location: /Users/enzyme/code/acme/Repositories
factories:
    - namespace: Acme\Factories
    - location: /Users/enzyme/code/acme/Factories
bags:
    - namespace: Acme\Bags
    - location: /Users/enzyme/code/acme/Bags
atoms:
    - namespace: Acme\Atoms
    - location: /Users/enzyme/code/acme/Atoms
reports:
    - namespace: Acme\Reports
    - location: /Users/enzyme/code/acme/Reports
models:
    - namespace: Acme\Models
    - location: /Users/enzyme/code/acme/Models

When generating a class using the command line tool and no entry for the class type is found in the axiom.yaml (optional) file or through the command line parameter, an exception will be thrown., (*17)

Resource stack

To create an entire resource stack, which includes a repository, factory, bag and model for a domain resource, you can use the make:stack command. This command does not accept namespaces and locations from the command line, so you will need a axiom.yaml file present. If you want to use the stack generator but want to ignore one or more of the included generated classes, you can use the --ignore parameter. Simply pass the --ignore parameter a string with a comma-delimited list of the resource types to ignore, eg: --ignore="model" or --ignore="factory,bag"., (*18)

Contributing

Please see CONTRIBUTING.md, (*19)

License

MIT - Copyright (c) 2015 Tristan Strathearn, see LICENSE, (*20)

The Versions

03/04 2016

dev-master

9999999-dev https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

03/04 2016

dev-bleeding

dev-bleeding https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

03/04 2016

v4.2.0

4.2.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

03/04 2016

v4.1.0

4.1.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

03/04 2016

v4.0.0

4.0.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

02/04 2016

v3.1.1

3.1.1.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

02/04 2016

v3.1.0

3.1.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

13/03 2016

v3.0.0

3.0.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

06/03 2016

v2.0.0

2.0.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

14/02 2016

1.0.0

1.0.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

19/01 2016

v0.2.0

0.2.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

16/01 2016

v0.1.2

0.1.2.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

16/01 2016

v0.1.1

0.1.1.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

14/01 2016

v0.1.0

0.1.0.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

13/01 2016

v0.0.6

0.0.6.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

13/01 2016

v0.0.5

0.0.5.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

13/01 2016

v0.0.4

0.0.4.0 https://github.com/enzyme/axiom

A set of interfaces & classes for creating domain driven projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

13/01 2016

v0.0.3

0.0.3.0 https://github.com/enzyme/axiom

A set of interfaces for creating DD projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

The Development Requires

by Tristan Strathearn

php ddd hex interfaces enzyme axiom

12/01 2016

v0.0.2

0.0.2.0 https://github.com/enzyme/axiom

A set of interfaces for creating DD projects.

  Sources   Download

MIT

The Requires

  • php >=5.5.0

 

by Tristan Strathearn

php ddd hex interfaces enzyme axiom