Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vinayak-mehta/conrad
Track conferences and meetups on your terminal.
https://github.com/vinayak-mehta/conrad
git-scraping
Last synced: 6 days ago
JSON representation
Track conferences and meetups on your terminal.
- Host: GitHub
- URL: https://github.com/vinayak-mehta/conrad
- Owner: vinayak-mehta
- License: apache-2.0
- Created: 2019-01-08T18:56:08.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-12-19T01:06:26.000Z (15 days ago)
- Last Synced: 2024-12-21T08:03:42.995Z (13 days ago)
- Topics: git-scraping
- Language: Python
- Homepage: https://conference-radar.readthedocs.io
- Size: 1.22 MB
- Stars: 245
- Watchers: 10
- Forks: 58
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# conrad — Conference Radar
[![Workflow Status](https://github.com/vinayak-mehta/conrad/workflows/Get%20events/badge.svg)](https://github.com/vinayak-mehta/conrad/actions) [![Documentation Status](https://readthedocs.org/projects/conference-radar/badge/?version=latest)](https://conference-radar.readthedocs.io/en/latest/) [![image](https://img.shields.io/pypi/v/conference-radar.svg)](https://pypi.org/project/conference-radar/) [![image](https://img.shields.io/pypi/pyversions/conference-radar.svg)](https://pypi.org/project/conference-radar/) [![image](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
`conrad` helps you track conferences and meetups on your terminal.
---
Here's how it works:
$ conrad show![show](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show.png)
## Why conrad?
- 📅 Never miss CFP deadlines again. `conrad remind` can remind you every time you open a terminal!
- 📊 Query and explore events using tags, names, locations, and dates. `conrad show --cfp` will tell you about events where the CFP is open!
- 🤖 Crawlers update events twice a week! (Monday and Thursday at 00:00 UTC)## Installation
You can simply use pip to install `conrad`:
$ pip install conference-radar## Features
### Continuous updates
The event list is maintained in `data/events.json`. This list is continuously updated by the available `crawlers` using GitHub Actions.
Sources:
- https://confs.tech
- https://pydata.org/event-schedule
- https://github.com/python-organizers/conferences
- https://wiki.python.org/moin/PythonEventsCalendar### Set reminders
You can set CFP reminders so that you never miss a deadline! The color changes based on event proximity; **> 30 days** ![#008000](https://placehold.it/15/008000/000000?text=+), **>10 and < 30 days** ![#ffff00](https://placehold.it/15/ffff00/000000?text=+) and **< 10 days** ![#ff0000](https://placehold.it/15/ff0000/000000?text=+).
$ conrad remind -i 6bb714
$ conrad remind![remind](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/remind.png)
**Protip**: Add `conrad remind` to your shell startup file so that you get a reminder every time you open a new terminal!
### Query and explore
You can query and explore the event database using various filters.
Look at events which have an open call for proposals (CFP):
$ conrad show --cfp![show-cfp](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-cfp.png)
Look at conferences using a tag:
$ conrad show --tag python![show-tag](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-tag.png)
Look at conferences using a name:
$ conrad show --name pycon![show-name](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-name.png)
Look at conferences in a city, state or country:
$ conrad show --location usa![show-location](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-location.png)
Look at conferences based on when they're happening:
$ conrad show --date ">= 2019-10-01" --date "<= 2020-01-01"![show-date](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-date.png)
### Refresh event database
You can get the latest events using:
$ conrad refresh![refresh](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/refresh.png)
## Contributing
The [Contributor's Guide](https://github.com/vinayak-mehta/conrad/blob/master/CONTRIBUTING.md) has detailed information about guidelines around contributions. You can add new crawlers and events to `conrad`:
- [Adding a crawler](https://conference-radar.readthedocs.io/en/latest/dev/adding-crawlers.html)
- [Adding new events](https://conference-radar.readthedocs.io/en/latest/dev/adding-events.html)## Versioning
`conrad` uses [Semantic Versioning](https://semver.org/). For the available versions, see the tags on this repository.
## License
This project is licensed under the Apache License, see the [LICENSE](https://github.com/vinayak-mehta/conrad/blob/master/LICENSE) file for details.