Updated README.md

This commit is contained in:
Kevin Veen-Birkenbach 2023-09-04 19:12:44 +02:00
parent fa84080068
commit 74e5f3e73f

View File

@ -1,45 +1,59 @@
# baserow-ifto # Baserow IFTO API Wrapper
This repository contains the Input Filter Transform and Output (IFTO) scripts to work with Baserow data. This repository contains a Python-based API wrapper for Baserow, designed to provide Input, Filter, Transform, and Output (IFTO) functionalities for Baserow data.
## Usage ## Features
### Fetching All Data from a Baserow Database - Fetch all rows from a specific table in Baserow.
- Fetch all tables from a specific database in Baserow.
- Fetch all data from a specific database in Baserow.
- Handle API responses, including error checking and JSON decoding.
- Merge tables based on references.
- Command-line interface for fetching data.
We have a Python script that allows you to fetch all data from a Baserow database using its API. ## Getting Started
#### Requirements ### Prerequisites
- Python 3.x - Python 3.x
- `requests` library. You can install it using pip: - `requests` library. Install it using:
```bash
pip install requests
```
```bash ### Usage
pip install requests
```
#### How to Use
1. Clone this repository: 1. Clone this repository:
```bash
git clone https://github.com/yourusername/baserow-ifto.git
cd baserow-ifto
```
```bash 2. Use the script with the required arguments:
git clone https://github.com/yourusername/baserow-ifto.git ```bash
cd baserow-ifto python controller.py BASE_URL API_KEY --database_id DATABASE_ID
``` ```
2. Run the script with the required arguments: Replace `BASE_URL`, `API_KEY`, and `DATABASE_ID` with the appropriate values:
```bash - `BASE_URL`: Base URL of your Baserow instance, e.g., `https://YOUR_BASEROW_INSTANCE_URL/api/`
python fetch-all-data.py BASE_URL API_KEY DATABASE_ID - `API_KEY`: Your Baserow API key.
``` - `DATABASE_ID`: ID of the Baserow database you want to fetch data from.
Replace `BASE_URL`, `API_KEY`, `DATABASE_ID` with the appropriate values: The script will fetch all the data from the specified Baserow database and print it to the console.
- `BASE_URL`: Base URL of your Baserow instance, e.g., `https://YOUR_BASEROW_INSTANCE_URL/api/` ### Additional Options
- `API_KEY`: Your Baserow API key.
- `DATABASE_ID`: ID of the Baserow database you want to fetch data from.
The script will then fetch all the data from the specified Baserow database and print it to the console. - `--table_ids`: Specify IDs of the Baserow tables you want to fetch data from, separated by commas.
- `--matrix`: Merge tables based on references.
- `-v` or `--verbose`: Enable verbose mode for debugging.
- `--linked_fields`: Outputs the linked tables.
- `--quiet`: Suppress output of JSON.
## License
All rights to this code belong in equal parts to [Marco Petersen](mailto:m@rcopetersen.com) and [Kevin Veen-Birkenbach](mailto:kevin@veen.world).
## Contributing ## Contributing
If you have suggestions or improvements, feel free to open an issue or submit a pull request. Your contributions are welcome! If you have suggestions, improvements, or any issues, feel free to open an issue or submit a pull request. Your contributions are always welcome!