<p align="center">
<img src="https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/mozilla-satellite-antenna.png" width="200">
</p>
# 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:
<pre>
$ conrad show
</pre>
![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`:
<pre>
$ pip install conference-radar
</pre>
## 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=+).
<pre>
$ conrad remind -i 6bb714
$ conrad remind
</pre>
![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):
<pre>
$ conrad show --cfp
</pre>
![show-cfp](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-cfp.png)
Look at conferences using a tag:
<pre>
$ conrad show --tag python
</pre>
![show-tag](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-tag.png)
Look at conferences using a name:
<pre>
$ conrad show --name pycon
</pre>
![show-name](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-name.png)
Look at conferences in a city, state or country:
<pre>
$ conrad show --location usa
</pre>
![show-location](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-location.png)
Look at conferences based on when they're happening:
<pre>
$ conrad show --date ">= 2019-10-01" --date "<= 2020-01-01"
</pre>
![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:
<pre>
$ conrad refresh
</pre>
![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.
Raw data
{
"_id": null,
"home_page": "https://github.com/vinayak-mehta/conrad",
"name": "conference-radar",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Vinayak Mehta",
"author_email": "vmehta94@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/65/3e/fdf0b188d520d61fe8ebd3815bf357a3b52412256cc207316d3e1d54b9ab/conference_radar-0.10.2.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/mozilla-satellite-antenna.png\" width=\"200\">\n</p>\n\n# conrad \u2014 Conference Radar\n\n[![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)\n\n`conrad` helps you track conferences and meetups on your terminal.\n\n---\n\nHere's how it works:\n\n<pre>\n$ conrad show\n</pre>\n\n![show](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show.png)\n\n## Why conrad?\n\n- \ud83d\udcc5 Never miss CFP deadlines again. `conrad remind` can remind you every time you open a terminal!\n- \ud83d\udcca Query and explore events using tags, names, locations, and dates. `conrad show --cfp` will tell you about events where the CFP is open!\n- \ud83e\udd16 Crawlers update events twice a week! (Monday and Thursday at 00:00 UTC)\n\n## Installation\n\nYou can simply use pip to install `conrad`:\n\n<pre>\n$ pip install conference-radar\n</pre>\n\n## Features\n\n### Continuous updates\n\nThe event list is maintained in `data/events.json`. This list is continuously updated by the available `crawlers` using GitHub Actions.\n\nSources:\n\n- https://confs.tech\n- https://pydata.org/event-schedule\n- https://github.com/python-organizers/conferences\n- https://wiki.python.org/moin/PythonEventsCalendar\n\n### Set reminders\n\nYou 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=+).\n\n<pre>\n$ conrad remind -i 6bb714\n$ conrad remind\n</pre>\n\n![remind](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/remind.png)\n\n**Protip**: Add `conrad remind` to your shell startup file so that you get a reminder every time you open a new terminal!\n\n### Query and explore\n\nYou can query and explore the event database using various filters.\n\nLook at events which have an open call for proposals (CFP):\n\n<pre>\n$ conrad show --cfp\n</pre>\n\n![show-cfp](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-cfp.png)\n\nLook at conferences using a tag:\n\n<pre>\n$ conrad show --tag python\n</pre>\n\n![show-tag](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-tag.png)\n\nLook at conferences using a name:\n\n<pre>\n$ conrad show --name pycon\n</pre>\n\n![show-name](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-name.png)\n\nLook at conferences in a city, state or country:\n\n<pre>\n$ conrad show --location usa\n</pre>\n\n![show-location](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-location.png)\n\nLook at conferences based on when they're happening:\n\n<pre>\n$ conrad show --date \">= 2019-10-01\" --date \"<= 2020-01-01\"\n</pre>\n\n![show-date](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-date.png)\n\n### Refresh event database\n\nYou can get the latest events using:\n\n<pre>\n$ conrad refresh\n</pre>\n\n![refresh](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/refresh.png)\n\n## Contributing\n\nThe [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`:\n\n- [Adding a crawler](https://conference-radar.readthedocs.io/en/latest/dev/adding-crawlers.html)\n- [Adding new events](https://conference-radar.readthedocs.io/en/latest/dev/adding-events.html)\n\n## Versioning\n\n`conrad` uses [Semantic Versioning](https://semver.org/). For the available versions, see the tags on this repository.\n\n## License\n\nThis project is licensed under the Apache License, see the [LICENSE](https://github.com/vinayak-mehta/conrad/blob/master/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Track conferences and meetups on your terminal.",
"version": "0.10.2",
"project_urls": {
"Homepage": "https://github.com/vinayak-mehta/conrad"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c5313845535a3ffbfda02f31e8b43fd1d900cbe3eee3f731f955cfd2719ed937",
"md5": "94a5b115c798f9ec7539a82ecb0e3104",
"sha256": "60a4f65476655f9190dcc39513915ca18ba4a4cd8e672018538be03b50a45714"
},
"downloads": -1,
"filename": "conference_radar-0.10.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "94a5b115c798f9ec7539a82ecb0e3104",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 26286,
"upload_time": "2024-12-22T10:28:25",
"upload_time_iso_8601": "2024-12-22T10:28:25.415593Z",
"url": "https://files.pythonhosted.org/packages/c5/31/3845535a3ffbfda02f31e8b43fd1d900cbe3eee3f731f955cfd2719ed937/conference_radar-0.10.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "653efdf0b188d520d61fe8ebd3815bf357a3b52412256cc207316d3e1d54b9ab",
"md5": "c9e49356aaa973050644ce8c884d0881",
"sha256": "28549fe03827b9d6418026b1dc1762515700203d025557db3931d2b2324e81b7"
},
"downloads": -1,
"filename": "conference_radar-0.10.2.tar.gz",
"has_sig": false,
"md5_digest": "c9e49356aaa973050644ce8c884d0881",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21539,
"upload_time": "2024-12-22T10:28:27",
"upload_time_iso_8601": "2024-12-22T10:28:27.818198Z",
"url": "https://files.pythonhosted.org/packages/65/3e/fdf0b188d520d61fe8ebd3815bf357a3b52412256cc207316d3e1d54b9ab/conference_radar-0.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-22 10:28:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vinayak-mehta",
"github_project": "conrad",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "conference-radar"
}