mpp_reader 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d3971155a09cbacffba3a169e8d4a430112faf2ce2cf5faebaf88eb47cc626a
-  data.tar.gz: b952f90ccfa0d496cccbaf5931cea193a938fb12703f67b2311a5400a2baa99a
+  metadata.gz: 79fc0475a02a9939c575f98ca6c506ae74436d58970289a1a4c6ebb6e47e405f
+  data.tar.gz: 32413a159e6a27bbdde5d7b3b16ce6dd8027cce50fa19d364ea9a56c79486321
 SHA512:
-  metadata.gz: 924a1da61a264191ade50924d511de40cb3694ec1b06e71f35d9405e9f3b831fac84a04724c4835c61b1c3ea7fcb75e12aba89bbef38934350bc8ebb3030640e
-  data.tar.gz: a744a87ce9c5c9eb83e3949abf696fcd6ed1ebf71d4150dccb02691e5bbecd604c0aee96e9e82c3f645f46517c9615eef1575b452d695923668c959d95cd8e7d
+  metadata.gz: 18eb284975774c0cda977674705cdcd5af130c330109e8cd64e9f4e44e1194a696e4778e729804d7c159a52edd48ba74a77a6b1d5458fce24e1b194b73425d31
+  data.tar.gz: e4966d1da31dfb46776926d88118e9ee91212f73f487ac9846eac25b9e7c48ce186f09423c4c18a2f06b57cf97cf5cfc0eacdb560a5235e34d4ce44a836a0625

data/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+- Constraints: `Task#constraint_type` and `#constraint_date` expose the
+  scheduling constraint MS Project writes when a task is pinned or an
+  auto-scheduled task is dragged. `Task#constrained?` is true only for the
+  six types that carry a date - `as_soon_as_possible` and
+  `as_late_as_possible` express a preference, not a fixed point. Unknown
+  constraint codes read as `nil` rather than being guessed at.
+
+## [0.1.0] - 2026-06-12
+
 - CLI: `mpp_reader FILE...` prints a task tree (with notes), `--json` emits
   a structured dump of tasks, resources, assignments and calendars.
 - CI workflow (GitHub Actions, Ruby 3.1-4.0) and gem metadata for the

data/lib/mpp_reader/cli.rb

@@ -76,6 +76,7 @@ module MppReader
             percent_complete: t.percent_complete,
             milestone: t.milestone?, summary: t.summary?,
             active: t.active, manually_scheduled: t.manual,
+            constraint_type: t.constraint_type, constraint_date: iso(t.constraint_date),
             parent_unique_id: t.parent&.unique_id,
             predecessors: t.predecessors.map do |r|
               { predecessor_task_unique_id: r.predecessor_task_unique_id,

data/lib/mpp_reader/decode.rb

@@ -28,6 +28,17 @@ module MppReader
       20 => :elapsed_percent
     }.freeze
 
+    CONSTRAINT_TYPES = {
+      0 => :as_soon_as_possible,
+      1 => :as_late_as_possible,
+      2 => :must_start_on,
+      3 => :must_finish_on,
+      4 => :start_no_earlier_than,
+      5 => :start_no_later_than,
+      6 => :finish_no_earlier_than,
+      7 => :finish_no_later_than
+    }.freeze
+
     # Divisors converting tenths-of-minutes to each unit, assuming MS
     # Project's defaults (8h days, 40h weeks, 20-day months).
     TENTHS_PER_UNIT = {
@@ -76,6 +87,17 @@ module MppReader
       DURATION_UNITS.fetch(code, :days)
     end
 
+    # A task's scheduling constraint. Codes match MPXJ's ConstraintType enum,
+    # which is the order MS Project writes them in.
+    #
+    # as_soon_as_possible is the default and the overwhelming majority; only
+    # the four "no earlier/later than" variants and the two "must" ones carry
+    # a meaningful constraint_date. An unknown code yields nil rather than a
+    # guess, because acting on a misread constraint moves real dates.
+    def constraint_type(code)
+      CONSTRAINT_TYPES[code]
+    end
+
     # value is in tenths of a minute; converts using MS Project's default
     # hours-per-day assumptions.
     def duration(value, units)

data/lib/mpp_reader/reader14.rb

@@ -399,6 +399,8 @@ module MppReader
       task.milestone = meta_bit?(meta_record, MILESTONE_FLAG)
       task.active = meta_bit?(meta2_record, ACTIVE_FLAG)
       task.manual = meta_bit?(meta2_record, MANUALLY_SCHEDULED_FLAG)
+      task.constraint_type = Decode.constraint_type(read.call(:constraint_type))
+      task.constraint_date = read.call(:constraint_date)
 
       # In MPP14 the start/finish/duration slots hold manually-scheduled
       # values; auto-scheduled tasks carry theirs in the scheduled_* fields

data/lib/mpp_reader/task.rb

@@ -2,7 +2,8 @@ module MppReader
   class Task
     attr_accessor :unique_id, :id, :name, :start, :finish, :duration,
                   :outline_level, :percent_complete, :milestone, :parent,
-                  :active, :manual, :notes
+                  :active, :manual, :notes,
+                  :constraint_type, :constraint_date
     attr_reader :children, :predecessors, :successors
 
     def initialize
@@ -13,6 +14,14 @@ module MppReader
 
     def milestone? = !!@milestone
 
+    # True when the constraint actually pins the task somewhere. The default
+    # (as_soon_as_possible) and as_late_as_possible carry no date and express
+    # a scheduling preference, not a fixed point; the other six do.
+    def constrained?
+      !constraint_date.nil? &&
+        !%i[as_soon_as_possible as_late_as_possible].include?(constraint_type)
+    end
+
     # A summary task is one with subtasks (MS Project derives this the
     # same way).
     def summary = !@children.empty?

data/lib/mpp_reader/version.rb

@@ -1,3 +1,3 @@
 module MppReader
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mpp_reader
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Bart Duchesne
@@ -71,7 +71,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Pure Ruby reader for Microsoft Project .mpp files
 test_files: []