Forem: 5elenay

Ezcli - Minimal Package for Creating CLI apps.

5elenay — Sat, 31 Jul 2021 18:48:55 +0000

What is Ezcli?

Ezcli is a Go package for building CLI tools easily.

Installation

Initialize your project with go mod init <name>
Get Ezcli with go get github.com/5elenay/ezcli

API Reference

Click here for API reference. (pkg.go.dev sometime does not update package version, so use https://pkg.go.dev/github.com/5elenay/ezcli@<latest version> for get the API reference for latest version.)

Source Code

Click here for source code.

Example

Simple example for Ezcli.

package main

import (
    "fmt"

    "github.com/5elenay/ezcli"
)

func main() {
    handler := ezcli.CreateHandler() // Create handle function also gives built-in help command. So you dont need to write a help command yourself.

    // Adding a new command.
    handler.AddCommand(&ezcli.Command{
        Name:        "hello", // Command name.
        Description: "Say hello world!", // Command description.
        Options: []*ezcli.CommandOption{ // Command options (example: -force, -confirm etc...).
            {
                Name:        "test", // Option name.
                Description: "A test command", // Option description.
            },
        },
        Execute: func(c *ezcli.Command) { // The function will run.
            fmt.Println("Hello Command!")
        },
    })

    handler.Handle() // Handle commands.
}

Now lets compile our app with go build .

Time to test our app! Run the compiled app with ./<name> help

You should get the following result:

List of all commands. For more information, add a command name parameter to command.
  help | Built-in help command for application.
  hello | Say hello world!

Lets test our hello command with ./<name> hello:

Hello Command!

Congrats, you created your first app with Ezcli!

Contribution

Found Bug? Issue? Please report at here. Or if you want to improve ezcli:

Fork the project from GitHub.
Make commits.
Open a pull-request and wait.

Postgrey - Simple, Fast & Async Library for PostgreSQL

5elenay — Wed, 30 Jun 2021 00:19:23 +0000

Postgrey

🐘 Simple, Fast, Async & ORM PostgreSQL database client based on Asyncpg for Python.

Installation

Just type pip install postgrey to your favorite terminal and you are ready to go!

Features

Simple: You can learn Postgrey in less than a hours!
Fast: Since Postgrey is based on Asyncpg, Postgrey is really fast.
Secure: Postgrey has SQL injection protection.
ORM: You don't need to learn SQL for your apps.
Freedom: If you are a SQL master, you still can execute SQL commands.
Asyncpg: You easily can use Asyncpg in Postgrey.

Documentation

Check GitHub for documentation.

Htmotor - Template Engine for Python

5elenay — Tue, 15 Jun 2021 17:47:02 +0000

Htmotor

HTML Template Engine for Python!

Installation:

Open your terminal and type pip install htmotor. Now you are ready to go!

Supports:

Variables
For Loop
Eval, Exec
XSS Preventation

Documentation:

Documentation is avaible at GitHub.

Bug? Issue?

If you got an error or bug, please report at here.

Simple Example

if you want to see htmotor syntax, here you go:

<!DOCTYPE html>
<html lang="en">
<head>
        {% responsive %}
        <title>{%v title %}</title>
</head>
<body>
        <h1>{%v name %}</h1>
        {%ex import datetime %}
        <p>Datetime: {%ev datetime.datetime.utcnow().strftime("%d/%m/%Y, %H:%M:%S") %}</p>
</body>
</html>

Hyaline - Hardest Way to Create Discord Bot

5elenay — Wed, 09 Jun 2021 05:17:36 +0000

Hyaline Discord API Wrapper.

WARNING: Hyaline is not easy to use library.

Hyaline is a discord api wrapper for python. hyaline is created for discord developers and hyaline makes everything harder. Its in alpha-release and still not finished.

Check ./docs folder for documentation and more informations about hyaline. Documentation is not finished. You can use python dir() function for get all functions, attrs in the object. Also use help() for get help about a function / class.

Installation

Just type pip install hyaline and you are ready to go!

Current Version - 0.1.0

Change Log:

Added PyPi Support!

Example Ping-Pong Discord Bot

# Import the library and intent helper.
import hyaline
from hyaline.helpers.Intents import ALL

# Setup session configurations.
# NOTE: If you want to limit message cache add MAX_MESSAGES
session = hyaline.Session({
    "TOKEN": "token",
    "INTENTS": ALL
})


async def on_ready(_packet):
    print(f"Bot Started with name: {session.client.username}.")


async def on_message(msg):
    if not msg.author.id == session.client.id and msg.content.lower() == "ping":
        await msg.reply({
            "content": ":ping_pong: Pong!"
        })

# Configure the events.
# Also you can configure multiple event.
session.event("MESSAGE_CREATE", on_message)
session.event("READY", on_ready)

# Start the session.
session.start()

Floppa Programming Language!

5elenay — Mon, 17 May 2021 06:06:29 +0000

Floppa Programming Language

Created just for fun. But if you want to contribute, why not? Github

Floppa p.l. inspired by the brainf*ck programming language. So you can convert your brainf*ck code to floppa code.

Compiling

You must have installed go before using compiler. If you have, run the ./compiler/main.go program. Compiler takes two argument, first argument is input file (.flop file), second argument is output file (.go file). The compiler is written in golang, so you actually can compile your .flop code to machine language with using go build <file.go>

Converting Brainf*ck Code to Floppa Code

You can use simple python code for that. You must have python3.6>= for use this code. Converter: ./tools/bf2floppa.py. Same with compiler, takes two argument. First one is input file (.bf), Second one is output file (.flop).

Hello World

Here an example hello world program written in floppa programming language (./example/helloworld.flop);

keeerr keerr flop go keeerr keeerr keer no fo hoe go keer floppa 
no keerr flop go keeerr keeerr keer no fo hoe go fo floppa keeerr 
keerr floppa floppa keerr floppa no keeerr keerr flop go foooo fo 
foooo foo no fo hoe go foo floppa no keeerr keeerr keerr flop go 
keeerr ker no fo hoe go floppa no keeerr keer flop go keeerr no 
fo hoe go floppa keerr floppa foooo foo floppa foooo foooo floppa 
no ker keeerr ker flop go foooo foooo fooo no fo hoe go fo flop 
no ker go fo hoe no floppa fooo flop foooo foooo fooo hoe

Commands

ker => Add one byte to current cell.
fo => Remove one byte from current cell.
go => Goto next cell.
no => Goto last cell.
flop => Start loop. (will continue until no byte left.)
hoe => Finish current statement.
caracal => Get one byte input.
floppa => Print current cell as ascii.
brb => Finish the program. (panic.)
flop(0-255) => Checks if current cell byte size same with the number. if so, runs the commands after this statement.
fofo(0-255) => Checks if current cell byte size same or smaller than the number. if so, runs the commands after this statement.
fohoe(0-255) => Checks if current cell byte size same or bigger than the number. if so, runs the commands after this statement.

These commands added for help while adding / removing byte:
keer => Add two byte to current cell.
foo => Remove two byte from current cell.
keerr => Add three byte to current cell.
fooo => Remove three byte from current cell.
keeerr => Add four byte to current cell.
foooo => Remove four byte from current cell.

For brainf*ck;

{
    "+": "ker",
    "-": "fo",
    ">": "go",
    "<": "no",
    "[": "flop",
    "]": "hoe",
    ",": "caracal",
    ".": "floppa",
    "++": "keer",
    "--": "foo",
    "+++": "keerr",
    "---": "fooo",
    "++++": "keeerr",
    "----": "foooo"
}

Comments

Compiler ignores anything except keywords, so you can type whatever you want. Check ./example/mandelbrot.flop for example.

What Can I Do With This?

In theory, you can do everything. If you are masochist, try write a floppa programming language interpreter that created with floppa programming language!

Python Brainf*ck Compiler (Alpha)

5elenay — Sat, 15 May 2021 11:09:14 +0000

I was bored so i made a python compiler for brainf*ck programming language.

Links

Source Code (Github)
What is Brainf*ck?

Example Brainf*ck Program

[ This program prints "Hello World!" and a newline to the screen, its
  length is 106 active command characters. [It is not the shortest.]

  This loop is an "initial comment loop", a simple way of adding a comment
  to a BF program such that you don't have to worry about any command
  characters. Any ".", ",", "+", "-", "<" and ">" characters are simply
  ignored, the "[" and "]" characters just have to be balanced. This
  loop and the commands it contains are ignored because the current cell
  defaults to a value of 0; the 0 value causes this loop to be skipped.
]
++++++++               Set Cell #0 to 8
[
    >++++               Add 4 to Cell #1; this will always set Cell #1 to 4
    [                   as the cell will be cleared by the loop
        >++             Add 2 to Cell #2
        >+++            Add 3 to Cell #3
        >+++            Add 3 to Cell #4
        >+              Add 1 to Cell #5
        <<<<-           Decrement the loop counter in Cell #1
    ]                   Loop till Cell #1 is zero; number of iterations is 4
    >+                  Add 1 to Cell #2
    >+                  Add 1 to Cell #3
    >-                  Subtract 1 from Cell #4
    >>+                 Add 1 to Cell #6
    [<]                 Move back to the first zero cell you find; this will
                        be Cell #1 which was cleared by the previous loop
    <-                  Decrement the loop Counter in Cell #0
]                       Loop till Cell #0 is zero; number of iterations is 8

The result of this is:
Cell No :   0   1   2   3   4   5   6
Contents:   0   0  72 104  88  32   8
Pointer :   ^

>>.                     Cell #2 has value 72 which is 'H'
>---.                   Subtract 3 from Cell #3 to get 101 which is 'e'
+++++++..+++.           Likewise for 'llo' from Cell #3
>>.                     Cell #5 is 32 for the space
<-.                     Subtract 1 from Cell #4 for 87 to give a 'W'
<.                      Cell #3 was set to 'o' from the end of 'Hello'
+++.------.--------.    Cell #3 for 'rl' and 'd'
>>+.                    Add 1 to Cell #5 gives us an exclamation point
>++.                    And finally a newline from Cell #6

Config

Check config.json first, quick information about config.json;

{
    "MEM": 20, // MEM is the total cells for our brainfuck program.
    "DUMP_FILE": "./result/dump.py", // The dump file that will write when program finished and got some informations about the code. 
    "COMPILE_FILE": "./result/compiled.py", // The file that will write when brainfuck code turned into python code.
    "LOG_FILE": "./result/logs.txt", // Log file for our program actions.
    "DEBUG": true // Allow debug mode for compiler, will log everything to console.
}

Usage

Simple Usage;
python compiler.py ./example/fibonacci.bf

Output: ... 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89 ...

And also you can check ./result/dump.py for some informations about program;

# DUMP RESULT | 13/05/2021 16:59:13
# =======================================================
# TOTAL CELL GIVEN: 20
# TOTAL CELL USED: 4
# TOTAL BYTE USED: 309
# MEMORY DUMP: [
    # CELL_0 -> 0 BYTE
    # CELL_1 -> 144 BYTE
    # CELL_2 -> 89 BYTE
    # CELL_3 -> 0 BYTE
    # CELL_4 -> 0 BYTE
    # CELL_5 -> 44 BYTE
    # CELL_6 -> 32 BYTE
    # CELL_7 -> 0 BYTE
    # CELL_8 -> 0 BYTE
    # CELL_9 -> 0 BYTE
    # CELL_10 -> 0 BYTE
    # CELL_11 -> 0 BYTE
    # CELL_12 -> 0 BYTE
    # CELL_13 -> 0 BYTE
    # CELL_14 -> 0 BYTE
    # CELL_15 -> 0 BYTE
    # CELL_16 -> 0 BYTE
    # CELL_17 -> 0 BYTE
    # CELL_18 -> 0 BYTE
    # CELL_19 -> 0 BYTE
# ]

# MINIFIED VERSION: [
    # LINE_1 -> +++++++++++>+>>>>++++++++++++++++++++++++++++++++++++++++++++>++++++++++++++++++
    # LINE_2 -> ++++++++++++++<<<<<<[>[>>>>>>+>+<<<<<<<-]>>>>>>>[<<<<<<<+>>>>>>>-]<[>++++++++++[
    # LINE_3 -> -<-[>>+>+<<<-]>>>[<<<+>>>-]+<[>[-]<[-]]>[<<[>>>+<<<-]>>[-]]<<]>>>[>>+>+<<<-]>>>[
    # LINE_4 -> <<<+>>>-]+<[>[-]<[-]]>[<<+>>[-]]<<<<<<<]>>>>>[++++++++++++++++++++++++++++++++++
    # LINE_5 -> ++++++++++++++.[-]]++++++++++<[->-<]>+++++++++++++++++++++++++++++++++++++++++++
    # LINE_6 -> +++++.[-]<<<<<<<<<<<<[>>>+>+<<<<-]>>>>[<<<<+>>>>-]<-[>>.>.<<<[-]]<<[>>+>+<<<-]>>
    # LINE_7 -> >[<<<+>>>-]<<[<+>-]>[<+>-]<<<-]
# ]
# =======================================================

# Code Starts Here ...

Notes

This program may have some bugs. If you found a bug, please contribute!

VarState, Python Package for State Management.

5elenay — Tue, 11 May 2021 08:20:07 +0000

What is VarState?

VarState is a Python Package For Managing Data ReactJS State-Like.

Features

Create, Update, Delete State
Create, Update, Delete Events
Simple & Quick. (Easy to Use)
Fast Performance

Links

Source Code
PyPi Page

Installing

Simple, just type pip install -U varstate. or you can use with source code.

Quick Documentation

Creating State

from varstate import State
# Importing State

state = State()
get, update = state.create(-1) # Now we created a state that has value -1.
# i will use -1 for this document. You can put whatever you want.

# Now we have two functions.
# get() for getting value, and
# update(any) to update our value.

Updating

# We can change the value with update() function.
# function takes one argument, the argument will be new value.

print(get()) # Print current value
update(1) # Updating the value to 1
print(get()) # Print updated value

Deleting

# If you finished your works with state, you can delete from the memory.
# just call the <State>.delete()!

state.delete() # Deleted the events and value.

Events

# You can use events for run some functions.
# Example;

from varstate import State
# Importing State

state = State()
# Before calling create, let's create the events.
state.before_create(lambda value: print(f"Creating state with {value}, type: {type(value)}"))
# before_create runs before state creates.
state.after_create(lambda value: print(f"Created state with {value}, type: {type(value)}"))
# after_create runs after state created.

get, update = state.create(-1)
# When you run the program, it will print:
# Creating state with -1, type: <class 'int'>
# Created state with -1, type: <class 'int'>

before_create

# This event runs when started to create a state.
# Takes one argument, the value that will be create.

from varstate import State

state = State()
state.before_create(lambda value: print(f"Creating state with {value}, type: {type(value)}"))

# NOTE: also you can use function like this;
def before_create_function(value):
    print(f"Creating state with {value}, type: {type(value)}")

state.before_create(before_create_function)

# Creating the state
get, update = state.create(-1)

after_create

# This event runs when created a state.
# Takes one argument, the value that created.

from varstate import State

state = State()
state.after_create(lambda value: print(f"Created state with {value}, type: {type(value)}"))

# Creating the state
get, update = state.create(-1)

before_update

# This event runs when started to update the data.
# Takes two argument, first one is the value, second one is the new value will update.

from varstate import State

state = State()
state.before_update(lambda now, future: print(now, future))

# Creating the state
get, update = state.create(-1)

print(get())
update(1)
print(get())

after_update

# This event runs when updated the data.
# Takes two argument, first one is the updated value, second one is the old value.

from varstate import State

state = State()
state.after_create(lambda now, old: print(f"{old} updated to {now}."))

# Creating the state
get, update = state.create(-1)

print(get())
update(1)
print(get())

should_update

# This event checks should data updated.
# Takes two argument, first one is the value, second one is the new value will update.
# Also function should return a boolean.

from varstate import State

state = State()
state.should_update(lambda now, future: future % 2 == 0) # Now it will only update if new data is even.

# Creating the state
get, update = state.create(-1)

print(get())
update(1) # Not updating
print(get())
update(2) # Updating
print(get())

before_delete

# This event runs before delete function runs.

from varstate import State

state = State()
state.before_delete(lambda: print("please don't delete me ;("))

# Creating the state
get, update = state.create(-1)

print(get())
update(1)
print(get())

state.delete()

Datagoose, JSON Based Database for Best Performance.

5elenay — Mon, 10 May 2021 19:02:43 +0000

Datagoose

Datagoose is an easy to use JSON based database for python.

With Datagoose:

Best performance. Datagoose is a lightweight database.
Methods that makes your job easier.
Regex supports.
Safe to use.
Auto or manual save, for who wants better performance.
Easy to use database. Created for everyone.
Rich options. includes hash keys, database path, garbage leak option and more.
Auto backup
Events
Can be dumped, also can load a data from JSON file.
- <Datagoose>.load()
- <Datagoose>.dump()

Source Code

Click

Download

You can download with pip install -U datagoose (PyPi Page) or, you can use with source code.

Documentation

Quick Documentation

Performance

Test Result (Auto-Save Enabled):

100 Data with insert many:

Starting Insert...
Inserting Finished in  0:00:00.007002

1,000 Data with insert many:

Starting Insert...
Inserting Finished in  0:00:00.032004

10,000 Data with insert many:

Starting Insert...
Inserting Finished in  0:00:00.278020

100,000 Data with insert many:

Starting Insert...
Inserting Finished in  0:00:02.808687

1,000,000 Data with insert many:

Starting Insert...
Inserting Finished in  0:00:31.908481

Random Example Code

from datagoose import Datagoose
import random

# Getting Database
# Will create a new JSON file if not exists.
db = Datagoose("example", {
    "AUTO_SAVE": True,
    "USE_REGEX": True,
    "PATH": "dg/databases"
})

# insert many function example.
db.insert_many(*(
    {
        "NAME": random.choice(["eric", "kyle", "ike"]),
        "LAST_NAME": random.choice(["cartman", "marsh"]),
        "AGE": random.randint(9, 12),
        "POINT": random.randint(1, 10_000),
        "UID": i 
    } for i in range(10_000)
))

# find and sort function example (you can use regex.)
for res in db.find_and_sort({ "NAME": r"eric|kyle", "LAST_NAME": r"cartman", "AGE": 10 }, "POINT"):
    print(res)