Update podspec & tag repo with new version so latest code changes are available in CocoaPods

.gitignore

@@ -1,5 +1,11 @@
-# Xcode
-build/*
+# Finder/Mac OS X
+#
+.DS_Store
+
+# Xcode / Swift
+#
+.build/
+build/
 *.pbxuser
 !default.pbxuser
 *.mode1v3
@@ -8,8 +14,21 @@ build/*
 !default.mode2v3
 *.perspectivev3
 !default.perspectivev3
-*.xcworkspace
-!default.xcworkspace
 xcuserdata
-profile
-*.moved-aside
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+*.xcscmblueprint
+
+# jazzy documentation generator
+#
+undocumented.json
+
+# Carthage: we --use-submodules for our non-leaf dependencies
+#
+Carthage/*
+!Carthage/Checkouts/
+**/Carthage/

.travis.yml

@@ -0,0 +1,42 @@
+language: objective-c
+xcode_project: RaptureXML.xcodeproj
+os: osx
+osx_image: xcode9
+
+branches:
+  only:
+    - master
+
+git:
+  depth: 1
+  submodules: false
+
+before_install:
+  - sudo systemsetup -settimezone America/New_York					# temporary hack: NYC timezone is required for some MBDataEnvironment date-related unit tests
+  - travis_wait 30 git submodule update --init
+
+install:
+  - gem install xcpretty --no-rdoc --no-ri --no-document --quiet
+  - rm -rf ~/Library/Developer/CoreSimulator					  	# these two lines are a hack around a recurring Travis problem: multiple versions of the
+  - sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService	# same simulator: https://github.com/travis-ci/travis-ci/issues/7580#issuecomment-292974395
+
+script:
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh build iOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh test iOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh build macOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh test macOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh build tvOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh test tvOS
+  - travis_wait 30 ./BuildControl/bin/travisBuildHelper.sh build watchOS
+
+after_failure:
+  - test -f "RaptureXML-iOS-build.log" && tail -n 2500 "RaptureXML-iOS-build.log"
+  - test -f "RaptureXML-iOS-test.log" && tail -n 2500 "RaptureXML-iOS-test.log"
+  - test -f "RaptureXML-iOS-test.log" && LINE_BEFORE=`cat "RaptureXML-iOS-test.log" | grep -n "IDETestOperationsObserverDebug. Writing diagnostic log for test session to." | awk -F':' '{print $1}'` && LINE=`expr $LINE_BEFORE + 1` && LOG_FILE=`head -n $LINE "RaptureXML-iOS-test.log" | tail -n 1` && cat "$LOG_FILE"
+  - test -f "RaptureXML-macOS-build.log" && tail -n 2500 "RaptureXML-macOS-build.log"
+  - test -f "RaptureXML-macOS-test.log" && tail -n 2500 "RaptureXML-macOS-test.log"
+  - test -f "RaptureXML-macOS-test.log" && LINE_BEFORE=`cat "RaptureXML-macOS-test.log" | grep -n "IDETestOperationsObserverDebug. Writing diagnostic log for test session to." | awk -F':' '{print $1}'` && LINE=`expr $LINE_BEFORE + 1` && LOG_FILE=`head -n $LINE "RaptureXML-macOS-test.log" | tail -n 1` && cat "$LOG_FILE"
+  - test -f "RaptureXML-tvOS-build.log" && tail -n 2500 "RaptureXML-tvOS-build.log"
+  - test -f "RaptureXML-tvOS-test.log" && tail -n 2500 "RaptureXML-tvOS-test.log"
+  - test -f "RaptureXML-tvOS-test.log" && LINE_BEFORE=`cat "RaptureXML-tvOS-test.log" | grep -n "IDETestOperationsObserverDebug. Writing diagnostic log for test session to." | awk -F':' '{print $1}'` && LINE=`expr $LINE_BEFORE + 1` && LOG_FILE=`head -n $LINE "RaptureXML-tvOS-test.log" | tail -n 1` && cat "$LOG_FILE"
+  - test -f "RaptureXML-watchOS-build.log" && tail -n 2500 "RaptureXML-watchOS-build.log"

BuildControl/Info-Target.plist

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>3.1.1</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSHumanReadableCopyright</key>
+	<string>Copyright © 2016 Rapture In Venice. All rights reserved.</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

BuildControl/Info-Tests.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>BNDL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.0.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+</dict>
+</plist>

BuildControl/RaptureXML.xml

@@ -0,0 +1,20 @@
+<MBML>
+	<Var name="project:name" literal="RaptureXML"/>
+	<Var name="project:publisher" literal="Rapture In Venice"/>
+	<Var name="repo:owner" literal="emaloney"/>
+	<Var name="project:creator:name" literal="John Blanco"/>
+	<Var name="project:license" literal="MIT"/>
+	<Var name="project:bundlePrefix" literal="com.raptureinvenice"/>
+	<Var name="project:language" literal="ObjC"/>
+	<Var name="project:skeleton" literal="none"/>
+	<Var name="project:grouping" literal="Mockingbird"/>
+
+	<Var name="project:description">A simple, sensible, block-based XML API for Apple Platforms development.</Var>
+
+	<Var name="project:platforms" type="list">
+		<Var literal="iOS"/>
+		<Var literal="macOS"/>
+        <Var literal="tvOS"/>
+        <Var literal="watchOS"/>
+	</Var>
+</MBML>

BuildControl/bin/buildCheck.sh

@@ -0,0 +1,146 @@
+#!/bin/bash
+
+#
+# checks that the project builds & passes all unit tests
+#
+# by emaloney, 11 September 2017
+#
+
+set -o pipefail		# to ensure xcodebuild pipeline errors are propagated correctly
+
+SCRIPT_NAME=$(basename "$0")
+SCRIPT_DIR=$(cd "$PWD" ; cd `dirname "$0"` ; echo "$PWD")
+
+source "${SCRIPT_DIR}/include-common.sh"
+
+showHelp()
+{
+	define HELP <<HELP
+$SCRIPT_NAME
+
+	Validates that the code in this repo builds & passes all unit tests.
+
+Usage:
+
+	$SCRIPT_NAME
+
+Optional arguments:
+
+		--skip-tests
+			Skips running the unit tests :-(
+
+		--quiet
+			Silences output
+
+Help
+
+	This documentation is displayed when supplying the --help (or -help, -h,
+	or -?) argument.
+
+	Note that when this script displays help documentation, all other
+	command line arguments are ignored and no other actions are performed.
+
+HELP
+	printf "$HELP" | less
+}
+
+#
+# make sure we're in a git repo
+#
+cd "$SCRIPT_DIR/../../."
+git status 2&> /dev/null
+if [[ $? != 0 ]]; then
+	exitWithErrorSuggestHelp "You must invoke this script from within a git repo"
+fi
+
+#
+# parse the command-line arguments
+#
+while [[ $1 ]]; do
+	case $1 in
+	--skip-tests)
+		SKIP_TESTS=1
+		;;
+
+	--quiet|-q)
+		QUIET=1
+		QUIET_ARG="-q"
+		;;
+
+	--help|-help|-h|-\?)
+		SHOW_HELP=1
+		;;
+
+	-*)
+		exitWithErrorSuggestHelp "Unrecognized argument: $1"
+		;;
+
+	*)
+		if [[ -z $ARGS ]]; then
+			ARGS=$1
+		else
+			ARGS="$ARGS $1"
+		fi
+	esac
+	shift
+done
+
+if [[ $SHOW_HELP ]]; then
+	showHelp
+	exit 1
+fi
+
+for ARG in $ARGS; do
+	exitWithErrorSuggestHelp "Unrecognized argument: $ARG"
+done
+
+#
+# make sure it builds
+#
+PROJECT_NAME="RaptureXML"
+XCODEBUILD=/usr/bin/xcodebuild
+XCODEBUILD_CMD="$XCODEBUILD"
+if [[ $SKIP_TESTS ]]; then
+	updateStatus "Verifying that $PROJECT_NAME builds"
+else
+	updateStatus "Verifying that $PROJECT_NAME builds and passes unit tests"
+fi
+if [[ $QUIET ]]; then
+	XCODEBUILD_CMD="$XCODEBUILD -quiet"
+fi
+if [[ ! -x "$XCODEBUILD" ]]; then
+	exitWithErrorSuggestHelp "Expected to find xcodebuild at path $XCODEBUILD"
+fi
+
+#
+# use xcpretty if it is available
+#
+XCODEBUILD_PIPETO=""
+XCPRETTY=`which xcpretty`
+if [[ $? == 0 ]]; then
+	XCODEBUILD_PIPETO="| $XCPRETTY"
+fi
+
+#
+# determine build settings
+#
+PROJECT_SPECIFIER="-project RaptureXML.xcodeproj"
+COMPILE_PLATFORMS="iOS macOS tvOS watchOS"
+
+#
+# build for each platform
+#
+for PLATFORM in $COMPILE_PLATFORMS; do
+	updateStatus "Building: $PROJECT_NAME for $PLATFORM..."
+	if [[ $SKIP_TESTS ]]; then
+		BUILD_ACTION="clean build"
+	else
+		BUILD_ACTION="clean $(testActionForPlatform $PLATFORM)"
+	fi
+	RUN_DESTINATION="$(runDestinationForPlatform $PLATFORM)"
+	if [[ $QUIET ]]; then
+		executeCommand "$XCODEBUILD_CMD $PROJECT_SPECIFIER -scheme \"${PROJECT_NAME}\" -configuration Debug -destination \"$RUN_DESTINATION\" $BUILD_ACTION $XCODEBUILD_PIPETO" 2&> /dev/null
+	else
+		executeCommand "$XCODEBUILD_CMD $PROJECT_SPECIFIER -scheme \"${PROJECT_NAME}\" -configuration Debug -destination \"$RUN_DESTINATION\" $BUILD_ACTION $XCODEBUILD_PIPETO"
+	fi
+done

BuildControl/bin/carthageUpdate.sh

@@ -0,0 +1 @@
+carthage update $@ --use-submodules --no-build