python-voting/README.md

28 lines
617 B
Markdown
Raw Normal View History

2023-04-02 14:48:27 +00:00
# Python-Voting
A Python 3.11 module for votings on the c-base space-station.
## Usage
```python
2023-04-03 03:07:00 +00:00
from voting.voting import Quorum, QuorumKind, Vote, Voting, Result
2023-04-02 14:48:27 +00:00
# initializing a new voting
voting = Voting(
2023-04-03 03:07:00 +00:00
title="EXAMPLE",
quorum=Quorum(), # equals Quorum(kind=QuorumKind.NONE, value=None)
2023-04-02 14:48:27 +00:00
#quorum=Quorum(kind=QuorumKind.ABSOLUTE, value=42),
#quorum=Quorum(kind=QuorumKind.PERCENT, value=42.0),
voters=['alice', 'bob'],
)
# placing a vote
voting.vote('alice', Vote.NO)
# overwrite an existing vote
voting.vote('alice', Vote.YES)
# obtaining the result
2023-04-03 03:07:00 +00:00
res = Result(voting)
print(res.result())
2023-04-02 14:48:27 +00:00
```