README.md

conrad — Conference Radar 📡

conrad helps you track conferences and meetups on your terminal!

---

Here's how it works:

$ conrad show

id	name	url	city	state	country	start_date	end_date
3ae4f9	PyCon Fr 2019	https://www.pycon.fr/	Bordeaux		France	2019-10-31	2019-11-04
68bf57	PyCon Sweden	http://www.pycon.se/	Stockholm		Sweden	2019-10-31	2019-11-02

Features

Set reminders

You can set CFP reminders so that you never miss a deadline! The color changes based on date proximity; > 30 days , >10 and < 30 days and < 10 days .

$ conrad remind -i 6bb714
$ conrad remind

name	start_date	days_left
PyCon US	2020-04-15	52 days left to cfp deadline!

Protip: Add conrad remind to your shell startup file so that you get a reminder every time you open a new terminal!

Explore

You can explore the conference database using various filters.

Look at conferences which have an open call for proposals (cfp):

$ conrad show --cfp

id	name	url	city	state	country	start_date	end_date
6bb714	PyCon US	https://us.pycon.org	Pittsburgh	Pennsylvania	USA	2020-04-15	2020-04-23

Look at conferences using a tag:

$ conrad show --tag python

id	name	url	city	state	country	start_date	end_date
3ae4f9	PyCon Fr 2019	https://www.pycon.fr/	Bordeaux		France	2019-10-31	2019-11-04
68bf57	PyCon Sweden	http://www.pycon.se/	Stockholm		Sweden	2019-10-31	2019-11-02

Look at conferences using a name:

$ conrad show --name pycon

id	name	url	city	state	country	start_date	end_date
3ae4f9	PyCon Fr 2019	https://www.pycon.fr/	Bordeaux		France	2019-10-31	2019-11-04
68bf57	PyCon Sweden	http://www.pycon.se/	Stockholm		Sweden	2019-10-31	2019-11-02

Look at conferences in a city, state or country:

$ conrad show --location usa

id	name	url	city	state	country	start_date	end_date
66867c	PyCascades 2020	https://2020.pycascades.com	Portland	Oregon	USA	2020-02-08	2020-02-10
6bb714	PyCon US	https://us.pycon.org	Pittsburgh	Pennsylvania	USA	2020-04-15	2020-04-23

Look at conferences based on when they're happening:

$ conrad show --date ">= 2019-10-01" --date "<= 2020-01-01"

id	name	url	city	state	country	start_date	end_date
3ae4f9	PyCon Fr 2019	https://www.pycon.fr/	Bordeaux		France	2019-10-31	2019-11-04
68bf57	PyCon Sweden	http://www.pycon.se/	Stockholm		Sweden	2019-10-31	2019-11-02

Continuous updates (upcoming)

The event list is maintained in data/events.json. This list is continuously updated using the available scrapers.

You can get the latest events using:

$ conrad refresh

---

You can add new events to the list! The Contributor's Guide has detailed information about contributions.

To do so, create a new_events.json file containing the list of events you want to add, with the following fields:

[
    {
        "name": "PyCon US",
        "url": "https://us.pycon.org",
        "city": "Pittsburgh",
        "state": "Pennsylvania",
        "country": "USA",
        "cfp_open": true,
        "cfp_start_date": "2019-09-12",
        "cfp_end_date": "2019-12-20",
        "start_date": "2020-04-15",
        "end_date": "2020-04-23",
        "source": "https://www.python.org/events/",
        "tags": "['python']",
        "kind": "conference"
    }
]
"new_events.json" 17L, 436C

After that, clone this repository and create a new branch:

$ git clone https://www.github.com/vinayak-mehta/conrad
$ cd conrad
$ git checkout -b add-new-event

Then import the new events:

$ conrad import -f ../new_events.json

And finally push your changes and raise a PR!

$ git add .
$ git commit -m "Add new events"
$ git push origin add-new-event

Installation

Using pip

You can simply use pip to install conrad:

$ pip install conference-radar

From source code

Or you can clone the repo:

$ git clone https://www.github.com/vinayak-mehta/conrad

And install conrad:

$ cd conrad
$ pip install .

Versioning

conrad uses Semantic Versioning. For the available versions, see the tags on this repository.

License

This project is licensed under the Apache License, see the LICENSE file for details.