# Personal Interface
The Personal Interface is a Python project that provides a simple model for connecting to a database using the Deta library, among other utilities as loggers. It offers basic database operations such as querying, creating, updating, and deleting records. This README provides an overview of the project, installation instructions, and usage examples.
## Table of Contents
- [Personal Interface](#personal-interface)
- [Table of Contents](#table-of-contents)
- [Installation](#installation)
- [Usage](#usage)
- [DetaDatabase](#detadatabase)
- [Contributing](#contributing)
- [License](#license)
## Installation
Before you can use the Personal Interface, make sure you have Python installed on your system. You'll also need to set up a Deta project and obtain an API key. Follow these steps to get started:
1. Clone the repository:
```bash
pip install personal_interfaces
```
2. Set your Deta project API key as an environment variable:
### Method 1
Using bash:
```bash
export DB_ACCESS_TOKEN=your_api_key
```
### Method 2
Using a `.env`
```env
DB_ACCESS_TOKEN = your_api_key
```
Replace `your_api_key` with your actual Deta API key.
3. Set your private API key to access and use the code:
### Method 1
Using bash:
```bash
export API_KEY=your_api_key
```
### Method 2
Using a `.env`
```env
API_KEY = your_api_key
```
Replace `your_api_key` with your actual Deta API key.
## Usage
This interface can only be used with a private `API_KEY`. Without it, the tool is not functional.
### DetaDatabase
The Personal Interface provides a simple way to interact with your Deta database. Here's how you can use it in your Python code:
1. Import the `DetaDatabase` class:
```python
from personal_interfaces import DetaDatabase
```
2. Create an instance of the `DetaDatabase` class and connect to your Deta database:
```python
db = DetaDatabase()
db.connect("your_database_name")
```
Replace `"your_database_name"` with the name of your Deta database.
3. Perform database operations such as querying, creating, updating, and deleting records using the provided methods. For example:
```python
# Query for records
data = {"name": "John"}
results = db.query(data, filter_by="equal")
# Create a new record
new_data = {"name": "Alice", "age": 30}
key = db.create(new_data)
# Update an existing record
updated_data = {"key": key, "age": 31}
db.update(updated_data)
# Delete a record by its key
db.delete(key)
```
For more details on how to use the Personal Interface, refer to the [Python code documentation](https://github.com/ricardoleal20/deta_personal_interface/blob/main/deta_personal_interface/__main__.py) in the repository.
## Contributing
Contributions to this project are welcome! If you have suggestions, feature requests, or would like to report a bug, please open an issue on the [GitHub repository](https://github.com/ricardoleal20/deta_personal_interface). If you'd like to contribute code, please fork the repository, make your changes, and submit a pull request.
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/ricardoleal20/deta_personal_interface/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/ricardoleal20/personal_interface/",
"name": "personal-interfaces",
"maintainer": "Ricardo Leal",
"docs_url": null,
"requires_python": "<4,>=3.8",
"maintainer_email": "ricardo.lealpz@gmail.com",
"keywords": "development, personal_usage",
"author": "Ricardo Leal",
"author_email": "ricardo.lealpz@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ce/fe/f60fb79396c6b6bccc5cdad89d3b3254764d90d1cbecaa724b99e5d4fddd/personal_interfaces-0.4.2.tar.gz",
"platform": null,
"description": "# Personal Interface\n\nThe Personal Interface is a Python project that provides a simple model for connecting to a database using the Deta library, among other utilities as loggers. It offers basic database operations such as querying, creating, updating, and deleting records. This README provides an overview of the project, installation instructions, and usage examples.\n\n## Table of Contents\n\n- [Personal Interface](#personal-interface)\n - [Table of Contents](#table-of-contents)\n - [Installation](#installation)\n - [Usage](#usage)\n - [DetaDatabase](#detadatabase)\n - [Contributing](#contributing)\n - [License](#license)\n\n## Installation\n\nBefore you can use the Personal Interface, make sure you have Python installed on your system. You'll also need to set up a Deta project and obtain an API key. Follow these steps to get started:\n\n1. Clone the repository:\n\n ```bash\n pip install personal_interfaces\n ```\n\n2. Set your Deta project API key as an environment variable:\n\n ### Method 1\n\n Using bash:\n ```bash\n export DB_ACCESS_TOKEN=your_api_key\n ```\n\n ### Method 2\n\n Using a `.env`\n ```env\n DB_ACCESS_TOKEN = your_api_key\n ```\n\n Replace `your_api_key` with your actual Deta API key.\n\n3. Set your private API key to access and use the code:\n\n ### Method 1\n\n Using bash:\n ```bash\n export API_KEY=your_api_key\n ```\n\n ### Method 2\n\n Using a `.env`\n ```env\n API_KEY = your_api_key\n ```\n\n Replace `your_api_key` with your actual Deta API key.\n\n## Usage\n\nThis interface can only be used with a private `API_KEY`. Without it, the tool is not functional.\n\n### DetaDatabase\n\nThe Personal Interface provides a simple way to interact with your Deta database. Here's how you can use it in your Python code:\n\n1. Import the `DetaDatabase` class:\n\n ```python\n from personal_interfaces import DetaDatabase\n ```\n\n2. Create an instance of the `DetaDatabase` class and connect to your Deta database:\n\n ```python\n db = DetaDatabase()\n db.connect(\"your_database_name\")\n ```\n\n Replace `\"your_database_name\"` with the name of your Deta database.\n\n3. Perform database operations such as querying, creating, updating, and deleting records using the provided methods. For example:\n\n ```python\n # Query for records\n data = {\"name\": \"John\"}\n results = db.query(data, filter_by=\"equal\")\n\n # Create a new record\n new_data = {\"name\": \"Alice\", \"age\": 30}\n key = db.create(new_data)\n\n # Update an existing record\n updated_data = {\"key\": key, \"age\": 31}\n db.update(updated_data)\n\n # Delete a record by its key\n db.delete(key)\n ```\n\nFor more details on how to use the Personal Interface, refer to the [Python code documentation](https://github.com/ricardoleal20/deta_personal_interface/blob/main/deta_personal_interface/__main__.py) in the repository.\n\n## Contributing\n\nContributions to this project are welcome! If you have suggestions, feature requests, or would like to report a bug, please open an issue on the [GitHub repository](https://github.com/ricardoleal20/deta_personal_interface). If you'd like to contribute code, please fork the repository, make your changes, and submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/ricardoleal20/deta_personal_interface/blob/main/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "0.4.2",
"project_urls": {
"Bug Reports": "https://github.com/ricardoleal20/personal_interface/issues",
"Homepage": "https://github.com/ricardoleal20/personal_interface/"
},
"split_keywords": [
"development",
" personal_usage"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "925bd8c777f634ccb6b6e98d46e022d70ba689cf127bb11656d870fe90e960ca",
"md5": "0df9de68f0e1ef26598039a3769d2d04",
"sha256": "e2deffe1bc062da27d2dd103608b86cab7cb280a47c323b3fcb98073a7d468df"
},
"downloads": -1,
"filename": "personal_interfaces-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0df9de68f0e1ef26598039a3769d2d04",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.8",
"size": 31064,
"upload_time": "2024-05-18T20:28:12",
"upload_time_iso_8601": "2024-05-18T20:28:12.267830Z",
"url": "https://files.pythonhosted.org/packages/92/5b/d8c777f634ccb6b6e98d46e022d70ba689cf127bb11656d870fe90e960ca/personal_interfaces-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cefef60fb79396c6b6bccc5cdad89d3b3254764d90d1cbecaa724b99e5d4fddd",
"md5": "9df14261567af642b613269f6a409813",
"sha256": "7e63bba94f785e41fcd1f92f9903250eb266ddec0798242095b6efe92b99b339"
},
"downloads": -1,
"filename": "personal_interfaces-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "9df14261567af642b613269f6a409813",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.8",
"size": 25596,
"upload_time": "2024-05-18T20:28:14",
"upload_time_iso_8601": "2024-05-18T20:28:14.041597Z",
"url": "https://files.pythonhosted.org/packages/ce/fe/f60fb79396c6b6bccc5cdad89d3b3254764d90d1cbecaa724b99e5d4fddd/personal_interfaces-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-18 20:28:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ricardoleal20",
"github_project": "personal_interface",
"github_not_found": true,
"lcname": "personal-interfaces"
}
JSON
