Skip to content

DaveAldon/Paraphrast

Repository files navigation

Paraphrast

Codacy Badge Build Status Coverage


It all started when I accidentally typed "ls" into a Windows command prompt for the last time...

Wrong command

If you frequently work between Unix and DOS prompts, it can be a pain switching between syntaxes. Or even if you work solely on Unix and have to check something quick, and the only thing around is a Windows machine and you don't know any DOS commands, it makes happy people sad.

"But wait! There's already terminal emulators out there that do this!"

Yes, but not like this.

  1. Cygwin: one of the most popular, but it doesn't have a Unix version that translates DOS commands, it wasn't made in Python 😁, and it needs an emulation layer so more like a GNU OS without a kernel than a terminal emulator. While I won't deny that it will give you the ability to run Unix commands in Windows, and it does it well, I want a less invasive installation and setup process. I also want something that hardly takes up any space.
  2. MSYS or GnuWin32: Go ahead and try! More power to ya. Also no Unix compatibility so good luck running DOS commands on a Mac/Linux OS.
  3. Windows 10 Bash: Only for Windows 10+ and also there's some precious filespace needed. I want something really small.
  4. Your Favorite VM: Of course you could always just fire up a VM of your favorite OS, but that's a tad bit inconvenient, isn't it? All we want are our commands translated into whatever OS we're using.

Enter Paraphrast

We want what we type paraphrased into the correct syntax for our OS. Paraphrast takes the work out of remembering two syntaxes, and let's you just focus on one. That's right, not only does it translate Unix into DOS commands, it goes the other way too!

Current Features

  • Cross Compatible Windows/Unix
  • Small
  • Really, really straightforward translation of commands
  • Auto-complete that's better than what you have (if you're still using a default CLI)

The Mission

I have a firm belief in magical user experiences, where what the user wants happens without any extra interaction beyond what's expected.

Because of this, each of my planned steps in developing this product must revolve around making the user's CLI work like it should on their favorite OS.

So now we can do this and stay happy...

ls on DOS

Development Focus Before v1.0 Release

  • Get the most frequently used CLI commands working
  • Dynamic Headers (current working directory displayed)
  • Command elevation (sudo equivalents)
  • Make it portable so that machines without Python can run it
  • Special Paraphrast configuration commands
  • Adherance to CI and code review results

Current Requirements

  • Python 3.3+
  • Windows or Unix OS

3rd Party Plugins

  • Prompt-Toolkit

Current Instructions

  1. Download and extract Paraphrast from Github
  2. cd to the extracted folder and run main.py
  3. Begin entering commands opposite the OS you're on
  4. Submit bug reports to the issues section of this project

Reviews

"It's great!" - David Crawford

About

Sick of remembering CLI syntax for Unix AND Windows? Paraphrast takes care of that.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages