conference-radar 0.2.0

Track conferences and meetups on your terminal!

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

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!
• 🔄 Run conrad refresh to get the latest events!
• 🤖 (upcoming) The event database updates automatically with events curated by the community.
• ⛏️ You can manually add events using conrad import -f events.json and raise a PR!

Installation

You can simply use pip to install conrad:

$ pip install conference-radar

Features

Set reminders

You can set CFP reminders so that you never miss a deadline! The color changes based on event 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!

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

id	name	url	city	state	country	start_date	end_date
34994e	PyConf Hyderabad	https://pyconf.hydpy.org/2019/	Hyderabad	Telangana	India	2019-12-07	2019-12-08
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

Refresh event database

You can get the latest events using:

$ conrad refresh

Continuous updates (upcoming)

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

Sources:

• https://www.python.org/events
• https://github.com/python-organizers/conferences

Contributing events

The Contributor's Guide has detailed information about guidelines around contributions.

You can add new events to the list! To do so:

1. 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

2. Fork the project repository. Click on the ‘Fork’ button near the top of the page. This creates a copy of the code under your account on the GitHub. Clone your fork of conrad from your GitHub account:

    $ git clone https://www.github.com/[username]/conrad
    $ cd conrad

3. Create a branch to hold your changes:

    $ git checkout -b add-new-event

4. Import the new events:

    $ conrad import -f ../new_events.json

5. Finally push your changes and raise a PR!

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

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.