Metadata-Version: 2.1
Name: apache-airflow-client
Version: 2.1.0rc1
Summary: Apache Airflow API (Stable)
Home-page: https://airflow.apache.org/
Author: Apache Software Foundation
Author-email: dev@airflow.apache.org
License: Apache License 2.0
Download-URL: https://archive.apache.org/dist/airflow/clients/python/2.1.0
Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow/stable/stable-rest-api-ref.html
Project-URL: Bug Tracker, https://github.com/apache/airflow-client-python/issues
Project-URL: Source Code, https://github.com/apache/airflow-client-python
Description: <!--
         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 Airflow Python Client
        
        > **_NOTE:_**  The Apache Airflow Client is still under active development and some methods 
        > or APIs might be broken. Please raise an issue in github if you encounter any such issues. 
        
        
        
        ## Requirements.
        
        Python >= 3.6
        
        ## Installation & Usage
        ### pip install
        
        You can install directly using pip:
        
        ```sh
        pip install apache-airflow-client
        ````
        
        ### Setuptools
        
        Or install via [Setuptools](http://pypi.python.org/pypi/setuptools).
        
        ```sh
        git clone git@github.com:apache/airflow-client-python.git
        cd airflow-client-python
        python setup.py install --user
        ```
        (or `sudo python setup.py install` to install the package for all users)
        
        Then import the package:
        ```python
        import airflow_client.client
        ```
        
        ## Getting Started
        
        Please follow the [installation procedure](#installation--usage) and then run the following:
        
        ```python
        import airflow_client.client
        from pprint import pprint
        from airflow_client.client.api import config_api
        
        # The client must use the authentication and authorization parameters
        # in accordance with the API server security policy.
        # Examples for each auth method are provided below, use the example that
        # satisfies your auth use case.
        #
        # In case of the basic authentication below, make sure that Airflow is
        # configured with the basic_auth as backend:
        #
        # auth_backend = airflow.api.auth.backend.basic_auth
        #
        # Make sure that your user/name are configured properly
        
        # Configure HTTP basic authorization: Basic
        configuration = airflow_client.client.Configuration(
            host="http://localhost/api/v1",
            username='admin',
            password='admin'
        )
        
        
        # Enter a context with an instance of the API client
        with airflow_client.client.ApiClient(configuration) as api_client:
            # Create an instance of the API class
            api_instance = config_api.ConfigApi(api_client)
        
            try:
                # Get current configuration
                api_response = api_instance.get_config()
                pprint(api_response)
            except airflow_client.client.ApiException as e:
                print("Exception when calling ConfigApi->get_config: %s\n" % e)
        ```
        
        See [README](./airflow_client/README.md#documentation-for-api-endpoints) for full client API documentation.
        
        ## Release Process
        
        The Python client is generated using Airflow's [openapi spec](https://github.com/apache/airflow/blob/master/clients/gen/python.sh). 
        To update the client for new APIs do the following steps:
        
        ```bash
        # clone this repo
        git clone git@github.com:apache/airflow-client-python.git
        
        # clone Airflow repo (if not already)
        git clone git@github.com:apache/airflow.git
        cd airflow
        
        # bump up the version in python.sh & run the following command 
        ./clients/gen/python.sh airflow/api_connexion/openapi/v1.yaml ../airflow-client-python/airflow_client
        
        # raise a PR in github for both the repos (airflow & airflow-client-python)
        ```
        
Keywords: OpenAPI,OpenAPI-Generator,Apache Airflow API (Stable)
Platform: UNKNOWN
Requires-Python: ~=3.6
Description-Content-Type: text/markdown
