heyrudy / rusty-bunny

a tool that lets you write smart bookmarks

Rusty Bunny

rusty-bunny

rusty-bunny is a mini-clone of bunny1
"a tool that lets you write smart bookmarks in [rust] and then share them across all your browsers..."
Explore the docs »

View Demo · Report Bug

Table of Contents

• Rusty Bunny
  • Table of Contents
  • About the Project
  • Demo
    • Built With
  • Getting Started
    • Prerequisites
    • Installation
  • Usage
  • Contributing
  • License
  • Contact
  • Acknowledgements

About the Project

The idea for this project came after learning about bunny1 and using it at work. I really enjoyed it and thought, "I wonder if I could build my own from scratch?"

As part of my Ultralearning project for Rust, I decided to take myself up on the challenge. This project is the result of that.

Demo

This is what rusty-bunny looks like in action.

Built With

• Rust
• Rocket

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

Make sure you have Rust installed.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Rocket uses the nightly version of Rust so make sure you use that. If you'd like to only use nightly for this project, you can run this from the root of the project after cloning.

# from the root of the project
rustup override set nightly

Installation

1. Clone the rusty-bunny

git clone https://github.com/jsjoeio/rusty-bunny.git

2. Make sure you're using nightly

cargo --version

3. Build the project

cargo build

4. Run the project

cargo run

5. Visit localhost:8000
6. To test a command, go to localhost:8000/search?cmd=tw and you should be redirected to Twitter

Usage

To test out a command, type in http://localhost:8000/search?cmd= followed by your command.

The following commands are supported by rusty-bunny:

• "tw" -> redirects to twitter.com
• "tw @username" -> redirects to twitter.com/username
• "gh" -> redirects to github.com
• "gh username" -> redirects to github.com/username
• "gh username/repo" -> redirects to github.com/username/repo
• "mail" -> redirects to mail.google.com
• "cal" -> redirects to calendar.google.com

Everything else redirects to a google search with your query.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. See CONTRIBUTING for more information.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

If you have questions or thoughts on this project, feel free to send them my way by @'ing me on Twitter or shooting me a DM.

Joe Previte - @jsjoeio

Acknowledgements

• The Rust Community
• Rocket.rs
• @othneildrew - for the README template
• @tscritch - for the code suggestions