Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/darrarski/github-status-bar

GitHub notifications in macOS status bar. Written in Swift and unidirectional data flow architecture.
https://github.com/darrarski/github-status-bar

github-notifications macos status-bar swift unidirectional-data-flow

Last synced: 3 months ago
JSON representation

GitHub notifications in macOS status bar. Written in Swift and unidirectional data flow architecture.

Host: GitHub
URL: https://github.com/darrarski/github-status-bar
Owner: darrarski
License: gpl-3.0
Created: 2020-06-12T15:09:31.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2020-12-14T22:07:30.000Z (almost 4 years ago)
Last Synced: 2024-07-19T01:07:21.951Z (4 months ago)
Topics: github-notifications, macos, status-bar, swift, unidirectional-data-flow
Language: Swift
Homepage:
Size: 801 KB
Stars: 17
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-tca - GitHub Status Bar macOS App

README

        # GitHub Status Bar macOS App

![swift: v5.2](https://img.shields.io/badge/swift-v5.2-orange.svg)

![platform: macOS](https://img.shields.io/badge/platform-macOS-blue.svg)

![deployment target: v10.15](https://img.shields.io/badge/deployment%20target-v10.15-blueviolet)

![code coverage: 100%](https://img.shields.io/badge/code%20coverage-100%25-success)

GitHub notifications in macOS status bar. Written in Swift.

![](Docs/github-status-bar-menu-screenshot-with-bg.png)

This project demonstrates **unidirectional data flow architecture** implementation in a simple Swift application.

## 🚀 Build and run

### Requirements

- Xcode 11 with Swift 5.2

### Run

You can run the app directly from terminal, by executing:

```sh

GITHUB_USERNAME=user GITHUB_TOKEN=personal-access-token swift run

```

Replace environment variables with your actual credentials.

- `GITHUB_USERNAME` - GitHub username

- `GITHUB_TOKEN` - GitHub [Personal Access Token](https://github.com/settings/tokens)

## 🛠 Develop

### Setup

Open `Package.swift` in Xcode.You can run the app using `github-status-bar` shared build scheme. 

The GitHub credentials can be set in the scheme configuration:

![xcode-scheme-environment-variables.png](Docs/xcode-scheme-environment-variables.png)

### Test

You can run tests from Xcode or by executing the following command in terminal:

```sh

swift test

```

### Package structure

Target|Description

:--|:--

`Executable`|The macOS app executable

`App[Tests]`|Core application logic

`StatusBar[Tests]`|Status bar menu component

`GitHub[Tests]`|GitHub REST API v3 client

### External dependencies

Dependency|Description

:--|:--

[ComposableArchitecture](https://github.com/pointfreeco/swift-composable-architecture)|Architecture foundations

[SwiftEndpoint](https://github.com/darrarski/SwiftEndpoint)|Networking layer abstration

[Quick](https://github.com/Quick/Quick)|Behavior-driven development framework used in test targets

[Nimble](https://github.com/Quick/Nimble)|Assertion matcher framework used in test targets

[Difference](https://github.com/krzysztofzablocki/Difference)|Assertion helper framework used in test targets

## ☕️ Do you like the project?



## 📄 License

Copyright © 2020 [Dariusz Rybicki Darrarski](http://www.darrarski.pl)

License: [GNU GPLv3](LICENSE)