Hestia DBeaver Connector
A plugin for the Hestia data platform that provides seamless integration with DBeaver database management tool.
Features
- Automatic DBeaver Detection: Finds DBeaver installation across Windows, macOS, and Linux
- Database Connection Management: Configure and manage multiple database connections
- Hestia Integration: Export and import data between Hestia and DBeaver
- Cross-Platform Support: Works on Windows, macOS, and Linux
- Secure Configuration: Stores credentials and settings securely
Installation
Prerequisites
- Python 3.7 or higher
- PyQt5
- DBeaver installed on your system
Install the Plugin
pip install hestia-dbeaver-connector
Development Installation
git clone https://github.com/hestia/dbeaver-connector.git
cd dbeaver-connector
pip install -e .
Usage
Integration with Hestia
The plugin integrates automatically with Hestia's setup wizard. When you run Hestia:
- Setup Wizard: Choose "DBeaver" from the available integrations
- Configuration: The plugin will detect your DBeaver installation
- Database Setup: Configure your database connections
- Testing: Verify the connection works properly
Manual Configuration
You can also configure the plugin manually:
from hestia_dbeaver_connector import register_with_hestia
# Launch the configuration dialog
result = register_with_hestia()
if result:
print("Configuration saved successfully!")
Configuration Options
The plugin provides several configuration options:
Basic Configuration
- DBeaver Path: Automatic detection or manual selection
- Connection Testing: Verify DBeaver installation and connectivity
Database Connections
- Multiple Databases: Configure connections to PostgreSQL, MySQL, SQLite, etc.
- Connection Management: Add, edit, and remove database connections
- Connection Testing: Test each connection before saving
Advanced Settings
- Auto-Detection: Automatically detect DBeaver on startup
- Auto-Connect: Automatically connect to known databases
- Export/Import: Enable data exchange with Hestia
Supported Databases
The plugin supports all databases that DBeaver supports:
- PostgreSQL
- MySQL/MariaDB
- SQLite
- Oracle
- SQL Server
- MongoDB
- And many more...
Configuration Storage
The plugin stores configuration in:
- Windows:
%APPDATA%\hestia\plugins\dbeaver\dbeaver_config.json - macOS/Linux:
~/.config/hestia/plugins/dbeaver/dbeaver_config.json
Development
Project Structure
hestia_dbeaver_package/
├── hestia_dbeaver_connector/
│ ├── __init__.py
│ └── dbeaver_plugin.py
├── setup.py
├── README.md
└── tests/
Running Tests
pip install -e .[dev]
pytest tests/
Building for Distribution
python setup.py sdist bdist_wheel
Troubleshooting
DBeaver Not Found
If the plugin cannot find DBeaver:
- Verify Installation: Make sure DBeaver is installed
- Manual Path: Use the "Browse" button to locate the executable
- Common Locations:
- Windows:
C:\Program Files\DBeaver\dbeaver.exe - macOS:
/Applications/DBeaver.app/Contents/MacOS/dbeaver - Linux:
/usr/bin/dbeaver
- Windows:
Connection Issues
If database connections fail:
- Check Credentials: Verify username, password, and database name
- Network Access: Ensure the database server is accessible
- Firewall: Check if firewall is blocking the connection
- DBeaver Test: Try connecting directly in DBeaver first
Plugin Not Loading
If Hestia doesn't detect the plugin:
- Verify Installation:
pip list | grep hestia-dbeaver-connector - Check Python Path: Ensure the package is in your Python environment
- Restart Hestia: Restart the Hestia application
- Manual Import: Try importing the package manually
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests for new functionality
- Submit a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
For support and questions:
- Issues: Create an issue on GitHub
- Documentation: Check the Hestia documentation
- Community: Join the Hestia community forum
Changelog
Version 0.1.0
- Initial release
- Basic DBeaver integration
- Configuration dialog
- Cross-platform support
- Automatic DBeaver detection
Metadata
Release files for hestia-dbeaver-connector 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hestia_dbeaver_connector-0.1.0.tar.gz | 9.2 kB | Without provenance | Details for hestia_dbeaver_connector-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hestia_dbeaver_connector-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for hestia_dbeaver_connector-0.1.0-py3-none-any.whl |
Total release size: 19.0 kB
Release files / hestia_dbeaver_connector-0.1.0.tar.gz
| Download URL | hestia_dbeaver_connector-0.1.0.tar.gz |
|---|---|
| Size | 9.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4e93bad80660420f3cd7c09f4eac82bc8bae4c0ee2bc14aaa9d9abcf2179acf1
|
|
BLAKE2b-256 checksum How to use checksums |
52a287ed539e898b17e2deef6d53eceb19ecf92280c75f4e946a8415c4bdc273
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Release files / hestia_dbeaver_connector-0.1.0-py3-none-any.whl
| Download URL | hestia_dbeaver_connector-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
84a6f0b25ad0e3b1bbe59adc6137290bcc8b0aefc210b3fb09fc2f247a6c0c59
|
|
BLAKE2b-256 checksum How to use checksums |
7c9213ff50f5a30c7c47250e28d8c93bfcd4b936d75c1846bec91f821fc0e4c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Security for hestia-dbeaver-connector 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.