blueedgetechno / atom-python-run

A simple atom package. Press one key to run your python code in atom.

atom-python-run package

Run your python (.py) source file using F5 or F6!

Contents

• Prerequisite
• Features
• Compatability
• Documentation
• Issues
• Development

Prerequisite

• Atom Text Editor (nightly or latest stable release)
• Python 2 and/or 3
• Add Python (and any other interpreters) to the PATH environment variable.

Features

• Using python
  • Almost the same console with python IDLE, which provides syntax error and runtime error messages.
• CodeBlocks debug console style
  • Shows return value and execution time
    • It is a rough time based on real time rather than CPU kernel / user time

Compatibility

• Cross Platform Compatible

  • Runs on Windows, Mac OS X, and Linux

• True Arbitrary Execution

  • Global python is the default interpreter
  • Execute using any interpreter
  • Pass options to the given interpreter
  • Pass arguments to the program to be executed

• Python 2 and 3

  • Note: If you have problems executing, you can install a global version of latest python2.7.x (even if you have python3.x.x installed). Please report any python3 issues if you want to avoid installing a global python2 version.

Documentation

This project has been documented in a fair amount of detail over time. This documentation can be found in the Wiki.

Everyone should take the time to reveiw the Wiki README at the bare minimum. It details an overview on how to handle issues, use different versions, and includes links to primary sections of the Wiki.

Everyone should also take the time to review the Wiki section How do I use atom-python-run?. It covers everything from installation, to configuration, logging, and much more. You just might be surprised by what you can do with atom-python-run.

You should have the basics after having covered both the README and How Do I use atom-python-run? sections. Most FAQ's can be resolved by simply reading them. The guides provided should allow us to help you with what ever issue you're facing.

NOTE: Be sure to read the Wiki and the Wiki README before reporting an issue or making a pull request. A lot of time has been put in to it to help you the user (or dev) get started and on your way.

Issues

• Before newing an issue, check to see if someone else is experiencing any related issues.
• Check to see if any issues that were closed resemble your issue and re-open it addressing that you're experiencing a similar issue.
• Provide details about your issue, such as errors and/or logs.
• Provide reproduction steps (we can't help you if we don't know how to reproduce the error!).

Development

If you're a developer and are interested in this project you can find this repos API's in the Wiki. More specifically, you'll want to take a look at How does the cp module work? and How does the terminal.js module work? sections of the Wiki.

You can also just read the key source files

• cp (cp is written in python)
• terminal.js
• atom-python-run.js
• New an issue if you have any idea of new features.

This is a package for Atom