https://github.com/reload/combine
Fetch data from HarvestApp and expose an API for it. Successor to Harvester
https://github.com/reload/combine
Last synced: 11 days ago
JSON representation
Fetch data from HarvestApp and expose an API for it. Successor to Harvester
- Host: GitHub
- URL: https://github.com/reload/combine
- Owner: reload
- Created: 2024-06-06T21:05:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-07T13:03:39.000Z (about 1 year ago)
- Last Synced: 2025-01-18T23:16:55.154Z (12 months ago)
- Language: Crystal
- Size: 103 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Combine (harvester)
[](https://amberframework.org)
This is a project written using [Amber](https://amberframework.org).
Enjoy!
## Getting Started
These instructions will get a copy of this project running on your
machine for development and testing purposes.
## Prerequisites
This project requires [Crystal](https://crystal-lang.org/)
([installation guide](https://crystal-lang.org/docs/installation/)).
Alternatively, `docker compose up` should bring up a container based
setup (untested).
## Initial setup
The environment configuration files are encrypted in git, so to run
the project you'll need the key from 1Password:
`op read op://Shared/rasikyplntusmmbszukvobmjz4/password >.encryption_key`
### Google Auth
To create Google OAuth credentials for single signon, go to [Google
Cloud Console](https://console.cloud.google.com) and create a project
for the app. Visit "Credentials" in the "APIs & Services" product, and
create an OAuth client ID. The `/signin/callback` URL of your Combine
instance should be added to "Authorized redirect URIs", and the
"People API" should be enabled for the project.
## Changelog
The [changelog](CHANGELOG.md) records the latest changes.
## Development
To start your Amber server:
1. Install dependencies with `shards install`
2. Build executables with `shards build`
3. Create and migrate your database with `bin/amber db create migrate`.
4. Start Amber server with `bin/amber watch`
Now you can visit http://localhost:3000/ from your browser.
## Tests
To run the test suite:
```
crystal spec
```
## Contributing
1. Fork it ( https://github.com/reload/combine/fork )
2. Create your feature branch ( `git checkout -b my-new-feature` )
3. Commit your changes ( `git commit -am 'Add some feature'` )
4. Push to the branch ( `git push origin my-new-feature` )
5. Create a new Pull Request
## Contributors
- [xendk](https://github.com/xendk) Thomas Fini Hansen - creator, maintainer