Initial commit.

Author: memfrag

.gitignore

@@ -0,0 +1,40 @@
+################################
+### Xcode project .gitignore ###
+################################
+
+### macOS ###
+
+.DS_Store
+
+### User settings and such ###
+
+xcuserdata/
+*.xcworkspace
+!default.xcworkspace
+
+### Build Artifacts ###
+
+*.hmap
+*.ipa
+*.dSYM.zip
+*.dSYM
+
+*.xcworkspace
+!default.xcworkspace
+xcuserdata
+profile
+*.moved-aside
+DerivedData
+.idea/
+*.xccheckout
+build/
+
+### Swift Package Manager ###
+
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.build/
+
+### Playgrounds ###
+
+timeline.xctimeline
+playground.xcworkspace

.swiftlint.yml

@@ -0,0 +1,106 @@
+whitelist_rules: # only these rules will be applied
+    - colon
+    - comma
+    - conditional_returns_on_newline
+    - control_statement
+    - empty_enum_arguments
+    - empty_parameters
+    - empty_parentheses_with_trailing_closure
+    - file_length
+    - legacy_cggeometry_functions
+    - legacy_constant
+    - legacy_constructor
+    - legacy_hashing
+    - legacy_nsgeometry_functions
+    - line_length
+    - class_delegate_protocol
+    - weak_delegate
+    - anyobject_protocol
+    - closing_brace
+    - closure_end_indentation
+    - closure_parameter_position
+    - closure_spacing
+    - explicit_init
+    - generic_type_name
+    - identical_operands
+    - implicit_getter
+    - is_disjoint
+    - leading_whitespace
+    - literal_expression_end_indentation
+    - mark
+    - modifier_order
+    - multiline_arguments
+    - multiline_function_chains
+    - multiple_closures_with_trailing_closure
+    - operator_usage_whitespace
+    - operator_whitespace
+    - overridden_super_call
+    - override_in_extension
+    - prohibited_super_call
+    - protocol_property_accessors_order
+    - redundant_discardable_let
+    - redundant_nil_coalescing
+    - redundant_objc_attribute
+    - redundant_optional_initialization
+    - redundant_void_return
+    - return_arrow_whitespace
+    - shorthand_operator
+    - statement_position
+    - switch_case_alignment
+    - syntactic_sugar
+    - trailing_comma
+    - trailing_semicolon
+    - type_name
+    - unneeded_break_in_switch
+    - unused_enumerated
+    - unused_optional_binding
+    - valid_ibinspectable
+    - vertical_parameter_alignment
+    - vertical_parameter_alignment_on_call
+    - vertical_whitespace
+    - void_return
+    - yoda_condition
+    - array_init
+    - attributes
+    - compiler_protocol_init
+    - contains_over_first_not_nil
+    - discouraged_direct_init
+    - discouraged_object_literal
+    - discouraged_optional_boolean
+    - dynamic_inline
+    - force_try
+    - force_unwrapping
+    - legacy_random
+
+# The values below are not final and may need further tweaking.
+
+file_length:
+  - 2000 #warning
+  - 2500 #error
+
+function_body_length:
+  - 200 #warning
+  - 400 #error
+
+line_length:
+  - 200 #warning
+  - 400 #error
+
+type_body_length:
+  - 1000 #warning
+  - 2000 #error
+
+identifier_name:
+  min_length: 1 #warning
+  max_length: #warning or error
+    warning: 100
+    error: 150
+
+type_name:
+    min_length: 1
+    max_length: 80 #warning
+
+excluded: # paths to ignore during linting. Takes precedence over `included`.
+  - External
+
+reporter: "xcode" # reporter type (xcode, json, csv, checkstyle, junit, html, emoji, sonarqube, markdown)

LICENSE

@@ -0,0 +1,14 @@
+BSD Zero Clause License
+
+Copyright (c) 2023 Apparata AB
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

Package.swift

@@ -0,0 +1,23 @@
+// swift-tools-version:5.8
+
+import PackageDescription
+
+let package = Package(
+    name: "UserDefaultsUI",
+    platforms: [
+        .iOS(.v15), .macOS(.v12), .tvOS(.v15)
+    ],
+    products: [
+        .library(name: "UserDefaultsUI", targets: ["UserDefaultsUI"])
+    ],
+    targets: [
+        .target(
+            name: "UserDefaultsUI",
+            dependencies: [],
+            swiftSettings: [
+                .define("DEBUG", .when(configuration: .debug)),
+                .define("RELEASE", .when(configuration: .release)),
+                .define("SWIFT_PACKAGE")
+            ])
+    ]
+)

README.md

@@ -0,0 +1,27 @@
+
+# UserDefaultsUI
+
+Swift package that provides a `UserDefaults` browser and editor for debug mode in SwiftUI apps.
+
+## License
+
+See the LICENSE file for licensing information.
+
+## Usage
+
+Let's say the keys of your user defaults have a prefix, e.g. "com.example.", and you don't need to see it prominently in the `UserDefaults` browser, then you would list that prefix in the `hidePrefixes` parameter to the `UserDefaultsBrowser` initializer.
+
+In the example below, `NavigationView` is used, but `NavigationStack` works too.
+
+```swift
+import SwiftUI
+import UserDefaultsUI
+
+struct ContentView: View {
+    var body: some View {
+        NavigationView {
+            UserDefaultsBrowser(hidePrefixes: ["com.example."])
+        }
+    }
+}
+```

Sources/UserDefaultsUI/Editors/AddUserDefaultEditor.swift

@@ -0,0 +1,111 @@
+import SwiftUI
+
+struct AddUserDefaultEditor: View {
+
+    let value: UserDefaultValue
+    
+    let model: UserDefaultsModel
+
+    @Environment(\.dismiss) private var dismiss
+
+    @State private var key: String = "example.key"
+    
+    var body: some View {
+        NavigationView {
+            VStack {
+                VStack(alignment: .leading) {
+                    Text("Key")
+                        .font(.caption)
+                        .foregroundStyle(.secondary)
+                    TextField("", text: $key)
+                        .labelsHidden()
+                        .keyboardType(.numbersAndPunctuation)
+                        .padding(4)
+                        .background(Color(white: 0, opacity: 0.05))
+                        .cornerRadius(4)
+                }
+                .padding()
+                switch value {
+                    
+                case .boolean(let value):
+                    AddBoolEditor(value: value) { value in
+                        let key = key.trimmingCharacters(in: .whitespacesAndNewlines)
+                        model.actions.setValue(value, forKey: key)
+                        dismiss()
+                    }
+                    
+                case .integer(let value):
+                    IntValueEditor(value: value) { value in
+                        let key = key.trimmingCharacters(in: .whitespacesAndNewlines)
+                        model.actions.setValue(value, forKey: key)
+                        dismiss()
+                    }
+                    
+                case .float(let value):
+                    FloatValueEditor(value: value) { value in
+                        let key = key.trimmingCharacters(in: .whitespacesAndNewlines)
+                        model.actions.setValue(value, forKey: key)
+                        dismiss()
+                    }
+                    
+                case .double(let value):
+                    DoubleValueEditor(value: value) { value in
+                        let key = key.trimmingCharacters(in: .whitespacesAndNewlines)
+                        model.actions.setValue(value, forKey: key)
+                        dismiss()
+                    }
+                    
+                case .string(let value):
+                    StringValueEditor(text: value) { text in
+                        let key = key.trimmingCharacters(in: .whitespacesAndNewlines)
+                        model.actions.setValue(text, forKey: key)
+                        dismiss()
+                    }
+                    
+                case .other(_):
+                    Text("Type is not editable")
+                }
+                
+                Spacer()
+            }
+            .navigationTitle("Add User Default")
+            .navigationBarTitleDisplayMode(.inline)
+            .toolbar {
+                ToolbarItem(placement: .navigationBarTrailing) {
+                    Button {
+                        dismiss()
+                    } label: {
+                        Image(systemName: "xmark")
+                    }
+                }
+            }
+        }
+    }
+}
+
+private struct AddBoolEditor: View {
+    
+    @State private var value: Bool
+    
+    private var apply: (Bool) -> Void
+    
+    init(value: Bool, apply: @escaping (Bool) -> Void) {
+        _value = State(initialValue: value)
+        self.apply = apply
+    }
+    
+    var body: some View {
+        VStack {
+            Toggle("", isOn: $value)
+                .labelsHidden()
+            Button {
+                apply(value)
+            } label: {
+                Text("Apply")
+            }
+            .buttonStyle(.borderedProminent)
+            .padding(.bottom)
+            Spacer()
+        }
+    }
+}

Sources/UserDefaultsUI/Editors/BoolValueEditor.swift

@@ -0,0 +1,18 @@
+import SwiftUI
+
+struct BoolValueEditor: View {
+    
+    @Binding var value: Bool
+       
+    var body: some View {
+        Toggle("", isOn: $value)
+            .labelsHidden()
+    }
+}
+
+// Comment out until Xcode 15 goes live.
+/*
+#Preview {
+    BoolValueEditor(value: .constant(true))
+}
+*/

Sources/UserDefaultsUI/Editors/DoubleValueEditor.swift

@@ -0,0 +1,52 @@
+import SwiftUI
+
+struct DoubleValueEditor: View {
+    
+    @State private var text: String
+    
+    @FocusState private var isFocused: Bool
+    
+    @Environment(\.dismiss) private var dismiss
+    
+    private var apply: (Double) -> Void
+    
+    init(value: Double, apply: @escaping (Double) -> Void) {
+        _text = State(initialValue: String(value))
+        self.apply = apply
+    }
+    
+    var body: some View {
+        VStack {
+            TextField("", text: $text)
+                .labelsHidden()
+                .keyboardType(.numbersAndPunctuation)
+                .focused($isFocused)
+                .padding(.vertical, 4)
+                .padding(.horizontal, 8)
+                .background(Color(white: 0, opacity: 0.05))
+                .cornerRadius(8)
+                .padding()
+                .onAppear {
+                    isFocused = true
+                }
+            Button {
+                let value = Double(text) ?? 0
+                apply(value)
+                text = "\(value)"
+                dismiss()
+            } label: {
+                Text("Apply")
+            }
+            .buttonStyle(.borderedProminent)
+            .padding(.bottom)
+            Spacer()
+        }
+    }
+}
+
+// Comment out until Xcode 15 goes live.
+/*
+#Preview {
+    DoubleValueEditor(value: 3.141592654, apply: { value in print(value) })
+}
+*/