Installation

Pure3270 requires Python 3.10 or later. It is recommended to use a virtual environment for isolation.

Requirements

• Python 3.10 or later

• No external runtime dependencies (uses only Python standard library)

Installation Methods

Stable Release

To install Pure3270, run this command in your terminal:

pip install pure3270

This is the preferred method to install Pure3270, as it will always install the most recent stable release.

Development Version

If you’d like to install the latest development version, you can clone the repository and install it in editable mode:

git clone https://github.com/dtg01100/pure3270.git
cd pure3270
python -m pip install -e .

Virtual Environment Installation

It’s recommended to use a virtual environment to avoid conflicts with other Python packages:

python -m venv pure3270-env
source pure3270-env/bin/activate  # On Windows: pure3270-env\Scripts\activate
pip install pure3270

To deactivate the virtual environment when you’re done:

deactivate

Quick Start

After installation, you can quickly test a basic connection:

from pure3270 import Session

with Session() as session:
    session.connect('your-host.example.com', port=23, ssl_context=None)
    screen = session.read()
    print(session.ascii(screen))

For more examples, see the Examples section.