Getting started¶

This page assumes nothing. If you already work in Python daily, you only need the first section.

Install¶

pip install pymzlib

Then check it:

import pymzlib
print(pymzlib.bridge_version())
# {'bridge': '1.0.0.0', 'protocol': 1, 'runtime': '8.0.27'}

If that prints, everything works — including the .NET runtime bundled inside the package, which is what runtime is reporting.

Your first real call¶

import pymzlib

files = pymzlib.pride.list_files("PXD000001")

for f in files:
    print(f"{f.category:8s} {f.size_mb:9.1f} MB  {f.file_name}")

OTHER          0.5 MB  PRIDE_Exp_Complete_Ac_22134.pride.mztab.gz
PEAK          16.4 MB  PRIDE_Exp_Complete_Ac_22134.pride.mgf.gz
PEAK         243.0 MB  TMT_Erwinia_1uLSike_Top10HCD_isol2_45stepped_60min_01.mzXML
OTHER          1.7 MB  erwinia_carotovora.fasta
...

Continue with the PRIDE guide.

If Python itself is new to you¶

Nothing below is required to use pyMzLib. It's here because the questions are real and the answers are not obvious from the outside.

"Which Python do I have?"¶

Probably several, and that is the normal state of affairs. Python has no equivalent of a global assembly cache: each installation carries its own separate set of packages, so "is X installed?" is only answerable relative to which Python you mean.

pyMzLib is built so that this matters as little as possible. It works on Python 3.9 and newer, declares no dependencies, and therefore cannot be the reason an install fails. Whichever Python you have, it will very likely just work.

"Will installing this break something else?"¶

It cannot. Python allows exactly one version of any given package per environment, so packages that pull in numpy or pandas can genuinely deadlock each other's requirements. pyMzLib requires nothing, so it has nothing to disagree with. This was a design constraint, not an accident.

The one habit worth adopting: a virtual environment¶

A virtual environment is a private folder holding one Python and its own packages, so that projects can't disturb each other. It ships with Python — nothing to install:

WindowsmacOS / Linux

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install pymzlib

python -m venv .venv
source .venv/bin/activate
pip install pymzlib

Once activated, python and pip mean the ones inside .venv. Delete the folder and every trace is gone. If a Python environment ever confuses you, deleting .venv and recreating it is a legitimate and complete fix — nothing is registered anywhere else.

If you want the modern version of this

uv is a single executable that manages Python interpreters and environments, so you never install Python at all: uv venv && uv pip install pymzlib. It is dramatically faster and removes most remaining ways to get confused.

Reading the results¶

list_files() returns a plain Python list of PrideFile objects. Ordinary list operations work on it:

raw = [f for f in files if f.category == "RAW"]          # filter
big = [f for f in files if f.size_mb > 100]              # filter
total = sum(f.file_size_bytes for f in files)            # aggregate
by_size = sorted(files, key=lambda f: -f.file_size_bytes)  # sort

If you use pandas, a manifest converts in one line — pyMzLib doesn't require pandas, but it doesn't get in the way either. Use as_dict() rather than vars(): size_mb, extension and downloadable are computed properties, so vars() silently leaves them out.

import pandas as pd
df = pd.DataFrame([f.as_dict() for f in files])

When something goes wrong¶

pyMzLib raises typed exceptions, so you can tell a mistake in your call from a failure out in the world:

try:
    files = pymzlib.pride.list_files("PXD000001")
except pymzlib.UsageError:
    ...   # something about the call itself was invalid
except pymzlib.BridgeError as e:
    ...   # PRIDE or mzLib failed; e.error_type says which way

See the FAQ for specific failure messages.