Announcing Pastastore 2.0 (and what to do with older databases)

[dbrakenhoff]

Pastas 2.0 (Boscaiola) is now available (Sep 2nd, 2026) and is fully compatible with Pastastore 2.0.

Pastas compatibility

Pastastore is backwards compatible with Pastas >= 1.5.0. This means that Pastastore 2.0 can be used with any Pastas version from 1.5.0 onwards. This will allow you to continue working with older Pastas versions but use the newest features in Pastastore 2.0.

A note on older databases

Note that the Pastas version is the important factor determining the support for older databases, since the most important part of the reading/writing process is performed by Pastas. When Pastas changes something in its read/write routines this potentially breaks support for older .pas-files. Note that we always try to maintain backwards compatibility, but sometimes we have to drop support for older .pas-files. We always ensure files created by the previous Pastas version are always supported by the next version, e.g. pas-files generated with Pastas 1.14 can always be read by Pastas 2.0, though generally the backwards compatibility runs back for multiple older Pastas versions.

Older databases, created with the following Pastas versions should all be supported without any issues by Pastas 2.0 and Pastastore 2.0:

• 1.5.0
• 1.6.0
• 1.7.0
• 1.8.0
• 1.9.0
• 1.10.1
• 1.11.0
• 1.12.0
• 1.13.2
• 1.14.0

For future-proofing your database, it is recommended to load the old database, and rewrite all files to ensure stored files are updated to the latest .pas-file formats. For databases created with Pastas < 1.5.0 you might need to test what the maximum version of Pastas you can use to read in your older databases. Start from the newest Pastas version, and try loading your old database with Pastastore 2.0 until you find a version that works.

Steps

1. Update Pastastore to version 2.0.
2. Update Pastas to version X.X (try 2.0 first, but for older databases you might need an older version of Pastas)
3. Load your database.
4. Rewrite all your stored files to migrate to newer pas-files. See instructions below depending on your stored database.
5. If your old database could not be loaded with Pastas 2.0, repeat steps 1-4 until you are able to load the database with Pastas 2.0.

For old .zip-files:

import pastastore as pst

pstore = pst.Pastastore.from_zip("old_database.zip")
pstore.to_zip("new_database.zip")

For old PasConnectors (or ArcticDBConnectors):

import pastastore as pst

conn1 = pst.PasConnector("old_database", path="where/i/stored/it")
conn2 = pst.PasConnector("new_database", path="where/i/stored/it")
pst.util.copy_database(conn1, conn2)

If you're feeling very confident, overwrite your old files directly:

import pastastore as pst

pstore = ... # connect to your old database
pstore.rebuild(rewrite_all_files=True)

If you run into any issues migrating your data, or loading old database, don't hesitate to get in touch.