Skip to main content

MPXJ

MPXJ is a Java library which allows a variety of project file formats and databases to be read and written. This Python package uses the JPype Java bridge to allow direct access from Python to the MPXJ library. You can find details of the Java classes and methods in the Javadocs.

After installing this package you can either work with some of the simple built-in utilities provided by MPXJ for tasks like file format conversion:

import jpype
import mpxj

jpype.startJVM()
from net.sf.mpxj.sample import MpxjConvert
MpxjConvert().process('example.mpp', 'example.mpx')
jpype.shutdownJVM()

or you can interact directly with the object model exposed by MPXJ to extract data:

import jpype
import mpxj

jpype.startJVM()
from net.sf.mpxj.reader import UniversalProjectReader
project = UniversalProjectReader().read('example.mpp')

print("Tasks")
for task in project.getTasks():
	print(task.getID().toString() + "\t" + task.getName())

jpype.shutdownJVM()

or finally you can generate your own schedule:

import jpype
import mpxj

jpype.startJVM()

from java.lang import Double
from java.text import SimpleDateFormat
from net.sf.mpxj import ProjectFile, TaskField, Duration, TimeUnit, RelationType

# The helper class we use later to actually write the file
# selects the file type based on the extension of the
# filename. In the example below we'll be generating an MSPDI
# file which we can import into Microsoft Project.
filename = "test.xml"

# Create a simple date format to allow us to easily set date values.
df = SimpleDateFormat("dd/MM/yyyy")

# Create a ProjectFile instance
file = ProjectFile()

# Add a default calendar called "Standard"
calendar = file.addDefaultBaseCalendar()

# Add a holiday to the calendar to demonstrate calendar exceptions
calendar.addCalendarException(df.parse("13/03/2006"), df.parse("13/03/2006"))

# Retrieve the project properties and set the start date. Note Microsoft
# Project appears to reset all task dates relative to this date, so this
# date must match the start date of the earliest task for you to see
# the expected results. If this value is not set, it will default to
# today's date.
properties = file.getProjectProperties()
properties.setStartDate(df.parse("01/01/2003"))

# Set a couple more properties just for fun
properties.setProjectTitle("Created by MPXJ")
properties.setAuthor("Jon Iles")

# Let's create an alias for TEXT1
customFields = file.getCustomFields()
field = customFields.getCustomField(TaskField.TEXT1)
field.setAlias("My Custom Field")

# Add resources
resource1 = file.addResource()
resource1.setName("Resource1")

resource2 = file.addResource()
resource2.setName("Resource2")
resource2.setMaxUnits(Double.valueOf(50.0))

# Create a summary task
task1 = file.addTask()
task1.setName("Summary Task")

# Create the first sub task
task2 = task1.addTask()
task2.setName("First Sub Task")
task2.setDuration(Duration.getInstance(10.5, TimeUnit.DAYS))
task2.setStart(df.parse("01/01/2003"))
task2.setText(1, "My Custom Value 1")

# We'll set this task up as being 50% complete. If we have no resource
# assignments for this task, this is enough information for MS Project.
# If we do have resource assignments, the assignment record needs to
# contain the corresponding work and actual work fields set to the
# correct values in order for MS project to mark the task as complete
# or partially complete.
task2.setPercentageComplete(Double.valueOf(50.0))
task2.setActualStart(df.parse("01/01/2003"))

# Create the second sub task
task3 = task1.addTask()
task3.setName("Second Sub Task")
task3.setStart(df.parse("11/01/2003"))
task3.setDuration(Duration.getInstance(10, TimeUnit.DAYS))
task3.setText(1, "My Custom Value 2")

# Link these two tasks
task3.addPredecessor(task2, RelationType.FINISH_START, None)

# Add a milestone
milestone1 = task1.addTask()
milestone1.setName("Milestone")
milestone1.setStart(df.parse("21/01/2003"))
milestone1.setDuration(Duration.getInstance(0, TimeUnit.DAYS))
milestone1.addPredecessor(task3, RelationType.FINISH_START, None)

# This final task has a percent complete value, but no
# resource assignments. This is an interesting case it it requires
# special processing to generate the MSPDI file correctly.
task4 = file.addTask()
task4.setName("Next Task")
task4.setDuration(Duration.getInstance(8, TimeUnit.DAYS))
task4.setStart(df.parse("01/01/2003"))
task4.setPercentageComplete(Double.valueOf(70.0))
task4.setActualStart(df.parse("01/01/2003"))

# Assign resources to tasks
assignment1 = task2.addResourceAssignment(resource1)
assignment2 = task3.addResourceAssignment(resource2)

# As the first task is partially complete, and we are adding
# a resource assignment, we must set the work and actual work
# fields in the assignment to appropriate values, or MS Project
# won't recognise the task as being complete or partially complete
assignment1.setWork(Duration.getInstance(80, TimeUnit.HOURS))
assignment1.setActualWork(Duration.getInstance(40, TimeUnit.HOURS))

# If we were just generating an MPX file, we would already have enough
# attributes set to create the file correctly. If we want to generate
# an MSPDI file, we must also set the assignment start dates and
# the remaining work attribute. The assignment start dates will normally
# be the same as the task start dates.
assignment1.setRemainingWork(Duration.getInstance(40, TimeUnit.HOURS))
assignment2.setRemainingWork(Duration.getInstance(80, TimeUnit.HOURS))
assignment1.setStart(df.parse("01/01/2003"))
assignment2.setStart(df.parse("11/01/2003"))

# Write a 100% complete task
task5 = file.addTask()
task5.setName("Last Task")
task5.setDuration(Duration.getInstance(3, TimeUnit.DAYS))
task5.setStart(df.parse("01/01/2003"))
task5.setPercentageComplete(Double.valueOf(100.0))
task5.setActualStart(df.parse("01/01/2003"))

# Write a 100% complete milestone
task6 = file.addTask()
task6.setName("Last Milestone")
task6.setDuration(Duration.getInstance(0, TimeUnit.DAYS))
task6.setStart(df.parse("01/01/2003"))
task6.setPercentageComplete(Double.valueOf(100.0))
task6.setActualStart(df.parse("01/01/2003"))

# Write the file
from net.sf.mpxj.writer import ProjectWriterUtility
writer = ProjectWriterUtility.getProjectWriter(filename)
writer.write(file, filename)

jpype.shutdownJVM()

Metadata

Release files for mpxj 10.13.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mpxj 10.13.0
File Size Uploaded Provenance Actions
mpxj-10.13.0.tar.gz 22.7 MB Without provenance Details for mpxj-10.13.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mpxj 10.13.0
File Interpreter ABI Platform Actions
mpxj-10.13.0-py3-none-any.whl Python 3 none any Details for mpxj-10.13.0-py3-none-any.whl

Total release size: 45.3 MB

Release files / mpxj-10.13.0.tar.gz

Download URL mpxj-10.13.0.tar.gz
Size 22.7 MB
Tags Source
SHA-256 checksum
How to use checksums
5655fe37a08e58233d5d1e54018d075c25b1a3cadff016d3f2bdaae0a673c989
BLAKE2b-256 checksum
How to use checksums
a1c38d6654ff43aee8ac0bd7f1385f752ea5393affc5104021334ab659432af3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.11.3 pkginfo/1.7.0 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

Release files / mpxj-10.13.0-py3-none-any.whl

Download URL mpxj-10.13.0-py3-none-any.whl
Size 22.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
5304e1b8106c5ac2a9ea8dde9840a887e05ef2a84087a79c589e1416128dfd4b
BLAKE2b-256 checksum
How to use checksums
3c0e498b9e5ce6cdd058b27a0b58d262c11191562e9189934b22e54e37fe319b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/4.11.3 pkginfo/1.7.0 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

Security for mpxj 10.13.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

10.13.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page