Making Python even more convenient by extending list and dict and pathlib and more.
Project description
Welcome to alexlib
This package extends many native Python classes to equip you with an uneasy-to-tame power. Beside many minor extensions, the major classes extended are:
-
list
is extended toList
- Forget that
for
loops exist in your life, because with this class,for
loops are implicitly applied to all items.
- Forget that
-
dict
is extended toStruct
.- Combines the power of dot notation like classes and key access like dictionaries.
-
pathlib
is extended toP
P
objects are incredibly powerful for parsing paths, no more than one line of code is required to do any operation.
* Some other classes that make honorable mention here are `Read` and `Save` classes. Together with `P`, they provide comprehensible support for file management. Life cannot get easier with those.
Furthermore, those classes are inextricably connected. Example, globbing a path P
object returns a List
object. You can move back and forth between List
and Struct
with one method, and so on.
You can read the details in the code to grapple the motivation and the philosophy behind its implementation mechanics. Fill your life with one-liners, take your code to artistic level of brevity and readability while simultaneously being more productive by typing less boilerplate lines of code that are needless to say.
Install
just do this in your command line
pip install alexlib
.
Worry not about your venv, this package installs itself peacefully, never interfere with your other packages, not requires anything with force. If you do not have numpy
, matplotlib
and pandas
, it simply throws ImportError
at runtime, that's it. The package is not fussy about versions either.
Getting Started
That's as easy as taking candy from a baby; whenever you start a Python file, preface it with following in order to unleash the library:
import alexlib.toolbox as tb
A Taste of Power
Suppose you want to know how many lines of code in your repository. The procedure is to glob all .py
files recursively, read string code, split each one of them by lines, count the lines, add up everything from all strings of code.
To achieve this, all you need is an eminently readable one-liner.
tb.P.cwd().myglob("*.py", r=True).read_text().split('\n').apply(len).to_numpy().sum()
How does this make perfect sense?
myglob
returnsList
ofP
path objectsread_text
is aP
method, but it is being run againstList
object. Behind the scenes, responsible black magic fails to find such a method inList
and realizes it is a method of items inside the list, so it runs it against them and thus read all files and containerize them in anotherList
object and returns it.- Similar story applies to
split
which is a method of strings in Python. - Next,
apply
is a method ofList
. Sure enough, it lives up to its apt name and applies the passed functionlen
to all items in the list and returns anotherList
object that contains the results. .to_numpy()
convertsList
tonumpy
array, then.sum
is a method ofnumpy
, which gives the final result.
Other use cases
Inevitably while programming, one will encounter objects of the same type and you will be struggling to get a tough grab on them. List
is a powerful structure that put at your disposal a grip, so tough, that the objects you have at hand start behaving like one object.
This is the power of implicit for
loops. Share with us your one-liner snippets to add it to use-cases of this package.
Full docs:
Click Here
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.