Skip to content

Commit

Permalink
Prepare release of Rust client
Browse files Browse the repository at this point in the history
  • Loading branch information
pacman82 committed Jun 1, 2020
1 parent a2a7531 commit 449ab75
Show file tree
Hide file tree
Showing 8 changed files with 42 additions and 36 deletions.
1 change: 1 addition & 0 deletions .github/workflows/rustpublish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,5 @@ jobs:
CARGO_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}
run: |
cargo publish --manifest-path .\server\Cargo.toml --token ${CARGO_TOKEN}
cargo publish --manifest-path .\rust_client\Cargo.toml --token ${CARGO_TOKEN}
28 changes: 26 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,28 @@
Contributions
=============
# Contributions

Wether they be in code, intersting feature suggestions, design critique or bug reports, all contributions are welocme. Please start an issue, before investing a lot of work. This helps avoid situations there I would feel the need to reject a large body of work, and a lot of your time has been wasted. Throttle is a pet project and a work of love, which implies that I maintain it in my spare time. Please understand that I may not always react immediatly. If you contribute code to fix a Bug, please also contribute the test to fix it. Happy contributing.

## Local build and test setup

* Install Rust compiler and Cargo. Follow the instructions on [this site](https://www.rust-lang.org/en-US/install.html).
* Checkout the sources.

```bash
git clone https://github.com/pacman82/throttle.git
```

* Build the throttle server, run the unit tests and the integration tests with the Rust client.

```bash
cd throttle
cargo test
```

* Execute integration of throttle server with Python client.

```bash
cd python_client
pip install -r test-requirements.txt
pip install -e .
pytest
```
6 changes: 3 additions & 3 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

5 changes: 5 additions & 0 deletions Changelog.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
Changelog
=========

0.3.8
-----

* Add Rust client http layer

0.3.7
-----

Expand Down
32 changes: 4 additions & 28 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,9 @@ Throttle aims to be easy to operate, well-behaved in edge cases and works withou
## Features

* Server builds and runs on Windows, Linux, and OS-X.
* Python Client is available.
* Clients
* Python: A high level client with blocking API.
* Rust: Low level client with async API.
* Prevents Deadlocks, through enforcing lock hierarchies.
* Fairness (longer waiting peers have priority)
* Locks with large count, won't be starved by lots of others with a small counts.
Expand Down Expand Up @@ -234,34 +236,8 @@ This has been done manly for the convinience of Python users, who want to try ou

### Python Client

Python client is publish to [PyPi](https://pypi.org) and can be installed using pip.
Python client is published to [PyPi](https://pypi.org) and can be installed using pip.

```bash
pip install throttle-client
```

## Local build and test setup

* Install Rust compiler and Cargo. Follow the instructions on
[this site](https://www.rust-lang.org/en-US/install.html)
* Checkout the sources with

```bash
git clone https://github.com/pacman82/throttle.git
```

* You can run the build and run unit tests by executing

```bash
cd throttle
cargo test
```

* Execute integration test with clients

```bash
cd python_client
pip install -r test-requirements.txt
pip install -e .
pytest
```
2 changes: 1 addition & 1 deletion python_client/setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

setup(
name="throttle_client",
version="0.3.7",
version="0.3.8",
author="Markus Klein",
description="Client for Throttle. Throttle is a http semaphore service, providing"
"semaphores for distributed systems.",
Expand Down
2 changes: 1 addition & 1 deletion rust_client/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "throttle-client"
version = "0.1.0"
version = "0.3.8"
authors = ["Markus Klein <[email protected]>"]
edition = "2018"

Expand Down
2 changes: 1 addition & 1 deletion server/Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "throttle-server"
version = "0.3.7"
version = "0.3.8"
authors = ["Markus Klein"]
edition = "2018"
license = "MIT"
Expand Down

0 comments on commit 449ab75

Please sign in to comment.