Skip to content

Commit

Permalink
Merge pull request #7 from globus-labs/0.3.1-prep
Browse files Browse the repository at this point in the history
bump to 0.3.1
  • Loading branch information
haochenpan authored Jun 2, 2024
2 parents 5257ab4 + 4689218 commit 7ec9930
Show file tree
Hide file tree
Showing 3 changed files with 48 additions and 15 deletions.
36 changes: 36 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
name: release

on:
push:
tags:
- 'v*.*.*' # Trigger on version tags

jobs:
pypi-publish:
name: Upload release to PyPI
runs-on: ubuntu-latest
environment:
name: pypi
url: https://pypi.org/project/diaspora-event-sdk
permissions:
id-token: write # IMPORTANT: this permission is mandatory for trusted publishing

steps:
- name: Check out code
uses: actions/checkout@v3

- name: Set up Python
uses: actions/setup-python@v3
with:
python-version: '3.11' # Specify the Python version you need

- name: Install build tools
run: |
python -m pip install --upgrade pip
pip install setuptools wheel twine
- name: Build package
run: python setup.py sdist bdist_wheel

- name: Publish package distributions to PyPI
uses: pypa/gh-action-pypi-publish@release/v1
25 changes: 11 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,26 @@
# Diaspora: Hybrid Event-Driven Architecture for Distributed Scientific Computing
# Diaspora Event Fabric SDK

## Event Fabric SDK Installation Guide
### Recommended Method: Use with `kafka-python`
For easy integration with Diaspora Event Fabric, use the `KafkaProducer` and `KafkaConsumer` classes from our SDK. This requires the `kafka-python` library.

To install the Event Fabric SDK and `kafka-python,` with the following command:
## Installation Guide
### Recommended Method: With `kafka-python`
To integrate with Diaspora Event Fabric using `KafkaProducer` and `KafkaConsumer`, install the SDK with `kafka-python`:
```bash
pip install "diaspora-event-sdk[kafka-python]"
```

### Alternative Installation: Without Kafka Client Library
To use alternative Kafka client libraries (e.g., `confluent-kafka-python`, `aiokafka`, and libraries for other programming languages), you can install the SDK without the `kafka-python` dependency. This option still provides topic-level access control (authorization) and login credential management features.

To install the SDK without `kafka-python`, use:
For other Kafka client libraries (e.g., `confluent-kafka-python`, `aiokafka`), install the SDK without `kafka-python`:
```bash
pip install diaspora-event-sdk
```
Note: This method does not include dependencies for `KafkaProducer` and `KafkaConsumer` classes mentioned in the QuickStart
Note: This does not include `KafkaProducer` and `KafkaConsumer` dependencies.

## Use Diaspora Event Fabric SDK
## Using Diaspora Event Fabric SDK
Check our [Notebook](DiasporaDemo.ipynb) for a quickstart and demonstration.

**Getting Started**: Visit our [QuickStart Guide](docs/quickstart.md) for details on using the SDK with the kafka-python library and instructions for other Kafka clients.
<!-- **Getting Started**: Visit our [QuickStart Guide](docs/quickstart.md) for details on using the SDK with the kafka-python library and instructions for other Kafka clients.
**Troubleshooting and Credential Management**: Consult our [TrobleShooting Guide](docs/troubleshooting.md) for solving common issues and tips on managing keys effectively.
**Troubleshooting and Credential Management**: Consult our [TrobleShooting Guide](docs/troubleshooting.md) for solving common issues and tips on managing keys effectively. -->

<!-- **Advanced Consumers with Faust**: Explore the [Faust Streaming Guide](docs/faust_weather_app.md) for advanced event streaming with Faust. -->

**Advanced Consumer Functions**: See our [Colab example](https://colab.research.google.com/drive/1tPKfxU2qPsLvNTreF6nKINU62k7pQWxa?usp=sharing) for demonstration.
<!-- **Advanced Consumer Functions**: See our [Colab example](https://colab.research.google.com/drive/1tPKfxU2qPsLvNTreF6nKINU62k7pQWxa?usp=sharing) for demonstration. -->
2 changes: 1 addition & 1 deletion diaspora_event_sdk/version.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@
__version__ = "0.3.0"
__version__ = "0.3.1"

0 comments on commit 7ec9930

Please sign in to comment.