GithubHelp home page GithubHelp logo

snakypy / imake Goto Github PK

View Code? Open in Web Editor NEW
0.0 2.0 1.0 59 KB

:snake: :package: :computer: iMake is a command line tool to simplify commands in Python projects, discarding the usability of a Makefile file.

License: MIT License

Python 100.00%
makefile make snakypy commands toml config

imake's Introduction

iMake

Tests Python Versions Python Whell PyPI PyPI - Implementation Isort Mypy Code style: Black PyPI - Downloads GitHub license


Built with ❤︎ by: William Canin in free time, to the sound of the playlist: Bursting Of The Tympanum


iMake is a command line tool to simplify commands in Python projects, discarding the usability of a Makefile file. As iMake saves on typed commands, passing them a configuration file.

Requirements

To work correctly, you will first need:

  • Python (v3.9 or recent);
  • Pip (v21.0.1 or recent) must be installed;

Installing

$ pip install imake --user

Configuration

The configuration file must exist at the location where imake will be called. The file must be named .imake, that is, a file hidden on Unix systems.

To create the file use command:

imake init

After creating the file, you should leave it with the following structure. Example:

[build]
commands = ["python setup.py sdist"]

The key with the name commands is an Array and must be mandatory for iMake. In this key you must inform the commands you want to execute using the primary key, in this case, the build.

Option with multiple commands:

[build]
commands = ["rm -rf build", "rm -rf docs/_build;", "python setup.py sdist"]

You can also execute commands in blocks instead of a list, as follows using triple quotes:

[clean]
commands = ["""
            if [[ -d "build" ]]; then
              rm -r build;
            fi
            rm -rf docs/_build;
            rm -rf .pytest_cache;
"""]

iMake settings still have 3 other keys, which are description, initial_message, and final_message. All optional.

The key description you must put only a description for a given command. Example:

[build]
description = "This command compiles the project."
commands = ["rm -rf build", "rm -rf docs/_build;", "python setup.py sdist"]

The initial_message key is a message that will appear before the commands start. Example:

[build]
description = "This command compiles the project."
initial_message = "Starting the build ..."
commands = ["rm -rf build", "rm -rf docs/_build;", "python setup.py sdist"]

The final_message key is a message that will appear after the commands are finished. Example:

[build]
description = "This command compiles the project."
initial_message = "Starting the build ..."
commands = ["rm -rf build", "rm -rf docs/_build;", "python setup.py sdist"]
final_message = "Build command finished!"

Note: The position of the keys does not imply anything, but the values do. The command that you put first in the commands key will be the first to be executed.

Another interesting option is that you can call the execution of a command within another one using imake. Would be like this:

[build]
description = "This command compiles the project."
initial_message = "Starting the build ..."
commands = ["imake clean -q", "python setup.py sdist"]
final_message = "Build command finished!"

Notice that the command imake clean -q is inside commands. Where the -q option means to silence verbose mode.

Using

After making the settings in the file .imake, execute the command imake followed by the primary key, which in our example is build. It will look like this:

$ imake build

You can run the help command, imake -h to show which commands are available to you. Any configuration that is in the .imake file will be shown in help, minus the description of each command, which will be shown only if you run the --desc or -d option, for example:

$ imake build --desc

More Commands

For more command information, use:

$ imake -h

Donation

Click on the image below to be redirected the donation forms:

License

The project is available as open source under the terms of the MIT License ©

Credits

See, AUTHORS.

imake's People

Contributors

williamcanin avatar

Watchers

 avatar  avatar

Forkers

williamcanin

imake's Issues

Create CLI init

Currently there is no CLI command to create a skeleton of the configuration file (.imake), where you need to create it manually.

Add this functionality in version 0.2.0.

Content to be created with the command imake init:

[]
description = ""
header = ""
commands = [""]
footer = ""

Show message in nonexistent argument

When an argument is passed via the CLI and does not exist, it is not showing the user anything on the terminal. A warning or error message should be displayed if the argument does not exist.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.