| Name | sapguipy JSON |
| Version |
0.0.6
JSON |
| download |
| home_page | None |
| Summary | Manipulate SAP GUI with some lines of code |
| upload_time | 2024-11-14 20:39:51 |
| maintainer | None |
| docs_url | None |
| author | Nicolas Passos |
| requires_python | >=3.8 |
| license | MIT License |
| keywords |
sap
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# sapguipy
Sapguipy is designed to manipulate SAP GUI with some lines of code. It can be used to facilitate complexes RPA developments, realize tests or even to execute simple macros on SAP GUI.
### Key Features
1. **SAP Integration:** Uses SAP Script, that was especifully builded for manipulate the SAP GUI. If you never heard about, see the docs of [SAP Script](https://help.sap.com/docs/sap_gui_for_windows/b47d018c3b9b45e897faf66a6c0885a8/babdf65f4d0a4bd8b40f5ff132cb12fa.html).
2. **Flexible Configuration:** Configure to suit your needs.
## SAP Configuration
Before use this package, you must configure your SAP to accept scripts without notify.
Go to SAP configuration -> Accessbility and Scripting -> Scripting -> Uncheck the option "Notify when a script attaches to SAP GUI".
Save and you can go ahead to use this package.
## Usage:
To install this package, ensure you have Python installed.
### install with pip:
```bash
pip install sapguipy
```
### Import it
```python
from sapguipy import SapGui
```
### Run it
Fill the parameters with your SAP info and credentials:
```python
sap = SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT')
sap.login()
sap.start_transaction('SU01D')
```
You can use with context management too (i recommend using instead of the previous example):
```python
with SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT') as sap:
sap.open_transaction('SU01D')
```
### The sky is the limit (or in this case, SAP Script)
You can do whatever you want with SAP session generated.
If the methods of this package don't do what you need, you can build for your own using SAP Script docs.
```python
with SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT') as sap:
height_windows = sap.session.findById('wnd[0]').Height
with_window = sap.session.findById('wnd[0]').Width
status_bar_text = sap.session.findById("wnd[0]/sbar/pane[0]").text
```
### How it works
This package abstracts and padronize the most utilized methods of SAP Script. So, you can worry only about your business rules.
### How to Contribute
If you find some other functionality that is util or relevant to implement in this package, feel free to contribute.
We welcome contributions from the community and are pleased to have you join us.
### Prerequisites
Before contributing, please ensure you have the following:
- A basic understanding of Python and SAP Script.
### Setting Up Your Development Environment
1. **Fork the Repository**: Start by forking the repository to your GitHub account.
2. **Clone the Repository**: Clone your fork to your local machine.
```bash
git clone https://github.com/NicolasPassos/sappy
cd repository-name
```
3. **Install Dependencies**: Install the required dependencies.
```bash
pip install -r requirements.txt
```
### Making Changes
1. **Create a New Branch**: Create a new branch for your feature or bug fix.
```bash
git checkout -b awesome-feature
```
2. **Make Your Changes**: Implement your feature or fix a bug. Be sure to adhere to the coding standards and include comments where necessary.
### Submitting a Pull Request
1. **Commit Your Changes**: Once your tests pass, commit your changes.
```bash
git commit -m 'Add some feature'
```
2. **Push to GitHub**: Push your changes to your fork on GitHub.
```bash
git push origin awesome-feature
```
3. **Open a Pull Request**: Go to the original repository and click the *Compare & pull request* button. Then submit your pull request with a clear title and description.
### Code Review
Once your pull request is opened, it will be reviewed by the maintainers. Some changes may be requested. Please be patient and responsive. Once the pull request has been approved, it will be merged into the master branch.
Thank you for contributing!
Raw data
{
"_id": null,
"home_page": null,
"name": "sapguipy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "sap",
"author": "Nicolas Passos",
"author_email": "nicolasduart21@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ee/7d/0cdd21ba206b44e524a36458a376226fe5d97730df09bdb0d5667e81b482/sapguipy-0.0.6.tar.gz",
"platform": null,
"description": "\r\n# sapguipy\r\n\r\nSapguipy is designed to manipulate SAP GUI with some lines of code. It can be used to facilitate complexes RPA developments, realize tests or even to execute simple macros on SAP GUI.\r\n\r\n### Key Features\r\n\r\n1. **SAP Integration:** Uses SAP Script, that was especifully builded for manipulate the SAP GUI. If you never heard about, see the docs of [SAP Script](https://help.sap.com/docs/sap_gui_for_windows/b47d018c3b9b45e897faf66a6c0885a8/babdf65f4d0a4bd8b40f5ff132cb12fa.html).\r\n2. **Flexible Configuration:** Configure to suit your needs.\r\n\r\n## SAP Configuration\r\nBefore use this package, you must configure your SAP to accept scripts without notify.\r\nGo to SAP configuration -> Accessbility and Scripting -> Scripting -> Uncheck the option \"Notify when a script attaches to SAP GUI\".\r\n\r\n\r\n\r\nSave and you can go ahead to use this package.\r\n\r\n## Usage:\r\n\r\nTo install this package, ensure you have Python installed.\r\n\r\n### install with pip:\r\n\r\n```bash\r\npip install sapguipy\r\n```\r\n### Import it\r\n```python\r\nfrom sapguipy import SapGui\r\n```\r\n\r\n### Run it\r\nFill the parameters with your SAP info and credentials:\r\n\r\n```python\r\nsap = SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT')\r\nsap.login()\r\nsap.start_transaction('SU01D')\r\n```\r\nYou can use with context management too (i recommend using instead of the previous example):\r\n```python\r\nwith SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT') as sap:\r\n\tsap.open_transaction('SU01D')\r\n```\r\n\r\n### The sky is the limit (or in this case, SAP Script)\r\nYou can do whatever you want with SAP session generated.\r\nIf the methods of this package don't do what you need, you can build for your own using SAP Script docs.\r\n```python\r\nwith SapGui(sid='PRD',user='USR',pwd='AnPassword',mandante='900',language='PT') as sap:\r\n\theight_windows = sap.session.findById('wnd[0]').Height\r\n\twith_window = sap.session.findById('wnd[0]').Width\r\n\tstatus_bar_text = sap.session.findById(\"wnd[0]/sbar/pane[0]\").text\r\n```\r\n### How it works\r\nThis package abstracts and padronize the most utilized methods of SAP Script. So, you can worry only about your business rules.\r\n### How to Contribute\r\nIf you find some other functionality that is util or relevant to implement in this package, feel free to contribute.\r\nWe welcome contributions from the community and are pleased to have you join us.\r\n\r\n### Prerequisites\r\n\r\nBefore contributing, please ensure you have the following:\r\n- A basic understanding of Python and SAP Script.\r\n\r\n### Setting Up Your Development Environment\r\n\r\n1. **Fork the Repository**: Start by forking the repository to your GitHub account.\r\n2. **Clone the Repository**: Clone your fork to your local machine.\r\n ```bash\r\n git clone https://github.com/NicolasPassos/sappy\r\n cd repository-name\r\n ```\r\n3. **Install Dependencies**: Install the required dependencies.\r\n ```bash\r\n pip install -r requirements.txt\r\n ```\r\n\r\n### Making Changes\r\n\r\n1. **Create a New Branch**: Create a new branch for your feature or bug fix.\r\n ```bash\r\n git checkout -b awesome-feature\r\n ```\r\n2. **Make Your Changes**: Implement your feature or fix a bug. Be sure to adhere to the coding standards and include comments where necessary.\r\n\r\n### Submitting a Pull Request\r\n\r\n1. **Commit Your Changes**: Once your tests pass, commit your changes.\r\n ```bash\r\n git commit -m 'Add some feature'\r\n ```\r\n2. **Push to GitHub**: Push your changes to your fork on GitHub.\r\n ```bash\r\n git push origin awesome-feature\r\n ```\r\n3. **Open a Pull Request**: Go to the original repository and click the *Compare & pull request* button. Then submit your pull request with a clear title and description.\r\n\r\n### Code Review\r\n\r\nOnce your pull request is opened, it will be reviewed by the maintainers. Some changes may be requested. Please be patient and responsive. Once the pull request has been approved, it will be merged into the master branch.\r\n\r\nThank you for contributing!\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Manipulate SAP GUI with some lines of code",
"version": "0.0.6",
"project_urls": null,
"split_keywords": [
"sap"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ee7d0cdd21ba206b44e524a36458a376226fe5d97730df09bdb0d5667e81b482",
"md5": "185f48f0c526811145af24b0a2b49367",
"sha256": "6171bc22ceb663afba08230a2e06053740b7068bc265581c9595c2db755f6c34"
},
"downloads": -1,
"filename": "sapguipy-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "185f48f0c526811145af24b0a2b49367",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 6374,
"upload_time": "2024-11-14T20:39:51",
"upload_time_iso_8601": "2024-11-14T20:39:51.587971Z",
"url": "https://files.pythonhosted.org/packages/ee/7d/0cdd21ba206b44e524a36458a376226fe5d97730df09bdb0d5667e81b482/sapguipy-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-14 20:39:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sapguipy"
}
