Skip to main content

Track conferences and meetups on your terminal!

Project description

conrad — Conference Radar 📡

image image image

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 #008000, >10 and < 30 days #ffff00 and < 10 days #ff0000.

$ 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
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:

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for conference-radar, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size conference_radar-0.1.2-py3-none-any.whl (24.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page