Merge pull request #374 from gdgib/G2-1644-CreatePath

G2-1644 Create ax-path module & sketch API

ax-adt/pom.xml

@@ -20,5 +20,10 @@
 			<artifactId>ax-analysis</artifactId>
 			<version>${project.version}</version>
 		</dependency>
+		<dependency>
+			<groupId>com.g2forge.alexandria</groupId>
+			<artifactId>ax-collection</artifactId>
+			<version>${project.version}</version>
+		</dependency>
 	</dependencies>
 </project>

ax-adt/src/main/java/com/g2forge/alexandria/adt/graph/v2/DiGraphBuilder.java

@@ -5,14 +5,14 @@
 import java.util.LinkedHashSet;
 import java.util.Set;
 
-import com.g2forge.alexandria.adt.collection.ICollection;
 import com.g2forge.alexandria.adt.graph.v2.DiGraph.EdgeData;
 import com.g2forge.alexandria.adt.graph.v2.DiGraph.ILockableGraphKey;
 import com.g2forge.alexandria.adt.graph.v2.DiGraph.ImmutableGraphKey;
 import com.g2forge.alexandria.adt.graph.v2.DiGraph.VertexData;
 import com.g2forge.alexandria.adt.graph.v2.member.IMemberDataStrategy;
 import com.g2forge.alexandria.annotations.note.Note;
 import com.g2forge.alexandria.annotations.note.NoteType;
+import com.g2forge.alexandria.collection.ICollection;
 
 import lombok.AccessLevel;
 import lombok.AllArgsConstructor;

ax-adt/src/main/java/com/g2forge/alexandria/adt/graph/v2/IGraphModifier.java

@@ -1,7 +1,7 @@
 package com.g2forge.alexandria.adt.graph.v2;
 
-import com.g2forge.alexandria.adt.collection.CollectionCollection;
-import com.g2forge.alexandria.adt.collection.ICollection;
+import com.g2forge.alexandria.collection.CollectionCollection;
+import com.g2forge.alexandria.collection.ICollection;
 import com.g2forge.alexandria.java.function.builder.IModifier;
 
 public interface IGraphModifier<V, E, Result> extends IGraphGeneric<V, E> {

ax-adt/src/main/java/com/g2forge/alexandria/adt/graph/v2/MutableDiGraph.java

@@ -2,7 +2,7 @@
 
 import java.util.LinkedHashSet;
 
-import com.g2forge.alexandria.adt.collection.ICollection;
+import com.g2forge.alexandria.collection.ICollection;
 
 import lombok.AccessLevel;
 import lombok.Getter;

ax-collection/.gitignore

@@ -0,0 +1,5 @@
+/.settings/
+/target/
+/.classpath
+/.project
+*.factorypath

ax-collection/pom.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+	<modelVersion>4.0.0</modelVersion>
+	<artifactId>ax-collection</artifactId>
+
+	<parent>
+		<groupId>com.g2forge.alexandria</groupId>
+		<artifactId>ax-project</artifactId>
+		<version>0.0.19-SNAPSHOT</version>
+		<relativePath>../ax-project/pom.xml</relativePath>
+	</parent>
+
+	<name>Alexandria Collections</name>
+	<description>Extended Collections API.</description>
+</project>

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/CircularBuffer.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/CircularBuffer.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.ArrayList;
 import java.util.List;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/CollectionCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/CollectionCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.Collections;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/DCollectionCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/DCollectionCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Iterator;
 import java.util.stream.Stream;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/DIteratorCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/DIteratorCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.stream.Collectors;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/DStreamCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/DStreamCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.Iterator;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/EmptyCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/EmptyCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.Collections;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/ICloseableCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/ICloseableCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import com.g2forge.alexandria.java.close.ICloseable;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/ICollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/ICollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.stream.Stream;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/IndexedGeneratorList.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/IndexedGeneratorList.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.AbstractList;
 import java.util.function.IntFunction;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/IntegerRangeList.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/IntegerRangeList.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.AbstractList;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/LongRangeList.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/LongRangeList.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.AbstractList;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/SingleCollection.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/SingleCollection.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection;
+package com.g2forge.alexandria.collection;
 
 import java.util.Collection;
 import java.util.Collections;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/ICollectionBuilder.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/ICollectionBuilder.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection.collector;
+package com.g2forge.alexandria.collection.collector;
 
 import com.g2forge.alexandria.java.function.ISupplier;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/ICollector.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/ICollector.java

@@ -1,4 +1,4 @@
-package com.g2forge.alexandria.adt.collection.collector;
+package com.g2forge.alexandria.collection.collector;
 
 public interface ICollector<T> {
 	public default ICollector<T> add(Iterable<? extends T> values) {

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/implementations/CollectionCollectionBuilder.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/implementations/CollectionCollectionBuilder.java

@@ -1,10 +1,10 @@
-package com.g2forge.alexandria.adt.collection.collector.implementations;
+package com.g2forge.alexandria.collection.collector.implementations;
 
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollectionBuilder;
+import com.g2forge.alexandria.collection.collector.ICollectionBuilder;
 
 import lombok.RequiredArgsConstructor;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/implementations/CollectorSetter.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/implementations/CollectorSetter.java

@@ -1,6 +1,6 @@
-package com.g2forge.alexandria.adt.collection.collector.implementations;
+package com.g2forge.alexandria.collection.collector.implementations;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollector;
+import com.g2forge.alexandria.collection.collector.ICollector;
 import com.g2forge.alexandria.java.adt.tuple.ITuple1_S;
 
 public class CollectorSetter<T> implements ITuple1_S<T> {

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/implementations/FixedCollectionBuilder.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/implementations/FixedCollectionBuilder.java

@@ -1,8 +1,8 @@
-package com.g2forge.alexandria.adt.collection.collector.implementations;
+package com.g2forge.alexandria.collection.collector.implementations;
 
 import java.util.Collection;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollectionBuilder;
+import com.g2forge.alexandria.collection.collector.ICollectionBuilder;
 
 import lombok.RequiredArgsConstructor;
 

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/implementations/SeparatingCollector.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/implementations/SeparatingCollector.java

@@ -1,6 +1,6 @@
-package com.g2forge.alexandria.adt.collection.collector.implementations;
+package com.g2forge.alexandria.collection.collector.implementations;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollector;
+import com.g2forge.alexandria.collection.collector.ICollector;
 
 import lombok.Getter;
 import lombok.RequiredArgsConstructor;

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/collector/implementations/StringCollector.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/collector/implementations/StringCollector.java

@@ -1,8 +1,8 @@
-package com.g2forge.alexandria.adt.collection.collector.implementations;
+package com.g2forge.alexandria.collection.collector.implementations;
 
 import java.util.Objects;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollector;
+import com.g2forge.alexandria.collection.collector.ICollector;
 
 public class StringCollector<T> implements ICollector<T> {
 	protected final StringBuilder internal = new StringBuilder();

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/strategy/ACollectionStrategy.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/strategy/ACollectionStrategy.java

@@ -1,9 +1,9 @@
-package com.g2forge.alexandria.adt.collection.strategy;
+package com.g2forge.alexandria.collection.strategy;
 
 import java.util.Collection;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollectionBuilder;
-import com.g2forge.alexandria.adt.collection.collector.implementations.CollectionCollectionBuilder;
+import com.g2forge.alexandria.collection.collector.ICollectionBuilder;
+import com.g2forge.alexandria.collection.collector.implementations.CollectionCollectionBuilder;
 
 public abstract class ACollectionStrategy<C extends Collection<T>, T> implements ICollectionStrategy<C, T> {
 	protected class Builder extends CollectionCollectionBuilder<C, T> {

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/strategy/ICollectionStrategy.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/strategy/ICollectionStrategy.java

@@ -1,6 +1,6 @@
-package com.g2forge.alexandria.adt.collection.strategy;
+package com.g2forge.alexandria.collection.strategy;
 
-import com.g2forge.alexandria.adt.collection.collector.ICollectionBuilder;
+import com.g2forge.alexandria.collection.collector.ICollectionBuilder;
 
 public interface ICollectionStrategy<C, T> {
 	public ICollectionBuilder<C, T> builder();

ax-adt/src/main/java/com/g2forge/alexandria/adt/collection/strategy/implementations/CollectionStrategy.java → ax-collection/src/main/java/com/g2forge/alexandria/collection/strategy/implementations/CollectionStrategy.java

@@ -1,9 +1,9 @@
-package com.g2forge.alexandria.adt.collection.strategy.implementations;
+package com.g2forge.alexandria.collection.strategy.implementations;
 
 import java.util.ArrayList;
 import java.util.Collection;
 
-import com.g2forge.alexandria.adt.collection.strategy.ACollectionStrategy;
+import com.g2forge.alexandria.collection.strategy.ACollectionStrategy;
 
 public class CollectionStrategy<T> extends ACollectionStrategy<Collection<T>, T> {
 	protected ArrayList<T> create(Collection<T> copy) {

ax-path/.gitignore

@@ -0,0 +1,5 @@
+/.settings/
+/target/
+/.classpath
+/.project
+*.factorypath

ax-path/pom.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+	<modelVersion>4.0.0</modelVersion>
+	<artifactId>ax-path</artifactId>
+
+	<parent>
+		<groupId>com.g2forge.alexandria</groupId>
+		<artifactId>ax-project</artifactId>
+		<version>0.0.19-SNAPSHOT</version>
+		<relativePath>../ax-project/pom.xml</relativePath>
+	</parent>
+
+	<name>Alexandria Paths</name>
+	<description>Generic Path API - flexible enough to be used for loca &amp;
+		remote filesystems or even abstract tree data structures.</description>
+
+	<dependencies>
+		<dependency>
+			<groupId>com.g2forge.alexandria</groupId>
+			<artifactId>ax-collection</artifactId>
+			<version>${project.version}</version>
+		</dependency>
+	</dependencies>
+</project>

ax-path/src/main/java/com/g2forge/alexandria/path/IPath.java

@@ -0,0 +1,11 @@
+package com.g2forge.alexandria.path;
+
+import com.g2forge.alexandria.collection.ICollection;
+
+public interface IPath<T> {
+	public ICollection<T> getComponents();
+
+	public IPath<T> resolve(IPath<T> subpath);
+
+	public boolean isEmpty();
+}

ax-path/src/main/java/com/g2forge/alexandria/path/Path.java

@@ -0,0 +1,47 @@
+package com.g2forge.alexandria.path;
+
+import java.util.Collection;
+
+import com.g2forge.alexandria.collection.CollectionCollection;
+import com.g2forge.alexandria.collection.EmptyCollection;
+import com.g2forge.alexandria.collection.ICollection;
+import com.g2forge.alexandria.java.core.helpers.HCollection;
+
+import lombok.Builder;
+import lombok.Data;
+import lombok.RequiredArgsConstructor;
+
+@Data
+@Builder(toBuilder = true)
+@RequiredArgsConstructor
+public class Path<T> implements IPath<T> {
+	protected static final Path<Object> EMPTY = new Path<>();
+
+	@SuppressWarnings("unchecked")
+	public static <T> Path<T> createEmpty() {
+		return (Path<T>) EMPTY;
+	}
+
+	protected final ICollection<T> components;
+
+	public Path(Collection<T> components) {
+		this(components.size() < 1 ? EmptyCollection.create() : new CollectionCollection<>(components));
+	}
+
+	@SafeVarargs
+	public Path(T... components) {
+		this(components.length < 1 ? EmptyCollection.create() : new CollectionCollection<>(components));
+	}
+
+	@Override
+	public boolean isEmpty() {
+		return getComponents().isEmpty();
+	}
+
+	@Override
+	public IPath<T> resolve(IPath<T> subpath) {
+		if (isEmpty()) return subpath;
+		if (subpath.isEmpty()) return this;
+		return new Path<>(HCollection.concatenate(getComponents().toCollection(), subpath.getComponents().toCollection()));
+	}
+}

ax-path/src/main/java/com/g2forge/alexandria/path/directory/DirectorySystem.java

@@ -0,0 +1,22 @@
+package com.g2forge.alexandria.path.directory;
+
+import com.g2forge.alexandria.java.core.enums.EnumException;
+import com.g2forge.alexandria.java.platform.HPlatform;
+import com.g2forge.alexandria.java.platform.PlatformCategory;
+
+public enum DirectorySystem implements IStandardDirectorySystem {
+	Microsoft,
+	POSIX;
+
+	public static DirectorySystem getDirectorySystem() {
+		final PlatformCategory category = HPlatform.getPlatform().getCategory();
+		switch (category) {
+			case Microsoft:
+				return DirectorySystem.Microsoft;
+			case Posix:
+				return DirectorySystem.POSIX;
+			default:
+				throw new EnumException(PlatformCategory.class, category);
+		}
+	}
+}

ax-path/src/main/java/com/g2forge/alexandria/path/directory/IDirectorySystem.java

@@ -0,0 +1,7 @@
+package com.g2forge.alexandria.path.directory;
+
+import com.g2forge.alexandria.path.IPath;
+
+public interface IDirectorySystem<T> {
+	public IPath<T> normalize(IPath<T> path);
+}