updated help text and build settings

Author: scriptingosx

diskspace.xcodeproj/project.pbxproj

@@ -94,6 +94,9 @@
 			isa = PBXProject;
 			attributes = {
 				BuildIndependentTargetsInParallel = 1;
+				KnownAssetTags = (
+					New,
+				);
 				LastSwiftUpdateCheck = 1310;
 				LastUpgradeCheck = 1310;
 				TargetAttributes = {
@@ -186,7 +189,8 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				MACOSX_DEPLOYMENT_TARGET = 12.0;
+				MACOSX_DEPLOYMENT_TARGET = 10.14;
+				MARKETING_VERSION = 1;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
@@ -241,7 +245,8 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				MACOSX_DEPLOYMENT_TARGET = 12.0;
+				MACOSX_DEPLOYMENT_TARGET = 10.14;
+				MARKETING_VERSION = 1;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				SDKROOT = macosx;
@@ -253,21 +258,27 @@
 		C6F43F072731718900747000 /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				CODE_SIGN_STYLE = Automatic;
+				CODE_SIGN_IDENTITY = "Developer ID Application";
+				CODE_SIGN_STYLE = Manual;
 				DEVELOPMENT_TEAM = JME5BW3F3R;
 				ENABLE_HARDENED_RUNTIME = YES;
+				PRODUCT_BUNDLE_IDENTIFIER = com.scriptingosx.diskspace;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				PROVISIONING_PROFILE_SPECIFIER = "";
 				SWIFT_VERSION = 5.0;
 			};
 			name = Debug;
 		};
 		C6F43F082731718900747000 /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				CODE_SIGN_STYLE = Automatic;
+				CODE_SIGN_IDENTITY = "Developer ID Application";
+				CODE_SIGN_STYLE = Manual;
 				DEVELOPMENT_TEAM = JME5BW3F3R;
 				ENABLE_HARDENED_RUNTIME = YES;
+				PRODUCT_BUNDLE_IDENTIFIER = com.scriptingosx.diskspace;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				PROVISIONING_PROFILE_SPECIFIER = "";
 				SWIFT_VERSION = 5.0;
 			};
 			name = Release;

diskspace.xcodeproj/xcshareddata/xcschemes/diskspace.xcscheme

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
    LastUpgradeVersion = "1310"
-   version = "1.3">
+   version = "1.7">
    <BuildAction
       parallelizeBuildables = "YES"
       buildImplicitDependencies = "YES">
@@ -53,6 +53,10 @@
       <CommandLineArguments>
          <CommandLineArgument
             argument = "--human-readable"
+            isEnabled = "NO">
+         </CommandLineArgument>
+         <CommandLineArgument
+            argument = "--help"
             isEnabled = "YES">
          </CommandLineArgument>
       </CommandLineArguments>
@@ -80,5 +84,23 @@
    <ArchiveAction
       buildConfiguration = "Release"
       revealArchiveInOrganizer = "YES">
+      <PostActions>
+         <ExecutionAction
+            ActionType = "Xcode.IDEStandardExecutionActionsCore.ExecutionActionType.ShellScriptAction">
+            <ActionContent
+               title = "Run Script"
+               scriptText = "# Developer ID Installer cert name&#10;sign_cert=&quot;Developer ID Installer: Armin Briegel (JME5BW3F3R)&quot;&#10;# profile name used with `notarytool --store-credentials`&#10;credential_profile=&quot;notary-scriptingosx&quot;&#10;&#10;# data from build settings&#10;pkg_name=&quot;$PRODUCT_NAME&quot;&#10;identifier=&quot;$PRODUCT_BUNDLE_IDENTIFIER&quot;&#10;version=&quot;$MARKETING_VERSION&quot;&#10;&#10;PKG_PATH=&quot;$SRCROOT/$pkg_name-$version.pkg&quot;&#10;NOTARY_LOG=&quot;$SRCROOT/notary.log&quot;&#10;&#10;echo &quot;Packaging and Notarizing &apos;$pkg_name&apos;, version: $version&quot; &gt; &quot;$NOTARY_LOG&quot;&#10;date +&quot;%F %T&quot; &gt;&gt; &quot;$NOTARY_LOG&quot;&#10;echo &gt;&gt; &quot;$NOTARY_LOG&quot;&#10;&#10;# usually use `xcodebuild -exportArchive` to get&#10;# the product out of the archive. However, this does not work&#10;# with a command line tool, so we are going direct&#10;PKG_ROOT=&quot;$ARCHIVE_PATH/Products/&quot;&#10;&#10;# create the pkg&#10;pkgbuild --root &quot;$PKG_ROOT&quot; \&#10;         --identifier &quot;$identifier&quot; \&#10;         --version &quot;$version&quot; \&#10;         --install-location &quot;/&quot; \&#10;         --sign &quot;$sign_cert&quot; \&#10;         &quot;$PKG_PATH&quot; &gt;&gt; &quot;$NOTARY_LOG&quot; 2&gt;&amp;1&#10;echo &gt;&gt; &quot;$NOTARY_LOG&quot;&#10;&#10;# notarize&#10;xcrun notarytool submit &quot;$PKG_PATH&quot; \&#10;                 --keychain-profile &quot;$credential_profile&quot; \&#10;                 --wait &gt;&gt; &quot;$NOTARY_LOG&quot; 2&gt;&amp;1&#10;echo &gt;&gt; &quot;$NOTARY_LOG&quot;&#10;&#10;# staple&#10;xcrun stapler staple &quot;$PKG_PATH&quot; &gt;&gt; &quot;$NOTARY_LOG&quot; 2&gt;&amp;1&#10;&#10;# reveal in Finder&#10;open -R &quot;$PKG_PATH&quot;&#10;">
+               <EnvironmentBuildable>
+                  <BuildableReference
+                     BuildableIdentifier = "primary"
+                     BlueprintIdentifier = "C6F43EFE2731718900747000"
+                     BuildableName = "diskspace"
+                     BlueprintName = "diskspace"
+                     ReferencedContainer = "container:diskspace.xcodeproj">
+                  </BuildableReference>
+               </EnvironmentBuildable>
+            </ActionContent>
+         </ExecutionAction>
+      </PostActions>
    </ArchiveAction>
 </Scheme>

diskspace/main.swift

@@ -12,6 +12,23 @@ import ArgumentParser
 // https://developer.apple.com/documentation/foundation/urlresourcekey/checking_volume_storage_capacity
 
 struct DiskSpace : ParsableCommand {
+    static let configuration = CommandConfiguration(
+        commandName: "diskspace",
+        abstract: "Returns available disk space",
+        discussion: """
+With the various APFS features the value for free disk space returned from tools such as `du` or `df` will not be accurate. This tool uses system functions to get various measures of available disk space.
+
+The 'Important' value matches the free disk space value shown in Finder.
+
+You can get the details from Apple's documentation:
+
+https://developer.apple.com/documentation/foundation/urlresourcekey/checking_volume_storage_capacity
+""",
+        version: "1"
+    )
+    
+    // MARK: Flags and Arguments
+    
     @Flag(name: [.customShort("H"), .long],
           help: "Human readable output using unit suffixes")
     var humanReadable = false
@@ -29,11 +46,13 @@ struct DiskSpace : ParsableCommand {
     var opportunistic = false
 
     @Flag(name: .shortAndLong,
-          help: "Print only the value of the total Capacity")
+          help: "Print only the value of the Total Capacity")
     var total = false
 
     @Argument(help: "path to the volume") var volumePath = "/"
 
+    // MARK: Functions
+    
     func printValue(value int: Int, label: String? = nil) {
         printValue(value: Int64(int), label: label)
     }
@@ -55,6 +74,8 @@ struct DiskSpace : ParsableCommand {
         }
     }
 
+    // MARK: Run the command
+    
     func run() {
         let showAll = !(available || important || opportunistic || total)
 
@@ -95,4 +116,5 @@ struct DiskSpace : ParsableCommand {
     }
 }
 
+// call the struct's main function
 DiskSpace.main()