| .. Licensed to the Apache Software Foundation (ASF) under one |
| .. or more contributor license agreements. See the NOTICE file |
| .. distributed with this work for additional information |
| .. regarding copyright ownership. The ASF licenses this file |
| .. to you under the Apache License, Version 2.0 (the |
| .. "License"); you may not use this file except in compliance |
| .. with the License. You may obtain a copy of the License at |
| |
| .. http://www.apache.org/licenses/LICENSE-2.0 |
| |
| .. Unless required by applicable law or agreed to in writing, |
| .. software distributed under the License is distributed on an |
| .. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| .. KIND, either express or implied. See the License for the |
| .. specific language governing permissions and limitations |
| .. under the License. |
| |
| Apache Arrow Cookbooks |
| ====================== |
| |
| Cookbooks are a collection of recipes about common tasks |
| that Arrow users might want to do. The cookbook is actually |
| composed of multiple cookbooks, one for each supported platform, |
| which contain the recipes for that specific platform. |
| |
| The cookbook aims to provide immediate instructions for common tasks, in |
| contrast with the `Arrow User Guides <https://arrow.apache.org/docs/index.html>`_ |
| which provides in-depth explanation. In terms of the `Diátaxis framework |
| <https://diataxis.fr/>`_, the cookbook is *task-oriented* while the user guide |
| is *learning-oriented*. The cookbook will often refer to the user guide for |
| deeper explanation. |
| |
| All cookbooks are buildable to HTML and verifiable by running |
| a set of tests that confirm that the recipes are still working |
| as expected. |
| |
| Each cookbook is implemented using platform specific tools. |
| For this reason a Makefile is provided which abstracts platform |
| specific concerns and makes it possible to build/test all cookbooks |
| without any platform specific knowledge (as long as dependencies |
| are available on the target system). |
| |
| See https://arrow.apache.org/cookbook/ for the latest published version using the |
| latest stable version of Apache Arrow. |
| See https://arrow.apache.org/cookbook/dev for the latest published version using |
| the development version of Apache Arrow. |
| |
| Building All Cookbooks |
| ---------------------- |
| |
| ``make all`` |
| |
| Testing All Cookbooks |
| --------------------- |
| |
| ``make test`` |
| |
| Listing Available Commands |
| -------------------------- |
| |
| ``make help`` |
| |
| Building Platform Specific Cookbook |
| ----------------------------------- |
| |
| Refer to ``make help`` to learn the |
| commands that build or test the cookbook for the platform you |
| are targeting. |
| |
| Prerequisites |
| ============= |
| |
| Both the R and Python cookbooks will try to install the |
| dependencies they need (including latests pyarrow/arrow-R version). |
| This means that as far as you have a working Python/R environment |
| able to install dependencies through the respective package manager |
| you shouldn't need to install anything manually. |
| |
| Contributing to the Cookbook |
| ============================ |
| |
| Please refer to the `CONTRIBUTING.md <CONTRIBUTING.md>`_ file |
| for instructions about how to contribute to the Apache Arrow Cookbook. |
| |
| ------------------------------------------------------------------------ |
| |
| All participation in the Apache Arrow project is governed by the Apache |
| Software Foundation’s |
| `code of conduct <https://www.apache.org/foundation/policies/conduct.html>`_. |