Package to make Experiments in Python way lot easier.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data
images
.gitignore
LICENSE
README.md
python-experiment.el

README.md

python-experiment

Package to make Experiments in Python way lot easier.

How many times you desired to have a dummy dictionary or dataframe just available to verify if that obscure operation you developed works or not?

Well, these issues are addressed by this package.

**OBS>>> This package was renamed from Python Experiment Mode to Python Experiment. I am sorry, but it makes more sense now.

Installation

For now, there is only one way to install this package.

First clone the repo in the right folder:

cd ~/.emacs.d/site-packages
git submodule add https://github.com/wandersoncferreira/python-experiment

Then add these lines to your init.el file.

(add-to-list 'load-path "~/.emacs.d/site-packages/python-experiment")
(require 'python-experiment)

If you desire to see this package in MELPA let me know in Issues.

Usage

There are 4 recommended bindings in this package:

(global-set-key (kbd "<f9>") 'python-experiment)
(global-set-key (kbd "<f10>") 'python-experiment-lived-too-long)
(global-set-key (kbd "<f11>") 'python-experiment-reload)
(global-set-key (kbd "<f12>") 'python-experiment-buffer-to-file)

F9 will open a frame like this one below:

Example of the Frame that will be opened.

The Python Experiment Buffer is not attached to any file and you can easily edit it.

F10 will shut everything down!

F11 If you edit the Python Experiment Buffer to include any additional datatype, you can press F11 to reload the Inferior Python Process with the new additions.

F12 After a whole day of work you might have added several custom additions to your specific situation. Press F12 to save the Python Experiment Buffer to a custom file that will be loaded in the next time.

Settings

There are a few builtin modules loaded by default: os and sys. However you can customize this variable using the list-of-builtins variable as follows:

(setq python-experiment-builtins '((functools . nil) (os . nil) (collections . cl)))

This variable holds an alist which first member is the name of your module and the second member is its alias.

The collection module would be imported as:

import collections as cl

OBS: Every default data or module is only loaded if you have the module installed in your Python Environment. The package already checks it.

Faker library

I just started using the Faker library. It will suit very nicely what is the purpose of this package. Additional custom default provides might be:

+ Fake CSV files.

However, faker already have a lot of nice builtins options. Example:

Example of the Faker library in action.

You need to install the library to be able to load automatically.

pip install Faker

Contributions

I would love to extend this package. Open a Issue and let me know of your ideas! Not need to any programming skiils: Problems still to be addressed: Naming conventions!!

If you want to contribute adding more standard datatypes at the "data" folder, submit a Pull Request right away. o/

Possible future features

I have been looking through the Factory Boy library. Might be using this to make the package more robust and scalable. Would be possible to make fake copies of your custom entities from your own projects easily. The possibilities are endless.

However, adds a dependancy to this library's usage. (partially!)