Merge branch 'release/0.2.0'

.travis.install

@@ -16,6 +16,7 @@ if ($token = getenv('ARCHER_TOKEN')) {
         'github.com' => $token
     );
     $composerFlags = '--prefer-dist';
+    passthru('curl -s -i -H "Authorization: token $ARCHER_TOKEN" https://api.github.com | grep "^X-RateLimit"');
 } else {
     $composerFlags = '--prefer-source';
 }

.travis.yml

@@ -8,10 +8,7 @@
 #
 language: php
 
-php:
-  - 5.3
-  - 5.4
-  - 5.5
+php: ["5.3", "5.4", "5.5"]
 
 env:
   global:
@@ -22,8 +19,3 @@ install:
   - ./.travis.install
 script:
   - ./vendor/bin/archer travis:build
-
-matrix:
-  # PHP 5.5 is still in alpha, so ignore build failures.
-  allow_failures:
-    - php: 5.5

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Pathogen changelog
 
+### 0.2.0 (2013-07-27)
+
+* **[NEW]** All paths can now be normalized by calling `normalize()`, which
+  takes an optional normalizer to use.
+* **[NEW]** Unix paths now have first-class representations, and their own
+  factory.
+* **[IMPROVED]** File system paths will automatically normalize the result of
+  the `parent()` method ([#21]).
+* **[NEW]** Implemented dependency consumer traits ([#22]).
+* **[NEW]** Implemented simple methods for matching strings and patterns in
+  paths and path names ([#19]).
+
 ### 0.1.2 (2013-07-18)
 
 * **[FIXED]** AbsolutePath::relativeTo() now works for paths with common
@@ -16,4 +28,7 @@
 <!-- References -->
 
 [#18]: https://github.com/eloquent/pathogen/issues/18
+[#19]: https://github.com/eloquent/pathogen/issues/19
 [#20]: https://github.com/eloquent/pathogen/issues/20
+[#21]: https://github.com/eloquent/pathogen/issues/21
+[#22]: https://github.com/eloquent/pathogen/issues/22

README.md

@@ -33,6 +33,8 @@ structures while providing a comprehensive API.
     - [File system paths](#file-system-paths)
     - [Immutability of paths](#immutability-of-paths)
     - [Windows path support](#windows-path-support)
+    - [Dependency consumer traits](#dependency-consumer-traits)
+        - [Available dependency consumer traits](#available-dependency-consumer-traits)
 - [Usage examples](#usage-examples)
     - [Resolving a user-provided path against the current working directory](#resolving-a-user-provided-path-against-the-current-working-directory)
     - [Determining whether one path exists inside another](#determining-whether-one-path-exists-inside-another)
@@ -234,14 +236,12 @@ required for some reason, this is left to the developer to handle:
 
 ```php
 use Eloquent\Pathogen\FileSystem\Factory\FileSystemPathFactory;
-use Eloquent\Pathogen\FileSystem\Normalizer\FileSystemPathNormalizer;
 
 $factory = new FileSystemPathFactory;
-$normalizer = new FileSystemPathNormalizer;
 
 $path = $factory->create('/path/./to/foo/../bar');
 
-$normalizedPath = $normalizer->normalize($path);
+$normalizedPath = $path->normalize();
 echo $normalizedPath->string(); // outputs '/path/to/bar'
 ```
 
@@ -299,6 +299,38 @@ $drive = $path->drive(); // returns a single-character string, or null
 It is worth noting that *Pathogen* does *not* support drive specifiers for
 relative Windows paths, only for absolute Windows paths.
 
+### Dependency consumer traits
+
+*Pathogen* provides some [traits] to make consuming its services extremely
+simple for systems code targeting PHP 5.4 and higher.
+
+The concept of a dependency consumer trait is simple. If a class requires, for
+example, a path factory, it can simply use a `PathFactoryTrait`. This gives the
+class `setPathFactory()` and `pathFactory()` methods for managing the path
+factory dependency.
+
+This example demonstrates how to use the file system path factory trait:
+
+```php
+use Eloquent\Pathogen\FileSystem\Factory\Consumer\FileSystemPathFactoryTrait;
+
+class ExampleConsumer
+{
+    use FileSystemPathFactoryTrait;
+}
+
+$consumer = new ExampleConsumer;
+echo get_class($consumer->pathFactory()); // outputs 'Eloquent\Pathogen\FileSystem\Factory\FileSystemPathFactory'
+```
+
+#### Available dependency consumer traits
+
+- [PlatformFileSystemPathFactoryTrait]
+- [FileSystemPathFactoryTrait]
+- [PathFactoryTrait]
+- [PathResolverTrait]
+- [NormalizingPathResolverTrait]
+
 ## Usage examples
 
 ### Resolving a user-provided path against the current working directory
@@ -390,14 +422,20 @@ echo $pathWithReplacement->string(); // outputs '/path/for/baz/bar'
 
 [AbsolutePathInterface]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/AbsolutePathInterface.html
 [API documentation]: http://lqnt.co/pathogen/artifacts/documentation/api/
-[Build Status]: https://api.travis-ci.org/eloquent/pathogen.png
+[Build Status]: https://api.travis-ci.org/eloquent/pathogen.png?branch=master
 [Composer]: http://getcomposer.org/
 [eloquent/pathogen]: https://packagist.org/packages/eloquent/pathogen
 [FileSystemPathFactory]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/FileSystem/Factory/FileSystemPathFactory.html
+[FileSystemPathFactoryTrait]: src/Eloquent/Pathogen/FileSystem/Factory/Consumer/FileSystemPathFactoryTrait.php
 [Latest build]: http://travis-ci.org/eloquent/pathogen
+[NormalizingPathResolverTrait]: src/Eloquent/Pathogen/Resolver/Consumer/NormalizingPathResolverTrait.php
 [PathFactoryInterface]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/Factory/PathFactoryInterface.html
+[PathFactoryTrait]: src/Eloquent/Pathogen/Factory/Consumer/PathFactoryTrait.php
 [PathInterface]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/PathInterface.html
+[PathResolverTrait]: src/Eloquent/Pathogen/Resolver/Consumer/PathResolverTrait.php
 [PlatformFileSystemPathFactory]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/FileSystem/Factory/PlatformFileSystemPathFactory.html
+[PlatformFileSystemPathFactoryTrait]: src/Eloquent/Pathogen/FileSystem/Factory/Consumer/PlatformFileSystemPathFactoryTrait.php
 [RelativePathInterface]: http://lqnt.co/pathogen/artifacts/documentation/api/Eloquent/Pathogen/RelativePathInterface.html
 [Test coverage report]: http://lqnt.co/pathogen/artifacts/tests/coverage/
 [Test Coverage]: https://coveralls.io/repos/eloquent/pathogen/badge.png
+[traits]: http://php.net/traits

composer.json

@@ -18,6 +18,7 @@
     ],
     "require": {
         "php": ">=5.3.3",
+        "ext-mbstring": "*",
         "icecave/isolator": "~2"
     },
     "require-dev": {