solara 0.1.0

data/solara/lib/core/doctor/doctor_manager.rb

@@ -0,0 +1,35 @@
+Dir.glob("#{__dir__}/*.rb").each { |file| require file }
+Dir.glob("#{__dir__}/validator/*.rb").each { |file| require file }
+Dir.glob("#{__dir__}/brand/*.rb").each { |file| require file }
+Dir.glob("#{__dir__}/../../.solara/core/brands/*.rb").each { |file| require file }
+
+class DoctorManager
+    def initialize
+    end
+
+    def visit_brands(brand_keys = [], print_logs: true)
+        Solara.logger.header("Brand Doctor")
+        ensure_initialized!
+        BrandDoctor.new.visit(brand_keys, print_logs: print_logs)
+    end
+
+    def visit_project!
+        Solara.logger.header("Project Doctor")
+        Solara.logger.start_step("Project Health Check")
+        ensure_initialized!
+        ProjectDoctor.new.visit
+        Solara.logger.end_step("Project Health Check")
+    end
+
+    private
+
+    def ensure_initialized!
+        brands = FilePath.brands
+        brands_list = FilePath.brands_list
+        platform = SolaraSettingsManager.instance.platform
+        unless File.exist?(brands) &&  File.exist?(brands_list) && !platform.nil? && !platform.empty?
+            Solara.logger.error("Solara is not initialized here. Please run 'solara init' to initialize.")
+            exit 1
+        end
+    end
+end

data/solara/lib/core/doctor/project_doctor.rb

@@ -0,0 +1,8 @@
+Dir.glob("#{__dir__}/*.rb").each { |file| require file }
+Dir.glob("#{__dir__}/../../.solara/core/brands/*.rb").each { |file| require file }
+
+class ProjectDoctor
+    def visit
+        ProjectFileSystemValidator.new.validate
+    end
+end

data/solara/lib/core/doctor/schema/brand_configurations.json

@@ -0,0 +1,60 @@
+{
+    "title": "Brand Configurations Schema",
+    "type": "object",
+    "properties": {
+        "solaraVersion": {
+            "type": "string"
+        },
+        "brand": {
+            "type": "object",
+            "properties": {
+                "key": {
+                    "type": "string"
+                },
+                "name": {
+                    "type": "string"
+                }
+            },
+            "required": [
+                "key",
+                "name"
+            ]
+        },
+        "configurations": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "key": {
+                        "type": "string"
+                    },
+                    "name": {
+                        "type": "string"
+                    },
+                    "inputType": {
+                        "type": "string",
+                        "enum": [
+                            "color",
+                            "text"
+                        ]
+                    },
+                    "content": {
+                        "type": "object",
+                        "additionalProperties": {}
+                    }
+                },
+                "required": [
+                    "key",
+                    "name",
+                    "inputType",
+                    "content"
+                ]
+            }
+        }
+    },
+    "required": [
+        "solaraVersion",
+        "brand",
+        "configurations"
+    ]
+}

data/solara/lib/core/doctor/schema/platform/android/android_config.json

@@ -0,0 +1,23 @@
+{
+  "type": "object",
+  "required": [
+    "brandName",
+    "applicationId",
+    "versionName",
+    "versionCode"
+  ],
+  "properties": {
+    "brandName": {
+      "type": "string"
+    },
+    "applicationId": {
+      "type": "string"
+    },
+    "versionName": {
+      "type": "string"
+    },
+    "versionCode": {
+      "type": "number"
+    }
+  }
+}

data/solara/lib/core/doctor/schema/platform/android/android_signing.json

@@ -0,0 +1,23 @@
+{
+  "type": "object",
+  "required": [
+    "storeFile",
+    "keyAlias",
+    "storePassword",
+    "keyPassword"
+  ],
+  "properties": {
+    "storeFile": {
+      "type": "string"
+    },
+    "keyAlias": {
+      "type": "string"
+    },
+    "storePassword": {
+      "type": "string"
+    },
+    "keyPassword": {
+      "type": "string"
+    }
+  }
+}

data/solara/lib/core/doctor/schema/platform/ios/ios_config.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "properties": {
+    "PRODUCT_NAME": {
+      "type": "string",
+      "description": "The name of the product."
+    },
+    "PRODUCT_BUNDLE_IDENTIFIER": {
+      "type": "string",
+      "description": "The bundle identifier of the product."
+    },
+    "MARKETING_VERSION": {
+      "type": "string",
+      "description": "The marketing version of the product."
+    },
+    "BUNDLE_VERSION": {
+      "type": "number",
+      "description": "The bundle version of the product."
+    }
+  },
+  "required": [
+    "PRODUCT_NAME",
+    "PRODUCT_BUNDLE_IDENTIFIER",
+    "MARKETING_VERSION",
+    "BUNDLE_VERSION"
+  ]
+}

data/solara/lib/core/doctor/schema/platform/ios/ios_signing.json

@@ -0,0 +1,27 @@
+{
+  "type": "object",
+  "required": [
+    "CODE_SIGN_IDENTITY",
+    "DEVELOPMENT_TEAM",
+    "PROVISIONING_PROFILE_SPECIFIER",
+    "CODE_SIGN_STYLE",
+    "CODE_SIGN_ENTITLEMENTS"
+  ],
+  "properties": {
+    "CODE_SIGN_IDENTITY": {
+      "type": "string"
+    },
+    "DEVELOPMENT_TEAM": {
+      "type": "string"
+    },
+    "PROVISIONING_PROFILE_SPECIFIER": {
+      "type": "string"
+    },
+    "CODE_SIGN_STYLE": {
+      "type": "string"
+    },
+    "CODE_SIGN_ENTITLEMENTS": {
+      "type": "string"
+    }
+  }
+}

data/solara/lib/core/doctor/schema/platform/shared/theme.json

@@ -0,0 +1,48 @@
+{
+  "type": "object",
+  "properties": {
+    "colors": {
+      "type": "object",
+      "properties": {
+      },
+      "required": []
+    },
+    "typography": {
+      "type": "object",
+      "properties": {
+        "fontFamily": {
+          "type": "object",
+          "properties": {
+          },
+          "required": []
+        },
+        "fontSize": {
+          "type": "object",
+          "properties": {
+          },
+          "required": []
+        }
+      },
+      "required": ["fontFamily", "fontSize"]
+    },
+    "spacing": {
+      "type": "object",
+      "properties": {
+      },
+      "required": []
+    },
+    "borderRadius": {
+      "type": "object",
+      "properties": {
+      },
+      "required": []
+    },
+    "elevation": {
+      "type": "object",
+      "properties": {
+      },
+      "required": []
+    }
+  },
+  "required": ["colors", "typography", "spacing", "borderRadius", "elevation"]
+}

data/solara/lib/core/doctor/validator/brand_settings_validator.rb

@@ -0,0 +1,55 @@
+class BrandSettingsValidator
+    def validate_properties(property_names, file_path_method, issue_type:)
+        property_names.flat_map { |property_name|
+            validate_single_property(property_name, file_path_method, issue_type: issue_type)
+        }
+    end
+
+    def validate_single_property(property_name, file_path_method, issue_type:)
+        validation_result = gather_property_data(property_name, file_path_method, issue_type: issue_type)
+        validation_result[:issues]
+    end
+
+    def validate_property_duplicates(property_name, file_path_method, issue_type:)
+        validation_result = gather_property_data(property_name, file_path_method, issue_type: issue_type)
+        property_value_to_brands_map = validation_result[:property_value_to_brands_map]
+        identify_duplicate_properties(property_value_to_brands_map, issue_type: issue_type)
+    end
+
+    private
+
+    def gather_property_data(property_name, file_path_method, issue_type:)
+        brands = BrandsManager.instance.brands_list
+        issues = []
+        property_value_to_brands_map = {}
+
+        brands.each do |brand|
+            brand_key = brand['key']
+            property_value = fetch_json_property(property_name, FilePath.public_send(file_path_method, brand_key))
+
+            if property_value.to_s.strip.empty?
+                issues << Issue.new(issue_type, "#{brand_key}: (#{property_name}) is empty.")
+                next
+            end
+
+            map_key = "#{property_value} for #{property_name}"
+            (property_value_to_brands_map[map_key] ||= []) << brand_key
+        end
+
+        { issues: issues, property_value_to_brands_map: property_value_to_brands_map }
+    end
+
+    def fetch_json_property(property, file_path)
+        JSON.parse(File.read(file_path))[property]
+    rescue JSON::ParserError, Errno::ENOENT => e
+        raise Issue.error("Error reading JSON file at #{file_path}: #{e.message}")
+    end
+
+    def identify_duplicate_properties(property_value_to_brands_map, issue_type:)
+        property_value_to_brands_map.each_with_object([]) do |(property_value, brand_keys), issues|
+            if brand_keys.size > 1
+                issues << Issue.new(issue_type, "[#{brand_keys.join(', ')}]: Duplicate value #{property_value}")
+            end
+        end
+    end
+end

data/solara/lib/core/doctor/validator/brand_settings_validator_manager.rb

@@ -0,0 +1,82 @@
+class BrandSettingsValidatorManager
+
+    def initialize
+        @validator = BrandSettingsValidator.new
+    end
+
+    def validate
+        issues = ios_config
+        issues += ios_signing
+        issues += android_config
+        issues + android_signing
+    end
+
+    def ios_config
+        issues = @validator.validate_properties(
+            %w[MARKETING_VERSION BUNDLE_VERSION],
+            :ios_config,
+            issue_type: Issue::ERROR)
+
+        issues += @validator.validate_single_property(
+            'PRODUCT_NAME',
+            :ios_config,
+            issue_type: Issue::ERROR)
+
+        issues += @validator.validate_property_duplicates(
+            'PRODUCT_NAME',
+            :ios_config,
+            issue_type: Issue::WARNING)
+
+        issues += @validator.validate_single_property(
+            'PRODUCT_BUNDLE_IDENTIFIER',
+            :ios_config,
+            issue_type: Issue::ERROR)
+
+        issues + @validator.validate_property_duplicates(
+            'PRODUCT_BUNDLE_IDENTIFIER',
+            :ios_config,
+            issue_type: Issue::ERROR)
+    end
+
+    def ios_signing
+        @validator.validate_properties(
+            %w[CODE_SIGN_IDENTITY DEVELOPMENT_TEAM PROVISIONING_PROFILE_SPECIFIER CODE_SIGN_STYLE CODE_SIGN_ENTITLEMENTS],
+            :ios_brand_signing,
+            issue_type: Issue::WARNING)
+    end
+
+    def android_signing
+        @validator.validate_properties(
+            %w[storeFile keyAlias storePassword keyPassword],
+            :android_brand_signing,
+            issue_type: Issue::WARNING)
+    end
+
+    def android_config
+        issues = @validator.validate_properties(
+            %w[versionName versionCode],
+            :android_config,
+            issue_type: Issue::ERROR)
+
+        issues += @validator.validate_single_property(
+            'brandName',
+            :android_config,
+            issue_type: Issue::ERROR)
+
+        issues += @validator.validate_property_duplicates(
+            'brandName',
+            :android_config,
+            issue_type: Issue::WARNING)
+
+        issues += @validator.validate_single_property(
+            'applicationId',
+            :android_config,
+            issue_type: Issue::ERROR)
+
+        issues + @validator.validate_property_duplicates(
+            'applicationId',
+            :android_config,
+            issue_type: Issue::ERROR)
+    end
+
+end

data/solara/lib/core/doctor/validator/directory_structure_validator.rb

@@ -0,0 +1,38 @@
+Dir[File.expand_path('*.rb', __dir__)].each { |file| require_relative file }
+
+class DirectoryStructure
+    attr_reader :path, :use_glob
+
+    def initialize(path, use_glob: true)
+        @path = path
+        @use_glob = use_glob
+    end
+
+    def self.expand(pattern, use_glob: true)
+        if use_glob
+            Dir.glob(pattern).select { |path| File.directory?(path) }.map do |path|
+                DirectoryStructure.new(path, use_glob: use_glob)
+            end
+        else
+            [DirectoryStructure.new(pattern, use_glob: use_glob)]
+        end
+    end
+end
+
+class DirectoryStructureValidator < ValidationStrategy
+    def initialize(dir)
+        @dir = dir
+    end
+
+    def validate(project_path)
+        full_path = File.join(project_path, @dir.path)
+        paths = @dir.use_glob ? DirectoryStructure.expand(full_path) : [@dir]
+
+        if paths.any? { |path| File.directory?(path.path) }
+            Solara.logger.passed("Directory exists: '#{@dir.path}'")
+        else
+            raise ValidationError, "Directory missing: '#{@dir.path}'"
+        end
+    end
+
+end

data/solara/lib/core/doctor/validator/file_structure_validator.rb

@@ -0,0 +1,37 @@
+Dir[File.expand_path('*.rb', __dir__)].each { |file| require_relative file }
+
+class FileStructure
+    attr_reader :path, :use_glob
+
+    def initialize(path, use_glob: true)
+        @path = path
+        @use_glob = use_glob
+    end
+
+    def self.expand(pattern, use_glob: true)
+        if use_glob
+            Dir.glob(pattern).select { |path| File.file?(path) }.map do |path|
+                FileStructure.new(path, use_glob: use_glob)
+            end
+        else
+            [FileStructure.new(pattern, use_glob: use_glob)]
+        end
+    end
+end
+
+class FileStructureValidator < ValidationStrategy
+    def initialize(file)
+        @file = file
+    end
+
+    def validate(project_path)
+        full_path = File.join(project_path, @file.path)
+        paths = @file.use_glob ? FileStructure.expand(full_path) : [@file]
+
+        if paths.any? { |path| File.file?(path.path) }
+            Solara.logger.passed("File exists: '#{@file.path}'")
+        else
+            raise ValidationError, "File missing: '#{@file.path}'"
+        end
+    end
+end

data/solara/lib/core/doctor/validator/json_file_validator.rb

@@ -0,0 +1,21 @@
+Dir.glob("#{__dir__}/*.rb").each { |file| require file }
+
+require 'json'
+
+class JsonFileValidator < ValidationStrategy
+    def initialize(json_files)
+        @json_files = json_files
+    end
+
+    def validate(project_path = nil)
+        @json_files.each do |json_file|
+            begin
+                path = json_file
+                JSON.parse(File.read(path))
+                Solara.logger.passed("Valid JSON: #{path}")
+            rescue JSON::ParserError => e
+                raise ValidationError, "Not valid JSON: #{path}. Error: #{e.message}"
+            end
+        end
+    end
+end

data/solara/lib/core/doctor/validator/json_schema_validator.rb

@@ -0,0 +1,32 @@
+Dir.glob("#{__dir__}/*.rb").each { |file| require file }
+require 'json'
+require 'json-schema'
+
+class JsonSchemaValidator < ValidationStrategy
+    def initialize(schema_file, json_file)
+        @schema_file = schema_file
+        @json_file = json_file
+    end
+
+    def validate(project_path = nil)
+
+        unless File.exist?(@schema_file)
+            raise ValidationError, "Schema file not found: #{@schema_file}"
+        end
+
+        begin
+            json_content = JSON.parse(File.read(@json_file))
+        rescue
+            # Ignore as it's not its responsibility
+            return
+        end
+        schema = JSON.parse(File.read(@schema_file))
+        errors = JSON::Validator.fully_validate(schema, json_content)
+
+        if errors.empty?
+            Solara.logger.passed("Valid according to schema: #{@json_file}")
+        else
+            raise ValidationError, "#{@json_file}: #{errors.join(', ')}."
+        end
+    end
+end

data/solara/lib/core/doctor/validator/project_filesystem_validator.rb

@@ -0,0 +1,70 @@
+class ProjectFileSystemValidator
+
+    def initialize
+        @project_root = SolaraSettingsManager.instance.project_root
+        @platform = SolaraSettingsManager.instance.platform
+    end
+
+    def validate
+        file_system = project_filesystem
+        manager = InteractiveFileSystemValidator.new(@project_root, ProjectSettingsManager.instance)
+        manager.start(file_system)
+    end
+
+    def project_filesystem
+        case @platform
+        when Platform::Flutter
+            android_file_system + ios_file_system
+        when Platform::IOS
+            ios_file_system
+        when Platform::Android
+            android_file_system
+        else
+            raise ArgumentError, "Invalid platform: #{@platform}"
+        end
+    end
+
+    def android_file_system
+        [
+            {
+                name: FilePath.gradle_name,
+                path: File.join(FilePath.android_project_relative_root),
+                key: 'build.gradle',
+                type: 'file',
+                recursive: false,
+                platform: Platform::Android
+            },
+            {
+                name: FilePath.gradle_name,
+                path: File.join(FilePath.android_project_relative_root, 'app'),
+                key: 'app/build.gradle',
+                type: 'file',
+                recursive: false,
+                platform: Platform::Android,
+            }
+        ]
+    end
+
+    def ios_file_system
+        [
+            {
+                name: '*.xcodeproj',
+                key: 'xcodeproj',
+                type: 'folder',
+                platform: Platform::IOS,
+            },
+            {
+                name: 'Assets.xcassets',
+                key: 'Assets.xcassets',
+                type: 'folder',
+                platform: Platform::IOS,
+            },
+            {
+                name: 'Info.plist',
+                key: 'Info.plist',
+                type: 'file',
+                platform: Platform::IOS,
+            }
+        ]
+    end
+end

data/solara/lib/core/doctor/validator/template/android_template_validation_config.yml

@@ -0,0 +1,51 @@
+structure:
+    android:
+        type: directory
+        contents:
+            assets:
+                type: directory
+            res:
+                type: directory
+            android_config.json:
+                type: file
+                validations:
+                    - type: valid_json
+                    - type: json_schema
+                      schema_path: platform/android/android_config.json
+            android_signing.json:
+                type: file
+                validations:
+                    - type: valid_json
+                    - type: json_schema
+                      schema_path: platform/android/android_signing.json
+    ios:
+        type: directory
+        contents:
+            assets:
+                type: directory
+            ios_config.json:
+                type: file
+                validations:
+                    - type: valid_json
+                    - type: json_schema
+                      schema_path: platform/ios/ios_config.json
+            ios_signing.json:
+                type: file
+                validations:
+                    - type: valid_json
+                    - type: json_schema
+                      schema_path: platform/ios/ios_signing.json
+    shared:
+        type: directory
+        contents:
+            brand_config.json:
+                type: file
+                validations:
+                    - type: valid_json
+            theme.json:
+                type: file
+                validations:
+                    - type: valid_json
+                    - type: json_schema
+                      schema_path: platform/shared/theme.json
+strict: false