upm_support 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bdccee4a391fc96e977f141b354b0480f25a95af8a923f410986c3bb761b96d1
+  data.tar.gz: 909e6c8f2ab2ee6f331692e22935aabdd2c3e0cdafac0e78ad13b4801ba55366
+SHA512:
+  metadata.gz: 62e5ac97f852f50b179c1a19f63b034d914aa6ddfc31b74be3aece501979e7c45d9e6ad378e4fddfa1dd1c5de1f627b38277b3ab700fe2e01c519c42d1ad9b4e
+  data.tar.gz: bf855ba5fb3b34c7377744acb71b841ace529290480bf11409e90b680cab5ab5a291ec0f0c5502db52949fef3f77fc618f5c914b804d9e21a7fbf2740043140d

data/.gitignore

@@ -0,0 +1 @@
+spec/upm_support/assets/test_*

data/.rubocop.yml

@@ -0,0 +1,81 @@
+#
+#   File.chmod(0777, f)
+#
+# is easier to read than
+#
+#   File.chmod(0o777, f)
+#
+require:
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  #Include:
+  #  - '**/fastlane/Fastfile'
+  #Exclude:
+  #  - 'vendor/**/*'
+  #  - './fastlane-plugin-u3d/**/*'
+
+# broken in 0.52.1
+Layout/EmptyLinesAroundArguments:
+  Enabled: false
+
+Style/NumericLiteralPrefix:
+  Enabled: false
+
+Style/StringLiterals:
+  Enabled: false # we're not there yet
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/BlockLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Max: 8
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+Metrics/MethodLength:
+  Enabled: false
+
+# Configuration parameters: AllowURI, URISchemes.
+Layout/LineLength:
+  Max: 370
+
+# We're not there yet
+Style/Documentation:
+  Enabled: false
+
+# Better too much 'return' than one missing
+Style/RedundantReturn:
+  Enabled: false
+
+# Tell Windows to look the other way
+Layout/EndOfLine:
+  EnforcedStyle: lf
+
+# Some issues with rspec style
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+
+RSpec/MultipleDescribes:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false
+
+Rspec/RSpec/FilePath:
+  Enabled: false
+
+Lint/EmptyBlock:
+  Enabled: false

data/DEVELOPPING.md

@@ -0,0 +1,69 @@
+# Setting up CI
+
+on agent
+
+1. install npm
+
+brew install npm
+
+2. log in npm
+
+npm login --registry 'https://upm.dragonbox.com'
+
+(user: jenkins, Password in 1Password)
+
+# Developping a UPM package
+
+See the official layout https://docs.unity3d.com/Manual/cus-layout.html
+
+## Testing your packages from another Unity Project
+
+using git, example
+
+```
+    "com.dragonbox.simple-build": "ssh://git@bitbucket.org/WeWantToKnow/wwtk.simplebuild.git?path=Assets/SimpleBuild#task/upm/migration",
+```
+
+More here https://docs.unity3d.com/Manual/upm-git.html
+
+## or using an UPM
+
+```
+ "scopedRegistries": [
+    {
+      "name": "DragonBox",
+      "url": "https://upm.dragonbox.com/",
+      "scopes": [
+        "com.dragonbox"
+      ]
+    }
+  ],
+  "dependencies": {
+    "com.dragonbox.simple-build": "1.2.1",
+```
+using a local verdaccio
+
+## test building using our infra
+
+```
+UPM_REGISTRY=http://127.0.0.1:4873 bundle exec fastlane unity_package build_unity_package
+```
+
+test publishing using our infra
+
+```
+UPM_REGISTRY=http://127.0.0.1:4873 bundle exec fastlane unity_package publish_upm_modules
+```
+
+
+# Importing third party packages
+
+Google provides packages but no UPM support
+
+https://developers.google.com/unity/instructions#install-tgz
+
+Just upload them like this
+
+```
+npm publish --registry https://upm.dragonbox.com com.google.external-dependency-manager-1.2.170.tgz
+```

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+ruby '2.7.4'
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,70 @@
+PATH
+  remote: .
+  specs:
+    upm_support (0.0.2)
+      rexml
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    diff-lcs (1.5.0)
+    parallel (1.22.1)
+    parser (3.1.2.0)
+      ast (~> 2.4.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.3.1)
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    rspec_junit_formatter (0.5.1)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    rubocop (1.28.2)
+      parallel (~> 1.10)
+      parser (>= 3.1.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.17.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.17.0)
+      parser (>= 3.1.1.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.10.0)
+      rubocop (~> 1.19)
+    ruby-progressbar (1.11.0)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  arm64-darwin-21
+  x86_64-darwin-21
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  rake (~> 13.0)
+  rspec (~> 3.11.0)
+  rspec_junit_formatter (~> 0.5.1)
+  rubocop (~> 1.27)
+  rubocop-rake (~> 0.6.0)
+  rubocop-rspec (~> 2.10.0)
+  upm_support!
+
+RUBY VERSION
+   ruby 2.7.4p191
+
+BUNDLED WITH
+   2.3.13

data/MIGRATION.md

@@ -0,0 +1,140 @@
+# Migrating from Uplift
+
+## Edit the jenkins job
+
+### Edit the JENKINS_PARAM_LANE_ENV env variable
+
+```
+Artifact
+GithubRepository
+UnityPackageRegistry
+```
+
+### edit the "archive the artifacts" config
+
+```
+u3d*.log
+```
+
+## Update the project dependencies
+
+### upgrade ruby in project
+
+minimum 2.7.4
+
+```
+cp ../../DevInfra/fastlane_setup/Gemfile .
+```
+
+or (doesn't get all the necessary updates)
+
+```
+sed -i '' -e 's/ruby \"2.5.3\"/ruby \"2.7.4\"/' Gemfile && rvm use 2.7.4 && bundle install && git add Gemfile* && git commit -m "Upgrade ruby to 2.7.4"
+```
+
+### upgrade unity
+
+We need minimum 2019.4.9f1
+
+Start unity and and reserialize (if you have SimpleBuild)
+
+```
+u3d -u 2019.4.9f1
+or
+u3d -u 2019.4.31f1
+```
+
+Update the .gitignore
+
+Commit
+
+```
+git add .gitignore
+git add Packages/
+git add ProjectSettings/
+git commit -am "Upgraded to Unity 2019.LTS"
+```
+
+### latest fastlane_setup
+
+in particular Gemfile requirements (should have been done if you copied the Gemfile from fastlane_setup earlier)
+
+```
+gem 'upm_support', git: 'git@bitbucket.org:WeWantToKnow/upm_support.git'
+```
+
+## remove already uplifted dependencies
+
+The upm_support package can also be used from your developper machine to help speeding up migration a bit.
+
+```
+git clone git@bitbucket.org:WeWantToKnow/upm_support.git
+
+export PATH=/Users/lacostej/Code/WWTK/DevInfra/upm_migration/exe/:$PATH
+```
+
+### upgrade packages to their latest deps
+
+```
+migrate.rb to_upm [--force-upgrade]
+```
+
+```
+migrate.rb clean_upbring
+```
+
+open unity and resolve dependencies and commit
+
+git add Packages/ 	
+
+### Create the layout and ASMDEFs
+
+1. move all required dependencies for the package (not the projects) into UPM
+2. regroup all parts of the package under a single folder. E.g. `Assets/YourPackage/` or `Assets/DragonBox.YourPackage/`
+3. create the `Editor/` and `Runtime/` subfolders and a default [package.json](FIXME). Use an experimental version number (`-exp.X` suffix) at start.
+4. move relevant resources (code, assets, etc) under these folders
+5. add dependencies to the `package.json` as needed
+  See [this package.json example](https://bitbucket.org/WeWantToKnow/wwtk.crashreporter/src/master/Assets/CrashReporter/package.json)
+6. Create the [ASDMDEFs](https://docs.unity3d.com/Manual/ScriptCompilationAssemblyDefinitionFiles.html#reference-and-assemblies) and add [Assembly Definition references](https://docs.unity3d.com/Manual/class-AssemblyDefinitionReferenceImporter.html) as needed
+  See this [ASMDEF example](https://bitbucket.org/WeWantToKnow/wwtk.crashreporter/src/master/Assets/CrashReporter/Runtime/DragonBox.CrashReporter.Runtime.asmdef)
+7. double check if tests are still running properly by running them from the Unity test runner.
+8. commit files in your branch and push feature branch to repo
+9. test package in a different project using e.g. the [git import package syntax](DEVELOPPING.md)
+10. iterate by bumping the package version number and pushing to your branch
+
+When stable, test the infra further
+
+1. merge branch, and check the jenkins Artifact build
+2. bump to stable version in `package.json` (remove `-exp.X` suffix) and push
+3. Run a UPM package build (will publish to our internal repository)
+4. test importing your package into your projects (you can use the `migrate.rb` tool again to upgrade the dependencies locally inside your project(s))
+
+
+If your package is usually depended upon by projects, then add an entry in the [Uplift to UPM mapping](https://bitbucket.org/WeWantToKnow/upm_support/src/master/lib/assets/migrations.json) to ease migration.
+
+
+## Clean up Uplift support
+
+```
+git rm Upfile*
+git rm Assets/Plugins/Editor/Uplift/Uplift.dll*
+git rm Assets/Plugins/Editor/Uplift.meta
+git grep 5d250b32d4a234419b8b94fff388f1fc Assets/*.asset | cut -d ':' -f 1 | xargs git rm 
+git rm Assets/*Upset.xml*
+```
+
+Clean .env files, remove
+
+FASTLANE_UPLIFT_TASKS
+JENKINS_ARTIFACTS
+
+
+
+## Clean up Jenkins job
+
+### Edit the JENKINS_PARAM_LANE_ENV env variable
+
+```
+Artifact
+UnityPackageRegistry
+```

data/Rakefile

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new do |task|
+  task.requires << 'rubocop-rake'
+end
+
+desc 'Run all rspec tests'
+task :test_all do
+  formatter = '--format progress'
+  if ENV['CIRCLECI']
+    Dir.mkdir('/tmp/rspec/')
+    formatter += ' -r rspec_junit_formatter --format RspecJunitFormatter -o /tmp/rspec/rspec.xml'
+    TEST_FILES = `(circleci tests glob "spec/**/*_spec.rb" | circleci tests split --split-by=timings)`.tr!("\n", ' ')
+    rspec_args = "#{formatter} #{TEST_FILES}"
+  else
+    formatter += ' --pattern "./spec/**/*_spec.rb"'
+    rspec_args = formatter
+  end
+  sh "rspec #{rspec_args}"
+end
+
+task default: %i[rubocop test_all]

data/VERDACCIO.md

@@ -0,0 +1,34 @@
+# Basic verdaccio notes
+
+## Local install verdaccio
+
+```
+npm install -g verdaccio
+```
+
+## Optionally change listen port 
+
+```
+listen:
+  - 0.0.0.0:4873
+```
+
+to your config
+
+## Adduser/login
+
+```
+npm adduser --registry http://127.0.0.1:4873
+```
+
+## Start publishing (from a folder containing a package.json)
+
+```
+npm publish --registry http://127.0.0.1:4873
+```
+
+## View packages
+
+```
+npm view --json com.dragonbox.simple-build --registry http://127.0.0.1:4873
+```

data/exe/migrate.rb

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/upm_support'
+
+UpmSupport::Runner.run(ARGV)

data/lib/assets/migrations.json

@@ -0,0 +1,17 @@
+{
+	"wwtk.SimpleBuild": "com.dragonbox.simple-build",
+	"wwtk.Authenticator": "com.dragonbox.authenticator",
+	"wwtk.CrashReporter": "com.dragonbox.crash-reporter",
+	"DragonBox.Net": "com.dragonbox.net",
+	"wwtk.OAuth": "com.dragonbox.oauth",
+	"wwtk.OAuthAsync": "com.dragonbox.oauth-async",
+	"wwtk.OAuthRx": "com.dragonbox.oauth-rx",
+	"wwtk.OAuthenticator": "com.dragonbox.oauthenticator",
+	"wwtk.Core": "com.dragonbox.core",
+	"GoogleExternalDependencyManagerForUnity": "com.google.external-dependency-manager",
+	"GooglePlayReview": "com.google.play.review",
+	"wwtk.Glocalization": "com.dragonbox.glocalization",
+	"wwtk.Glocalization.TMProFontPlugin": "com.dragonbox.glocalization.tmpro-font-plugin",
+	"wwtk.Fonts": "com.dragonbox.fonts",
+	"wwtk.MathExpressionFormatter": "com.dragonbox.math-expression-formatter"
+}

data/lib/upm_support/actions.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require_relative 'uplift'
+require_relative 'unity'
+require 'fileutils'
+
+module UpmSupport
+  class Actions
+    def self.migrate_dependencies_to_upm(dir, migrations, registry_uri, force_upgrade: false)
+      up = UnityProject.new(dir)
+      raise "Unity Project to migrate is too old (#{up.version}), some features might break. Consider upgrading to at least #{up.minimum_supported} first" unless up.is_minimum_supported?
+
+      unless File.exist?("#{dir}/Upfile.lock")
+        puts "No Upfile.lock here. Exiting"
+        exit(-1)
+      end
+      upfile_lock = UpfileLock.new("#{dir}/Upfile.lock")
+      upm_packages = UPMPackages.new("#{dir}/Packages/manifest.json")
+
+      changed = false
+      registry = UpmRegistry.new(registry_uri)
+      upfile_lock.dependencies.each do |uplift_package, version|
+        next unless migrations.keys.include? uplift_package
+
+        upm_package = migrations[uplift_package]
+
+        replacement_version = nil
+        if force_upgrade
+          puts "Trying to upgrade #{uplift_package} to the latest UPM one"
+
+          candidate_versions = registry.versions(upm_package)
+          if candidate_versions.empty?
+            puts 'None found'
+            next
+          end
+          replacement_version = candidate_versions.last
+        else
+          puts "checking if #{uplift_package}@#{version} has an equivalent UPM one"
+
+          versions = registry.versions(upm_package)
+          candidate_versions = versions.filter { |v| v == version || v =~ /#{version}-exp./ }
+          if candidate_versions.empty?
+            puts 'None found'
+            next
+          end
+          replacement_version = if candidate_versions.include? version
+                                  version
+                                else
+                                  candidate_versions.last # assume in order of releases....
+                                end
+        end
+        puts "Replacing #{uplift_package}@#{version} with #{upm_package}@#{replacement_version}"
+        upfile_lock.remove_dependency(uplift_package, version)
+        upm_packages.add_dependency(upm_package, replacement_version)
+        changed = true
+      end
+      return unless changed
+
+      dragonbox_registry_present = upm_packages.scoped_registries.map { |r| r['url'] }.include? registry_uri
+      upm_packages.add_scoped_registry('DragonBox', registry_uri, ['com.dragonbox']) unless dragonbox_registry_present
+
+      upm_packages.save
+      upfile_lock.save
+      command = "git diff #{upfile_lock.path} #{upm_packages.path}"
+      puts `#{command}`
+    end
+
+    def self.remove_deleted_uplift_assets(dir)
+      upbring_path = "#{dir}/UPackages/Upbring.xml"
+      unless File.exist? upbring_path
+        puts "No Uplift setup to deal with"
+        return
+      end
+      upbring = Upbring.new(upbring_path)
+
+      upfile_lock_path = "#{dir}/Upfile.lock"
+      upfile_lock = nil
+      upfile_lock = UpfileLock.new(upfile_lock_path) if File.exist?(upfile_lock_path)
+
+      upbring.installed_packages.each do |ip|
+        if upfile_lock
+          puts "Searching for #{ip.name} #{ip.version}"
+          dependency = upfile_lock.dependencies[ip.name]
+          if dependency == ip.version
+            puts "Dependency #{ip.name}@#{ip.version} still in Upfile.lock"
+            next
+          end
+        end
+
+        puts "Dependency #{ip.name}@#{ip.version} not in Upfile.lock anymore, cleaning up"
+        is_with_guids = ip.install_specs.reject { |is| is.guid.nil? }
+        is_with_guids.each do |is|
+          # search for asset
+          is_guid = is.guid
+          command = "grep -r \"^guid: #{is_guid}\" '#{dir}/Assets' --include '*.meta' | cut -d ':' -f 1"
+          # FIXME you can have multiple results here, and you should exclude those that are in git...
+          metapath = `#{command}`.strip.split("\n").first
+
+          # if found
+          if metapath != ""
+            path = File.join(File.dirname(metapath),File.basename(metapath, '.meta'))
+            [path, metapath].each do |file|
+              if !File.exist?(file)
+                puts "ERROR: file #{file} doesn't exist"
+                next
+              end
+              puts "Deleting #{file}"
+              File.delete(file)
+            end
+          end
+
+          upbring.remove_package(ip.name)
+          upbring.save
+        end
+
+        is_with_paths = ip.install_specs.reject { |is| is.path.nil? }
+        is_with_paths.each do |is|
+          path = "#{dir}/#{is.path}"
+          if Dir.exist? path
+            puts "Deleting #{path} recursively"
+            FileUtils.rm_r path
+          end
+        end
+      end
+      self.clean_empty_dirs
+    end
+
+
+    def self.clean_empty_dirs
+      empty_dirs = Dir.glob("Assets/**/*").filter{|f| Dir.exist?(f)}.select{|d| Dir.empty?(d) }
+
+      while empty_dirs.count > 0
+        empty_dirs.each{|empty_dir| Dir.rmdir(empty_dir)}
+        parent_empty_dirs = empty_dirs.map{|d| File.dirname(d)}.uniq
+        while true do
+            deleted = []
+            parent_empty_dirs.each do |dir|
+                metas = Dir.glob("#{dir}/*.meta")
+                meta_and_non_metas = metas.map{|meta| [meta, File.join(File.dirname(meta), File.basename(meta, ".meta"))] }
+                to_delete = meta_and_non_metas.select{|a| File.exist?(a[0]) and !File.exist?(a[1])}
+                deleted.concat(to_delete)
+                to_delete.each{|a| puts "Deleting #{a[0]}"; File.delete(a[0])}
+            end
+            break if deleted.count == 0
+            sleep 0.1 # give it some time to delete things
+        end
+        empty_dirs = parent_empty_dirs.select{|d| Dir.glob("#{d}/**").count == 0}.uniq
+      end
+    end
+  end
+end

data/lib/upm_support/unity.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'English'
+require 'yaml'
+
+module UpmSupport
+  class UPMPackages
+    attr_reader :path
+
+    def initialize(path)
+      @path = path
+      @content = JSON.parse(File.read(path))
+    end
+
+    def scoped_registries
+      @content['scopedRegistries'] = [] unless @content['scopedRegistries']
+      @content['scopedRegistries'] || []
+    end
+
+    def add_scoped_registry(name, uri, scopes)
+      @content['scopedRegistries'] = [] unless @content['scopedRegistries']
+      @content['scopedRegistries'] <<
+        {
+          'name' => name,
+          'url' => uri,
+          'scopes' => scopes
+        }
+    end
+
+    def dependencies
+      @content['dependencies']
+    end
+
+    def add_dependency(name, version)
+      old_deps = dependencies
+      @content['dependencies'] = { name => version }.merge(old_deps)
+    end
+
+    def save
+      File.write(@path, JSON.pretty_generate(@content))
+    end
+  end
+
+  class UpmRegistry
+    def initialize(uri)
+      @registry_uri = uri
+    end
+
+    def exist?(package, version)
+      command = "npm view --json #{package}@#{version} --registry '#{@registry_uri}'"
+      output = `#{command} 2> /dev/null`
+      if $CHILD_STATUS.exitstatus.positive?
+        false
+      else
+        output.length.positive?
+      end
+    end
+
+    def versions(package)
+      command = "npm view --json #{package} --registry '#{@registry_uri}'"
+      output = `#{command} 2> /dev/null`
+      if $CHILD_STATUS.exitstatus.positive?
+        []
+      else
+        JSON.parse(output)['versions']
+      end
+    end
+  end
+
+  class UnityProject
+    def initialize(dir)
+      @dir = dir
+    end
+
+    def version
+      Gem::Version.new(YAML.safe_load(File.read("#{@dir}/ProjectSettings/ProjectVersion.txt"))['m_EditorVersion'])
+    end
+
+    def minimum_supported
+      Gem::Version.new("2019.4.9f1")
+    end
+
+    def is_minimum_supported?
+      minimum_supported <= version
+    end
+  end
+end

data/lib/upm_support/uplift.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'rexml/document'
+
+module UpmSupport
+  class UpfileLock
+    attr_reader :path
+
+    def initialize(path)
+      @path = path
+      @content = File.read(path).split("\n")
+    end
+
+    def dependencies
+      idx = @content.index('# SOLVED DEPENDENCIES')
+      @content[(idx + 1)..].grep(/^[A-z]/).to_h do |l|
+        m = l.match(/(.*) \((.*)\)/)
+        [m[1], m[2]]
+      end
+    end
+
+    def remove_dependency(name, version)
+      idx = @content.index('# SOLVED DEPENDENCIES')
+      @content = @content.reject.each_with_index { |l, ix| ix > idx and l =~ /^#{name} \(#{version}\)/ }
+    end
+
+    def save
+      File.write(@path, @content.join("\n"))
+    end
+  end
+
+  class InstallSpec
+    attr_reader :type, :path, :guid
+
+    def initialize(type: nil, path: nil, guid: nil)
+      @type = type
+      @path = path
+      @guid = guid
+    end
+  end
+
+  class InstalledPackage
+    attr_reader :name, :version, :install_specs
+
+    def initialize(name, version, install_specs)
+      @name = name
+      @version = version
+      @install_specs = install_specs
+    end
+  end
+
+  class Upbring
+    include REXML
+
+    attr_reader :path
+
+    def initialize(path)
+      @path = path
+      @doc = File.open(path) do |f|
+        REXML::Document.new f
+      rescue => e
+        raise "Unable to open your Upbring file in #{@path}. You might need to clean your project, #{e}"
+      end
+    end
+
+    def installed_packages
+      install_specs = XPath.match(@doc.root, '/Upbring/InstalledPackage').map do |ip|
+        name = ip['Name']
+        version = ip['Version']
+        install_specs = XPath.match(ip, './Install').map do |e|
+          InstallSpec.new(type: e['Type'], path: e['Path'], guid: e['Guid'])
+        end
+        InstalledPackage.new(name, version, install_specs)
+      end
+    end
+
+    def installed_package(name)
+      installed_packages.select { |ip| ip.name == name }.first
+    end
+
+    def remove_package(name)
+      upbring_elt = XPath.match(@doc.root, '/Upbring')
+      elt_to_remove = XPath.match(upbring_elt, "./InstalledPackage[@Name='#{name}']")
+      return nil unless elt_to_remove.count.positive?
+
+      upbring_elt.first.delete(elt_to_remove.first)
+    end
+
+    def save
+      File.open(@path, 'w') do |f|
+        @doc.write(f)
+      end
+    end
+  end
+end

data/lib/upm_support/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module UpmSupport
+  VERSION = '0.0.2'
+  DESCRIPTION = 'Provides tools for supporting UPM.'
+end

data/lib/upm_support.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'upm_support/uplift'
+require_relative 'upm_support/unity'
+require_relative 'upm_support/actions'
+
+module UpmSupport
+	class Runner
+		def self.run(args)
+			actions = %w[to_upm clean_upbring]
+			action = args[0]
+
+			migrations_file_path = File.join(File.dirname(__FILE__) + "/assets/migrations.json")
+
+			migrations = JSON.parse(File.read(migrations_file_path))
+
+			registry_uri = ENV.fetch('UPM_REGISTRY', 'https://upm.dragonbox.com')
+
+			puts "Migrating action #{action}"
+
+			case action
+			when 'to_upm'
+			  Actions.migrate_dependencies_to_upm('.', migrations, registry_uri, force_upgrade: args.include?("--force-upgrade"))
+			when 'clean_upbring'
+			  Actions.remove_deleted_uplift_assets('.')
+			else
+			  raise "Unknown action #{action}. Use any of #{actions.join(',')}"
+			end
+		end
+	end
+end

data/upm_support.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'upm_support/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'upm_support'
+  spec.version     = UpmSupport::VERSION
+  spec.authors     = ['Jerome Lacoste']
+  spec.email       = 'jeromel@kahoot.com'
+
+  spec.required_ruby_version = '>= 2.7.4'
+
+  spec.summary     = 'UpmSupport'
+  spec.description = UpmSupport::DESCRIPTION
+
+  spec.homepage    = 'https://bitbucket.org/WeWantToKnow/upm_migration'
+  spec.license     = 'Proprietary'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'rexml' # rexml was unbundled from the stdlib in ruby 3
+  # Development only
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.11.0'
+  spec.add_development_dependency 'rspec_junit_formatter', '~> 0.5.1'
+  spec.add_development_dependency 'rubocop', '~> 1.27'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.6.0'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.10.0'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: upm_support
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Jerome Lacoste
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2023-11-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.11.0
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.27'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.10.0
+description: Provides tools for supporting UPM.
+email: jeromel@kahoot.com
+executables:
+- migrate.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- DEVELOPPING.md
+- Gemfile
+- Gemfile.lock
+- MIGRATION.md
+- Rakefile
+- VERDACCIO.md
+- exe/migrate.rb
+- lib/assets/migrations.json
+- lib/upm_support.rb
+- lib/upm_support/actions.rb
+- lib/upm_support/unity.rb
+- lib/upm_support/uplift.rb
+- lib/upm_support/version.rb
+- upm_support.gemspec
+homepage: https://bitbucket.org/WeWantToKnow/upm_migration
+licenses:
+- Proprietary
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: UpmSupport
+test_files: []