https://github.com/perrywerneck/python3-tn3270
Python bindings for lib3270/pw3270
https://github.com/perrywerneck/python3-tn3270
3270 mainframe python
Last synced: 5 months ago
JSON representation
Python bindings for lib3270/pw3270
- Host: GitHub
- URL: https://github.com/perrywerneck/python3-tn3270
- Owner: PerryWerneck
- License: lgpl-3.0
- Created: 2019-02-27T01:33:49.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-09T17:04:13.000Z (about 2 years ago)
- Last Synced: 2025-04-07T05:11:06.284Z (10 months ago)
- Topics: 3270, mainframe, python
- Language: C++
- Homepage:
- Size: 220 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# Python Extension Module for TN3270 Access
Provide python3 objects to remote control an active pw3270 window or to direct access a TN3270 host using lib3270.
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/PerryWerneck/python3-tn3270/actions/workflows/winpkg.yml)
[](https://build.opensuse.org/package/show/home:PerryWerneck:pw3270/python-tn3270)
## Installation
[
](https://software.opensuse.org/download.html?project=home%3APerryWerneck%3Apw3270&package=python3-tn3270)
[
](../../releases)
## Examples
Getting module version
```python
#!/usr/bin/python
#-*- coding: utf-8
import tn3270
print("Using py3270 Version " + tn3270.version() + " revision " + tn3270.revision())
```
Getting pw3270 version
```python
#!/usr/bin/python
#-*- coding: utf-8
import tn3270
session = tn3270.Session(":a")
print("Using PW3270 version " + session.version + " revision " + session.revision)
```
Connecting first pw3270 window to host (if not connected), getting contents
```python
#!/usr/bin/python
#-*- coding: utf-8
import tn3270
session = tn3270.Session(":a")
if session.reconnect.try_activate():
print("Reconnecting to host")
session.wait(10)
print(session)
```
Connecting to host by url, getting some information.
```python
#!/usr/bin/python
#-*- coding: utf-8
import tn3270
# Get TN3270 headless object
session = tn3270.Session("")
# Connect to host with 10 seconds timeout
session.connect("tn3270://localhost:3270",10)
# Show connection state.
print("Cstate: " + str(session.cstate))
print("Width: " + str(session.width))
print("Connected: " + str(session.connected))
# Show cursor position
print(session.cursor)
# Search for string on terminal
print(session.find("Host"))
# Count string
print(session.count("Host"))
# Get 38 characters at position 14,22
print(session.get(14,22,38))
session.disconnect()
input("Press enter to exit")
```
## Building from sources
### Linux
1. Install libipc3270-devel
2. Get python-tn3270 sources from git
```shell
git clone https://github.com/PerryWerneck/python-tn3270.git ./python-tn3270
```
3. Build the extension using setup.py
```shell
cd python-tn3270
python setup.py build
```
4. Install extension
```shell
python setup.py install
```
### Windows (With MSVC & Python SetupTools)
1. Download and install Visual Studio Build Tools (https://visualstudio.microsoft.com/pt-br/downloads/)
2. Get python-tn3270 sources from git
```shell
git clone https://github.com/PerryWerneck/python-tn3270.git ./python-tn3270
```
3. Download and unpack libipc3270 pre-compiled image
```shell
wget https://github.com/PerryWerneck/libipc3270/releases/download/5.5/msvc-libipc3270.zip
7z x msvc-libipc3270.zip -y -oipc3270
```
4. Build the extension using setup.py
```shell
cd python-tn3270
python setup.py build
```
5. Install extension
```shell
python setup.py install
```
6. Build windows installer (optional)
```shell
python setup.py bdist_wininst
```