# KeePass Library
This library enables Robot Framework to interact with KeePass databases.
[](https://github.com/loomanw/robotframework-keepasslibrary/actions/workflows/python-package.yml)
[](https://github.com/loomanw/robotframework-keepasslibrary)
[](https://pyup.io/repos/github/loomanw/robotframework-keepasslibrary)
Supported KeePass versions:
- KDBX3
- KDBX4
KeepassLibrary uses the [PyKeePass](https://pypi.org/project/pykeepass/) modules internally to access KeePass databases
See https://keepass.info for more information about KeePass in general
---
### Keyword Documentation
See [keyword documentation](https://loomanw.github.io/robotframework-keepasslibrary/KeePassLibrary.html) for available keywords and more information about the library in general.
---
### Installation
The recommended approach to install KeePassLibrary, regardless the version, is using [pip](http://pip-installer.org/).
Install (or upgrade) the latest KeePassLibrary version:
pip install --upgrade robotframework-keepasslibrary
---
### Example
```robotframework
*** Settings ***
Documentation A test suite with a single test for retrieving a password.
...
... The test opens a KeePass database named Database.kdbx using
... the keyfile Database.key.
... It then retrieves the first entry that matches the Username "User Name"
... and logs the password from the returned KeePass database entry
Library KeePassLibrary
*** Test Cases ***
Get KeePass Database Entry
Open KeePass Database Database.kdbx keyfile=Database.key
${entry}= Get Entries By Username User Name first=True
${value}= Get Entry Password ${entry}
Log Password for User Name is ${value}
```
---
### Versions:
- `0.4.0` Update dependencies, rework for pykeepas 4.x with keyfile v2 support, additional test cases
- `0.3.1` Update dependencies, tests moved to github actions
- `0.3.0` New keywords for accessing entry and group data, rebuild of code using [Python Library Core](https://github.com/robotframework/PythonLibCore).
- `0.2.5` Fix manifest, additional test cases
- `0.2.4` Update dependencies
- `0.2.3` Update dependencies, new travis builds
- `0.2.2` Update dependencies
- `0.2.1` KDBX v3 and v4 test cases
- `0.2.0` Group Support
- `0.1.0` Entry Support
Raw data
{
"_id": null,
"home_page": "https://github.com/loomanw/robotframework-keepasslibrary",
"name": "robotframework-keepasslibrary",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6, <4",
"maintainer_email": "",
"keywords": "",
"author": "William Looman",
"author_email": "wlooman@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/09/4e/d67a555f1e7b80762c31479f7d7d817ec47f9f3a5a364117eb123db030ab/robotframework-keepasslibrary-0.4.0.tar.gz",
"platform": null,
"description": "\r\n# KeePass Library\r\n\r\nThis library enables Robot Framework to interact with KeePass databases.\r\n\r\n[](https://github.com/loomanw/robotframework-keepasslibrary/actions/workflows/python-package.yml) \r\n[](https://github.com/loomanw/robotframework-keepasslibrary) \r\n \r\n \r\n[](https://pyup.io/repos/github/loomanw/robotframework-keepasslibrary)\r\n\r\nSupported KeePass versions:\r\n- KDBX3\r\n- KDBX4\r\n \r\nKeepassLibrary uses the [PyKeePass](https://pypi.org/project/pykeepass/) modules internally to access KeePass databases\r\n \r\nSee https://keepass.info for more information about KeePass in general\r\n\r\n---\r\n### Keyword Documentation\r\nSee [keyword documentation](https://loomanw.github.io/robotframework-keepasslibrary/KeePassLibrary.html) for available keywords and more information about the library in general.\r\n\r\n---\r\n### Installation\r\nThe recommended approach to install KeePassLibrary, regardless the version, is using [pip](http://pip-installer.org/).\r\n\r\nInstall (or upgrade) the latest KeePassLibrary version:\r\n\r\n pip install --upgrade robotframework-keepasslibrary\r\n\r\n---\r\n### Example\r\n\r\n```robotframework\r\n*** Settings ***\r\nDocumentation A test suite with a single test for retrieving a password.\r\n...\r\n... The test opens a KeePass database named Database.kdbx using \r\n... the keyfile Database.key. \r\n... It then retrieves the first entry that matches the Username \"User Name\"\r\n... and logs the password from the returned KeePass database entry\r\nLibrary KeePassLibrary\r\n\r\n*** Test Cases ***\r\nGet KeePass Database Entry\r\n Open KeePass Database Database.kdbx keyfile=Database.key \r\n ${entry}= Get Entries By Username User Name first=True\r\n ${value}= Get Entry Password ${entry} \r\n Log Password for User Name is ${value}\r\n```\r\n\r\n---\r\n### Versions:\r\n - `0.4.0` Update dependencies, rework for pykeepas 4.x with keyfile v2 support, additional test cases \r\n - `0.3.1` Update dependencies, tests moved to github actions \r\n - `0.3.0` New keywords for accessing entry and group data, rebuild of code using [Python Library Core](https://github.com/robotframework/PythonLibCore).\r\n - `0.2.5` Fix manifest, additional test cases\r\n - `0.2.4` Update dependencies\r\n - `0.2.3` Update dependencies, new travis builds\r\n - `0.2.2` Update dependencies\r\n - `0.2.1` KDBX v3 and v4 test cases\r\n - `0.2.0` Group Support\r\n - `0.1.0` Entry Support\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Robot Framework library for working with KeePass Database",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://github.com/loomanw/robotframework-keepasslibrary"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b3b9eb8ef024d55281cb38db80c54eaa7926f85168585870d442c5e42564efc3",
"md5": "c4aaf5d42058cb00eda5c7bba91be566",
"sha256": "e5c1363e4ceef4a930654d4577300f63ed815fb72a426216d4713e37bbf56cae"
},
"downloads": -1,
"filename": "robotframework_keepasslibrary-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c4aaf5d42058cb00eda5c7bba91be566",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6, <4",
"size": 16218,
"upload_time": "2023-07-18T17:44:58",
"upload_time_iso_8601": "2023-07-18T17:44:58.627296Z",
"url": "https://files.pythonhosted.org/packages/b3/b9/eb8ef024d55281cb38db80c54eaa7926f85168585870d442c5e42564efc3/robotframework_keepasslibrary-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "094ed67a555f1e7b80762c31479f7d7d817ec47f9f3a5a364117eb123db030ab",
"md5": "6275c7dce58db329af6dfee9003a26ea",
"sha256": "fbb76bab89cac3befa2f4fb6860c6c0a424c2ae21f413789fd84695569019062"
},
"downloads": -1,
"filename": "robotframework-keepasslibrary-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "6275c7dce58db329af6dfee9003a26ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6, <4",
"size": 101838,
"upload_time": "2023-07-18T17:45:02",
"upload_time_iso_8601": "2023-07-18T17:45:02.881017Z",
"url": "https://files.pythonhosted.org/packages/09/4e/d67a555f1e7b80762c31479f7d7d817ec47f9f3a5a364117eb123db030ab/robotframework-keepasslibrary-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-18 17:45:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "loomanw",
"github_project": "robotframework-keepasslibrary",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pykeepass",
"specs": [
[
"==",
"4.0.5"
]
]
},
{
"name": "robotframework",
"specs": [
[
">=",
"3.2.2"
]
]
},
{
"name": "robotframework-pythonlibcore",
"specs": [
[
">=",
"3.0.0"
]
]
}
],
"lcname": "robotframework-keepasslibrary"
}
JSON
