Skip to main content

Welcome to crocodile

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.

This package extends many native Python classes to equip you with an uneasy-to-tame power. The major classes extended are:

  • list is extended to List

    • Forget that for loops exist, because with this class, for loops are implicitly used to apply a function to all items. 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. Behaviour is ala-JavaScript implementation of forEach method of Arrays.
  • dict is extended to Struct.

    • Combines the power of dot notation like classes and key access like dictionaries.
  • pathlib.Path is extended to P

    • P objects are incredibly powerful for parsing paths, no more than one line of code is required to do any operation. Take a shufti at this:
    path = tb.P("dataset/type1/meta/images/file3.ext")
    >> path[0]  # allows indexing!
    P("dataset")
    >> path[-1]  # nifty!
    P("file3.ext")
    >> path[2:-1]  # even slicing!
    P("meta/images/file3.ext")
    

    This and much more, is only on top of the indespensible pathlib.Path functionalities.

  • Additionally, the package provides many other new classes, e.g. Read and Save. Together with P, they provide comprehensive support for file management. Life cannot get easier with those. Every class inherits attributes that allow saving and loading in one line.

Furthermore, those classes are inextricably connected. For example, globbing a path P object returns a List object. You can move back and forth between List and Struct and DataFrame with one method, and so on.

  • Deep Learning Modules.
    • A paradigm that facilitates working with deep learning models that is based on a tri-partite scheme:
      • HyperParameters: facilitated through HParams class.
      • Data: facilitated though DataReader class.
      • BaseModel is a frontend for both TensorFlow & Pytorch backends. The wrapper worked in tandem.
    • The aforementioned classes cooperate together to offer sealmess workflow during creation, training, and saving models.

Install

In the commandline: pip install crocodile.

Being a thin extension on top of almost pure Python, you need to worry not about your venv, the package is not aggressive in requirements, it installs itself peacefully, never interfere with your other packages. If you do not have numpy, matplotlib and pandas, it simply throws ImportError at runtime, that's it.

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 crocodile.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().search("*.py", r=True).read_text().split('\n').apply(len).to_numpy().sum()

How does this make perfect sense?

  • search returns List of P path objects
  • read_text is a P method, but it is being run against List object. Behind the scenes, responsible black magic fails to find such a method in List 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 another List object and returns it.
  • A similar story applies to split which is a method of strings in Python.
  • Next, apply is a method of List. Sure enough, it lives up to its apt name and applies the passed function len to all items in the list and returns another List object that contains the results.
  • .to_numpy() converts List to numpy array, then .sum is a method of numpy, which gives the final result.

Methods naming convention like apply and to_numpy are inspired from the popular pandas library, resulting in almost non-existing learning curve.

Friendly interactive tutorial.

Please refer to Here on the main git repo.

Full docs:

Click Here

Author

Alex Al-Saffar. email

Metadata

Release files for crocodile 6.20

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crocodile 6.20
File Size Uploaded Provenance Actions
crocodile-6.20.tar.gz 75.4 kB Without provenance Details for crocodile-6.20.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for crocodile 6.20
File Interpreter ABI Platform Actions
crocodile-6.20-py3-none-any.whl Python 3 none any Details for crocodile-6.20-py3-none-any.whl

Total release size: 152.4 kB

Release files / crocodile-6.20.tar.gz

Download URL crocodile-6.20.tar.gz
Size 75.4 kB
Tags Source
SHA-256 checksum
How to use checksums
85fc084e33b7ff191c39a998ba77fa8ba76ee8e669cc4d14395d5ca511c5658a
BLAKE2b-256 checksum
How to use checksums
535456634311e72b2aa264cb94deb88b1d00c454452119b110828c6860b8024f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.12

Release files / crocodile-6.20-py3-none-any.whl

Download URL crocodile-6.20-py3-none-any.whl
Size 77.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12d960eb44ff8435299516a562a91164af33ae4af71b5290b7bca6ee96e40067
BLAKE2b-256 checksum
How to use checksums
5cfeb4305e2ac5c2e51e1ba6238d0edc3ded46ce625265fcefe1a2b93debc751
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.0 CPython/3.9.12

Security for crocodile 6.20

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

6.20 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page