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 ```bash
pip install requests pip install requests
``` ```
#### How to Use ### Usage
1. Clone this repository: 1. Clone this repository:
```bash ```bash
git clone https://github.com/yourusername/baserow-ifto.git git clone https://github.com/yourusername/baserow-ifto.git
cd baserow-ifto cd baserow-ifto
``` ```
2. Run the script with the required arguments: 2. Use the script with the required arguments:
```bash ```bash
python fetch-all-data.py BASE_URL API_KEY DATABASE_ID python controller.py BASE_URL API_KEY --database_id DATABASE_ID
``` ```
Replace `BASE_URL`, `API_KEY`, `DATABASE_ID` with the appropriate values: Replace `BASE_URL`, `API_KEY`, and `DATABASE_ID` with the appropriate values:
- `BASE_URL`: Base URL of your Baserow instance, e.g., `https://YOUR_BASEROW_INSTANCE_URL/api/` - `BASE_URL`: Base URL of your Baserow instance, e.g., `https://YOUR_BASEROW_INSTANCE_URL/api/`
- `API_KEY`: Your Baserow API key. - `API_KEY`: Your Baserow API key.
- `DATABASE_ID`: ID of the Baserow database you want to fetch data from. - `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. The script will fetch all the data from the specified Baserow database and print it to the console.
### Additional Options
- `--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!