mxrb 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80ac058134902cb839b9dacd80da635675e27fe0ac6fe3eb22dd833c551731ab
-  data.tar.gz: 291c3ce744371e4f89a9b0b63ae37200831d566a140285e26c0d3199482c6775
+  metadata.gz: a734dae7c32bec492facdf80e775897c3b31af47fc595f4d4096f2cd27f091ee
+  data.tar.gz: db3a5207301da5c8f384515adf334c5739fba69379aec3c69175a653e68beff2
 SHA512:
-  metadata.gz: 37566da77719ce1537886b96ed5189c080da1d8668aea9d7e4e5a3de7ffd18a81de67318ffbc005d5ab2a5b3dfbacf5e903439cf884c94b09c6c09b6148e1a75
-  data.tar.gz: f48190ec6af16e09d97246e7eb514f054ea7555b99560143766bb3df13f86fbcc47d8944a924bc3a70cd846410e14b845a4c64b5caec7e9f56866ec441b53355
+  metadata.gz: 4aedde89b67e5d52e438b38e2f2c9835a9ca2407950a6c7ee04f10aa74fb0d1e9fae0fc380b50e3c3155fc7509eb0d513e90461c8058949849f9c4146df162c7
+  data.tar.gz: ed923449e412dc172462c951373408558244983db0d84b38d2a550791219190146064d900e2b6eb459fc8e6aa250def2c62614854e1e8b25d13192a6b437bd6e

data/README.de-DE.md

@@ -19,6 +19,7 @@ und Testen von Mendix-Projekten (`.mpr`) ohne MDL oder `mxcli`.
 - Lint und ausführbare Modellbewertungen;
 - Erkennung von nativem OQL und logische SQL-Ansicht nur bei vorhandenem OQL;
 - isolierte, durch das Runtime synchronisierte PostgreSQL für direkte SQL-Abfragen;
+- Demo-Benutzer mit lokalen `.env`-Geheimnissen und sichere Runtime-Zugangsdaten;
 - Analyse von PostgreSQL-/SQL-Server-Plänen und kumulativem PostgreSQL-Workload;
 - funktionale Microflow-Tests lokal oder in Docker.
 - Suche und Installation wiederverwendbarer Ruby-Module mit SHA-256-Lock.
@@ -35,6 +36,7 @@ wird kompatibles Java benötigt; Docker stellt JDK und Runtime bereit.
 
 ```sh
 bundle install
+bundle exec mxrb --version
 bundle exec mxrb validate App.mpr
 bundle exec mxrb export App.mpr app-ruby
 bundle exec mxrb compare original.mpr rebuilt.mpr
@@ -45,7 +47,9 @@ bundle exec mxrb cache warm App.mpr
 bundle exec mxrb cache clear App.mpr
 bundle exec mxrb oql App.mpr --dialect postgresql
 bundle exec mxrb db up App.mpr
+bundle exec mxrb db credentials App.mpr --copy
 bundle exec mxrb db sql App.mpr 'SELECT * FROM "sales$order" LIMIT 20'
+bundle exec mxrb demo-user new manager --entity System.User --role User
 ```
 
 Die MPR speichert das Modell, nicht die Anwendungsdaten. `db up` baut das

data/README.md

@@ -23,6 +23,7 @@ remain optional external gates for compatibility and functional execution.
 - inventory design tokens, check contrast and preview atomic literal migration;
 - discover native OQL and render safe logical SQL views only when OQL exists;
 - materialize an isolated, Runtime-synchronized PostgreSQL for direct SQL inspection;
+- scaffold demo users with local `.env` secrets and safely inspect Runtime credentials;
 - analyze PostgreSQL/SQL Server plans and rank cumulative PostgreSQL workload pressure;
 - move standalone units between folders in the same module with a preview;
 - remove standalone units only after reference and child-unit safety checks;
@@ -57,6 +58,7 @@ Install dependencies:
 
 ```sh
 bundle install
+bundle exec mxrb --version
 ```
 
 ## Ruby DSL
@@ -92,7 +94,9 @@ bundle exec mxrb cache warm Shop.mpr
 bundle exec mxrb cache clear Shop.mpr
 bundle exec mxrb oql Shop.mpr --dialect postgresql
 bundle exec mxrb db up Shop.mpr
+bundle exec mxrb db credentials Shop.mpr --copy
 bundle exec mxrb db sql Shop.mpr 'SELECT * FROM "sales$order" LIMIT 20'
+bundle exec mxrb demo-user new manager --entity System.User --role User
 bundle exec mxrb pack Shop.mpr --output build/Shop.mda
 bundle exec mxrb portable Shop.mpr --output build/runtime.zip
 bundle exec mxrb team-server clone APP_ID ./shop --pat-file /secure/team-server.env

data/README.pt-BR.md

@@ -19,6 +19,7 @@ projetos Mendix (`.mpr`) sem MDL ou `mxcli`.
 - lint e avaliações executáveis de modelo;
 - descoberta de OQL nativo e visão SQL lógica somente quando o projeto contém OQL;
 - PostgreSQL isolado e sincronizado pelo Runtime para consultas SQL diretas;
+- scaffold de demo users com segredos locais no `.env` e consulta segura de credenciais;
 - análise de planos PostgreSQL/SQL Server e workload cumulativo PostgreSQL;
 - testes funcionais de microflows localmente ou em Docker.
 - busca e instalação de módulos Ruby reutilizáveis com SHA-256 travado.
@@ -34,6 +35,7 @@ local precisa do Java compatível; o modo Docker fornece JDK e Runtime.
 
 ```sh
 bundle install
+bundle exec mxrb --version
 bundle exec mxrb init vet_clinic
 bundle exec mxrb validate App.mpr
 bundle exec mxrb export App.mpr app-ruby
@@ -45,7 +47,9 @@ bundle exec mxrb cache warm App.mpr
 bundle exec mxrb cache clear App.mpr
 bundle exec mxrb oql App.mpr --dialect postgresql
 bundle exec mxrb db up App.mpr
+bundle exec mxrb db credentials App.mpr --copy
 bundle exec mxrb db sql App.mpr 'SELECT * FROM "sales$order" LIMIT 20'
+bundle exec mxrb demo-user new manager --entity System.User --role User
 ```
 
 O MPR armazena o modelo, não os dados da aplicação. `db up` compila o Runtime

data/bin/mxrb

@@ -64,9 +64,14 @@ end
 
 SCAFFOLD_COMMANDS = (Mxrb::Scaffold::Help::COMMANDS.keys - ["design"]).freeze
 
+progress_disabled = ARGV.delete("--no-progress")
 command = ARGV.shift
+Mxrb::Progress.configure(enabled: false) if progress_disabled || ARGV.include?("--json")
 
 case command
+when '--version', '-v'
+  puts "mxrb #{Mxrb::VERSION}"
+
 when 'doctor'
   json = ARGV.delete('--json')
   root = ARGV.shift || Dir.pwd
@@ -742,7 +747,7 @@ when "design"
 
 when "db"
   action = ARGV.shift or
-    abort "Usage: mxrb db <up|sync|down|destroy|status|url|sql|explain|workload|indexes|shell> <file.mpr>"
+    abort "Usage: mxrb db <up|sync|down|destroy|status|credentials|url|sql|explain|workload|indexes|shell> <file.mpr>"
   path = ARGV.shift or abort "Usage: mxrb db #{action} <file.mpr>"
   option = lambda do |name, fallback = nil|
     index = ARGV.index(name)
@@ -795,6 +800,30 @@ when "db"
     puts "Database : #{info.database_container}"
     puts "Runtime  : #{info.runtime_container}"
     puts "State    : #{info.state_dir}"
+  when "credentials"
+    copy = !ARGV.delete("--copy").nil?
+    show_password = !ARGV.delete("--show-password").nil?
+    json = !ARGV.delete("--json").nil?
+    abort '--copy and --show-password are mutually exclusive' if copy && show_password
+    abort "Unknown arguments: #{ARGV.join(' ')}" unless ARGV.empty?
+
+    credentials = workspace.admin_credentials
+    visible_password = nil
+    visible_password = credentials.password if show_password
+    if copy
+      command = Mxrb::Runtime::Clipboard.new.copy(credentials.password)
+      puts "[mxrb] Password for #{credentials.username} copied with #{command}"
+    elsif json
+      puts JSON.pretty_generate(
+        username: credentials.username, password: visible_password,
+        state: credentials.state_dir, credentials_file: credentials.path
+      )
+    else
+      visible_password ||= '<hidden; use --copy or --show-password>'
+      puts "User name : #{credentials.username}"
+      puts "Password  : #{visible_password}"
+      puts "State     : #{credentials.state_dir}"
+    end
   when "url"
     puts workspace.connection_url
   when "sql"
@@ -833,7 +862,7 @@ when "db"
     exec(*workspace.shell_command(write:))
   else
     abort "Unknown db action #{action.inspect}; " \
-          "use up, sync, down, destroy, status, url, sql, explain, workload, indexes or shell"
+          "use up, sync, down, destroy, status, credentials, url, sql, explain, workload, indexes or shell"
   end
 
 when "serve"
@@ -1479,6 +1508,8 @@ else
     mxrb — Pure-Ruby Mendix .mpr toolkit
 
     Commands:
+      --no-progress                         Disable interactive progress rendering
+      --version, -v                         Show the installed MXRB version
       doctor     [DIR] [--json]           Check project files and local toolchain
       benchmark <file.mpr>                Measure open, index and validation time
                  --iterations N --json    Configure repetitions or emit JSON
@@ -1537,6 +1568,8 @@ else
          down    <file.mpr>                 Stop containers while preserving all data
          destroy <file.mpr> --yes           Remove isolated containers, data, and state
          status  <file.mpr>                 Show isolated database/runtime status
+         credentials <file.mpr> [--copy]   Show the admin user or copy its password
+                 --show-password            Explicitly print the Runtime admin password
          url     <file.mpr> [--port PORT]   Print the read-only PostgreSQL connection URL
          sql     <file.mpr> "SELECT …"      Execute SQL as the read-only analyst role
                  --write                    Explicitly use the Runtime owner role
@@ -1595,6 +1628,9 @@ else
       nanoflow new Module.Name            Scaffold a client nanoflow
       repository new Module.Name          Scaffold a repository port and adapter
       security init Module                Scaffold module roles
+      demo-user [new] NAME                Scaffold a local Mendix demo user
+                [--entity ENTITY]          Default: System.User
+                [--role ROLE]              Repeatable; default: User
       scheduled-event new Module.Name     Scaffold an event and handler
       constant new Module.Name            Scaffold a module constant
       integration new Module.Name         Scaffold an integration adapter

data/docs/de-DE/oql-sql.md

@@ -142,6 +142,24 @@ bundle exec mxrb db sql Shop.mpr \
 bundle exec mxrb db shell Shop.mpr
 ```
 
+Die Zugangsdaten des vorhandenen Runtime-Administrators lassen sich prüfen,
+ohne das Passwort standardmäßig auszugeben:
+
+```sh
+bundle exec mxrb db credentials Shop.mpr
+bundle exec mxrb db credentials Shop.mpr --copy
+bundle exec mxrb db credentials Shop.mpr --json
+bundle exec mxrb db credentials Shop.mpr --show-password
+```
+
+`--copy` übergibt das Passwort per stdin an die Zwischenablage und nie als
+Prozessargument. Nur `--show-password` gibt es aus; im JSON bleibt `password`
+ohne diese Option `null`. `--copy` und `--show-password` schließen einander
+aus. Der Befehl liest nur einen vorhandenen Workspace: Er erzeugt oder rotiert
+keine Zugangsdaten und verweist auf `db up`, falls noch kein Zustand existiert.
+Dies sind die Zugangsdaten des Mendix-Anwendungsadministrators, getrennt von
+den PostgreSQL-Rollen `mxrb_reader` und Runtime-Eigentümer.
+
 Nach einer Änderung der MPR wird unter Beibehaltung der Daten neu gebaut und
 synchronisiert:
 

data/docs/de-DE/scaffolds.md

@@ -30,6 +30,29 @@ Data Source. Ketten, die mit einem Microflow enden, erzeugen zusätzlich
 Jede erzeugte Kette wird als gültiges MPR materialisiert und durch den
 Compiler-Preflight geprüft.
 
+## Demo-Benutzer
+
+Nach der Initialisierung der Sicherheit wird jeder Demo-Benutzer als eigene
+Ruby-Datei erzeugt:
+
+```sh
+mxrb security init App
+mxrb demo-user new manager --entity System.User --role User
+mxrb demo-user operator --entity App.Account --role User --role Administrator
+```
+
+`new` ist optional. `--entity` verwendet standardmäßig `System.User`, und
+`--role` kann wiederholt werden; ohne Angabe wird die Rolle `User` gewählt. Das
+Scaffold prüft sofort, ob Entität und Anwendungsrollen vorhanden sind,
+verbindet `app/security/demo_users` mit dem `security`-Block und aktiviert
+Demo-Benutzer in der MPR.
+
+Das zufällige Passwort liegt nur in der ignorierten `.env`, die beim Erstellen
+den Modus `0600` erhält. Der erzeugte Ruby-Code nutzt `ENV.fetch`, während
+`.env.example` nur eine leere Variable enthält. Danach wird die MPR wie gewohnt
+generiert und validiert. Demo-Benutzer sind für Entwicklung und Vorführungen
+gedacht, nicht für Produktionsbenutzer.
+
 ## Seitenvorlagen
 
 In Mendix sind Page Templates Ausgangspunkte, deren Struktur zu einer normalen,

data/docs/en-US/oql-sql.md

@@ -137,6 +137,24 @@ bundle exec mxrb db sql Shop.mpr \
 bundle exec mxrb db shell Shop.mpr
 ```
 
+You can inspect the existing Runtime administrator credentials without
+printing the password by default:
+
+```sh
+bundle exec mxrb db credentials Shop.mpr
+bundle exec mxrb db credentials Shop.mpr --copy
+bundle exec mxrb db credentials Shop.mpr --json
+bundle exec mxrb db credentials Shop.mpr --show-password
+```
+
+`--copy` sends the password to the clipboard through stdin, never in process
+arguments. `--show-password` is the only mode that prints it; JSON keeps
+`password` as `null` without that option. `--copy` and `--show-password` are
+mutually exclusive. The command only reads an existing workspace: it neither
+creates nor rotates credentials and tells you to run `db up` when no state
+exists. These are Mendix application-administrator credentials, separate from
+the PostgreSQL `mxrb_reader` and Runtime-owner roles.
+
 After changing the MPR, rebuild and synchronize while retaining the data:
 
 ```sh

data/docs/en-US/scaffolds.md

@@ -29,6 +29,28 @@ end in a microflow also create `ACT_RefreshOrder`. `page generate` and `page g`
 are aliases of `page new`. Every generated chain is materialized as a valid MPR
 and checked by compiler preflight.
 
+## Demo users
+
+After initializing security, scaffold each demo user as an independent Ruby
+file:
+
+```sh
+mxrb security init App
+mxrb demo-user new manager --entity System.User --role User
+mxrb demo-user operator --entity App.Account --role User --role Administrator
+```
+
+`new` is optional. `--entity` defaults to `System.User`, and `--role` is
+repeatable; without it, the `User` role is selected. The scaffold immediately
+validates that the entity and application roles exist, connects
+`app/security/demo_users` to the `security` block, and enables demo users in
+the MPR.
+
+The random password exists only in the ignored `.env`, created with mode
+`0600`. Generated Ruby uses `ENV.fetch`, while `.env.example` receives only an
+empty variable. Generate and validate the MPR normally after scaffolding. Demo
+users are intended for development and demonstrations, not production users.
+
 ## Page templates
 
 In Mendix, page templates are starting points whose structure becomes a normal,

data/docs/pt-BR/entity-dsl.md

@@ -94,6 +94,12 @@ entity :AnimalSearchResult do
   string :Name
 end
 
+entity :AnimalSummaryView do
+  oql_view source: "VetClinic.AnimalSummarySource"
+  string :Name
+  integer :Total
+end
+
 entity :Animal do
   before_commit microflow: "VetClinic.VAL_Animal"
   after_commit microflow: "VetClinic.ACT_AfterAnimalCommit"
@@ -111,6 +117,8 @@ end
 
 Em `access_rule`, `read:` e `write:` aceitam `:all`, `:none` ou uma lista de
 atributos. Declare um ou mais papéis qualificados como primeiros argumentos.
+`oql_view` liga a entidade ao `ViewEntitySourceDocument`; ao exportar um projeto
+existente, a consulta OQL aparece junto da entidade em `domain/oql_views`.
 
 Use `mxrb entity --help` para o comando e `mxrb generate project.rb` seguido de
 `mxrb validate App.mpr` para validar o resultado.

data/docs/pt-BR/oql-sql.md

@@ -144,6 +144,24 @@ bundle exec mxrb db sql Shop.mpr \
 bundle exec mxrb db shell Shop.mpr
 ```
 
+As credenciais do administrador do Runtime já criado podem ser consultadas sem
+imprimir a senha por padrão:
+
+```sh
+bundle exec mxrb db credentials Shop.mpr
+bundle exec mxrb db credentials Shop.mpr --copy
+bundle exec mxrb db credentials Shop.mpr --json
+bundle exec mxrb db credentials Shop.mpr --show-password
+```
+
+`--copy` envia a senha ao clipboard por stdin, sem colocá-la nos argumentos do
+processo. `--show-password` é a única forma de imprimi-la; no JSON, `password`
+permanece `null` sem essa opção. `--copy` e `--show-password` são mutuamente
+exclusivos. O comando apenas lê o workspace existente: não cria nem gira
+credenciais e orienta executar `db up` quando o estado ainda não existe. Essas
+são as credenciais do administrador da aplicação Mendix, distintas dos papéis
+PostgreSQL `mxrb_reader` e proprietário do Runtime.
+
 Depois de alterar o MPR, recompile e sincronize preservando os dados:
 
 ```sh

data/docs/pt-BR/scaffolds.md

@@ -30,6 +30,7 @@ o hash criado pelo gerador, protegendo edições posteriores.
 | `mxrb page new App.Order --chain page:nanoflow:microflow` | Fatia vertical executável |
 | `mxrb nanoflow new App.NAN_OpenCustomer` | Nanoflow cliente |
 | `mxrb security init App` | Papéis, `CheckEverything` no projeto e orientação de acesso |
+| `mxrb demo-user new manager --role User` | Demo user com segredo local em `.env` |
 | `mxrb integration new App.PetApi` | Adaptador de integração |
 | `mxrb published-rest new App.CustomersApi` | Handler editável para REST publicado |
 | `mxrb consumed-rest new App.ExternalPets` | Adaptador REST consumido |
@@ -71,6 +72,27 @@ são aliases de `page new`. Cada cadeia é materializada em um MPR válido, serv
 como ponto de partida removível e exercita o preflight do compilador; arquivos
 existentes nunca são sobrescritos.
 
+## Demo users
+
+Depois de inicializar a segurança, um demo user pode ser declarado como um
+arquivo Ruby independente:
+
+```sh
+mxrb security init App
+mxrb demo-user new manager --entity System.User --role User
+mxrb demo-user operator --entity App.Account --role User --role Administrator
+```
+
+`new` é opcional. `--entity` usa `System.User` por padrão e `--role` pode ser
+repetido; sem ele, o papel `User` é usado. O scaffold valida imediatamente se
+a entidade e os papéis existem, conecta `app/security/demo_users` ao bloco
+`security` e habilita demo users no MPR.
+
+A senha aleatória fica apenas no `.env` ignorado, com modo `0600` quando o
+arquivo é criado. O Ruby gerado usa `ENV.fetch` e `.env.example` recebe somente
+a variável vazia. Gere e valide o MPR normalmente depois do scaffold. Demo
+users destinam-se a desenvolvimento e demonstração, não a usuários de produção.
+
 ## Modelos de página
 
 No Mendix, page templates são pontos de partida: sua estrutura é copiada para

data/docs/pt-BR/writing.md

@@ -5,6 +5,12 @@
 `mxrb generate` avalia uma definição Ruby e cria ou atualiza o MPR. Nomes
 Mendix são chaves estáveis, portanto reaplicar a definição não duplica units.
 
+Operações demoradas exibem progresso em `stderr` quando executadas em um
+terminal interativo. Quando o total é conhecido, o MXRB mostra barra e
+porcentagem; operações externas sem total confiável mostram spinner e tempo
+decorrido. Pipes, redirecionamentos e saídas `--json` permanecem limpos. Use
+`--no-progress` ou `MXRB_PROGRESS=0` para desativar explicitamente.
+
 Para iniciar em uma pasta vazia:
 
 ```sh
@@ -122,6 +128,28 @@ usam `bson_binary`. Alterações nesse Ruby sobrepõem o baseline antes das escr
 tipadas. Corpos de flow possuem `body_fingerprint`: o grafo nativo é reutilizado
 quando o Ruby não mudou e regenerado após uma edição.
 
+Export mappings, import mappings e JSON structures são materializados por
+módulo em `infrastructure/mappings/{exports,imports,json_structures}`. Esses
+arquivos mantêm `UnitID` e container/pasta originais, podem editar toda a
+estrutura profunda em Ruby e têm precedência sobre o baseline durante o
+`generate`.
+
+Serviços REST, OData e web services publicados são exportados para
+`infrastructure/endpoints`; recursos, operações, métodos HTTP, paths,
+parâmetros e referências a microflows permanecem no mesmo arquivo Ruby.
+Serviços consumidos são roteados para `infrastructure/integrations`, enquanto
+message definitions e XML schemas ficam em `infrastructure/mappings`.
+
+O Domain Model exportado separa entidades persistentes em `domain/entities`,
+DTOs/non-persistent em `domain/dtos` e entidades de OQL View em
+`domain/oql_views`. O arquivo da OQL View também contém seu
+`DomainModels$ViewEntitySourceDocument`, portanto a consulta `Oql` pode ser
+editada no mesmo Ruby sem perder a referência da entidade. Datasets OQL ficam
+em `application/queries/datasets`; enumerations e constants ficam em
+`domain/enumerations` e `domain/constants`. Scheduled events ficam em
+`application/jobs/scheduled_events`. O `domain/model.rb` e o
+`application/application.rb` carregam automaticamente todas essas categorias.
+
 A DSL cobre criação/alteração/retrieve/commit/delete, chamadas de microflow,
 Java, JavaScript, nanoflow e app service, páginas, REST, listas, decisões,
 loops, eventos de erro e rescue.

data/lib/mxrb/compare.rb

@@ -72,6 +72,13 @@ module Mxrb
           admin_user_name: doc["AdminUserName"],
           admin_user_role: doc["AdminUserRole"],
           demo_users_enabled: doc["EnableDemoUsers"],
+          demo_users: IO::BsonCodec.parse_array(doc["DemoUsers"]).fetch(:items).map do |user|
+            {
+              name: user["UserName"], entity: user["Entity"],
+              roles: IO::BsonCodec.parse_array(user["UserRoles"]).fetch(:items).sort,
+              password_sha256: Digest::SHA256.hexdigest(user["Password"].to_s)
+            }
+          end.sort_by { _1[:name].to_s },
           guest_access_enabled: doc["EnableGuestAccess"],
           guest_user_role: doc["GuestUserRole"],
           sign_in_microflow: doc["SignInMicroflow"],

data/lib/mxrb/compiler/packager.rb

@@ -19,16 +19,24 @@ module Mxrb
         @deployment = File.expand_path(deployment || File.join(@project_root, 'deployment'))
       end
 
-      def pack(output:, force: false)
-        output_path = File.expand_path(output)
-        validate_input!(output_path, force:)
-        version = Mxrb.open(@mpr_path, &:mendix_version)
-        adapter = Adapter.for(version)
-        metadata = adapter.validate_deployment!(@deployment)
-        adapter.validate_freshness!(@mpr_path, @deployment)
-        files, directories = inventory
-        write_atomically(output_path, files, directories)
-        package_result(output_path, version, metadata)
+      def pack(output:, force: false) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        Progress.with("Packing #{File.basename(@mpr_path)}") do |progress|
+          output_path = File.expand_path(output)
+          validate_input!(output_path, force:)
+          version = Mxrb.open(@mpr_path, &:mendix_version)
+          adapter = Adapter.for(version)
+          metadata = adapter.validate_deployment!(@deployment)
+          adapter.validate_freshness!(@mpr_path, @deployment)
+          files, directories = inventory
+          progress.update(
+            current: 3, total: files.size + directories.size + 4,
+            detail: "#{files.size} files"
+          )
+          write_atomically(output_path, files, directories, progress)
+          package_result(output_path, version, metadata).tap do
+            progress.advance(detail: 'package checksum')
+          end
+        end
       end
 
       private
@@ -69,13 +77,19 @@ module Mxrb
         path.delete_prefix("#{@deployment}/").tr('\\', '/')
       end
 
-      def write_atomically(output, files, directories)
+      def write_atomically(output, files, directories, progress) # rubocop:disable Metrics/MethodLength
         FileUtils.mkdir_p(File.dirname(output))
         Dir.mktmpdir('mxrb-mda-', File.dirname(output)) do |tmpdir|
           temporary = File.join(tmpdir, 'package.mda')
           Zip::File.open(temporary, create: true) do |archive|
-            directories.each { add_directory(archive, _1) }
-            files.each { add_file(archive, _1) }
+            directories.each do |directory|
+              add_directory(archive, directory)
+              progress.advance(detail: relative(directory))
+            end
+            files.each do |file|
+              add_file(archive, file)
+              progress.advance(detail: relative(file))
+            end
           end
           FileUtils.mv(temporary, output, force: true)
         end

data/lib/mxrb/compiler/portable_packager.rb

@@ -309,17 +309,22 @@ module Mxrb
         @mendix_home = mendix_home && File.expand_path(mendix_home)
       end
 
-      def pack(output:, force: false)
-        output_path = File.expand_path(output)
-        validate_output!(output_path, force:)
-        version = Mxrb.open(@mpr_path, &:mendix_version)
-        adapter = Adapter.for(version)
-        metadata = adapter.validate_deployment!(@deployment)
-        adapter.validate_freshness!(@mpr_path, @deployment)
-        runtime = runtime_root(version)
-        validate_runtime!(runtime)
-        PortableArchiveWriter.new(@deployment, runtime, metadata).write(output_path)
-        result(output_path, version, metadata)
+      def pack(output:, force: false) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        Progress.with("Packing portable Runtime for #{File.basename(@mpr_path)}") do |progress|
+          output_path = File.expand_path(output)
+          validate_output!(output_path, force:)
+          progress.update(detail: 'validating deployment')
+          version = Mxrb.open(@mpr_path, &:mendix_version)
+          adapter = Adapter.for(version)
+          metadata = adapter.validate_deployment!(@deployment)
+          adapter.validate_freshness!(@mpr_path, @deployment)
+          runtime = runtime_root(version)
+          validate_runtime!(runtime)
+          progress.update(detail: 'writing Runtime archive')
+          PortableArchiveWriter.new(@deployment, runtime, metadata).write(output_path)
+          progress.update(detail: 'calculating checksum')
+          result(output_path, version, metadata)
+        end
       end
 
       private