Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gabrieldemarmiesse/mojo-stdlib-extensions
A replica of python's stdlib in mojo
https://github.com/gabrieldemarmiesse/mojo-stdlib-extensions
mojo
Last synced: 3 days ago
JSON representation
A replica of python's stdlib in mojo
- Host: GitHub
- URL: https://github.com/gabrieldemarmiesse/mojo-stdlib-extensions
- Owner: gabrieldemarmiesse
- License: mit
- Created: 2023-10-12T11:51:36.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-01T09:11:27.000Z (9 months ago)
- Last Synced: 2024-05-01T17:06:37.961Z (8 months ago)
- Topics: mojo
- Language: Mojo
- Homepage:
- Size: 306 KB
- Stars: 56
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mojo - mojo-stdlib-extensions - A replica of Python's stdlib in Mojo. (🗂️ Libraries / System)
README
# mojo-stdlib-extensions
A replica of python's stdlib in mojo 🔥
**Note**: I am currently working on porting all this code to Mojo's stdlib, thus, this
repository will soon be obsolete.
```python
from stdlib_extensions.datetime import datetime, timedelta
from stdlib_extensions.builtins.string import rjust
from stdlib_extensions.builtins import list_to_str
def main():
now = datetime.now()
print(now.__str__())
print(now.__repr__())
print(now.year())
print(now.month())
...
time_elapsed = datetime.now() - now
print(time_elapsed.total_seconds())
print(rjust("hello world", 20, "*"))
my_list = List[String]()
my_list.append("hello")
my_list.append("world")
print(list_to_str(my_list))
```
Refer to the python documention for the documentation of those functions.
Dict is not provided, because it's now in Mojo's stdlib
### Complete list of what is available here:
```
stdlib_extensions.os.getpid
stdlib_extensions.os.fspath
stdlib_extensions.os.rmdir
stdlib_extensions.os.unlink
stdlib_extensions.os.urandom
stdlib_extensions.pathlib.Path
-> /, cwd, open, __fspath__, write_text, read_text, unlink, rmdir
stdlib_extensions.builtins.string.rjust
stdlib_extensions.builtins.string.ljust
stdlib_extensions.builtins.string.endswith
stdlib_extensions.builtins.string.startswith
stdlib_extensions.builtins.string.split
stdlib_extensions.builtins.string.join
stdlib_extensions.builtins.string.replace
stdlib_extensions.builtins.string.removeprefix
stdlib_extensions.builtins.string.removesuffix
stdlib_extensions.builtins.string.expandtabs
stdlib_extensions.builtins.string.rstrip
stdlib_extensions.builtins.string.lstrip
stdlib_extensions.builtins.string.strip
stdlib_extensions.builtins.hex
stdlib_extensions.builtins.to_bytes
stdlib_extensions.builtins.input
stdlib_extensions.builtins.list_to_str
-> for Int and Strings, because Mojo doesn't support multiple traits for the same type yet
stdlib_extensions.builtins.bytes
-> __len__, __str__, __getitem__, __setitem__, ==,
!=, +, *, +=, *=, fromhex, hex
stdlib_extensions.datetime.datetime
-> microsecond, second, minute, ..., year, +, -, now, min, max
stdlib_extensions.datetime.timedelta
-> total_seconds, total_microseconds, microseconds, seconds, days, +, -, /
stdlib_extensions.datetime.time
-> microsecond, second, minute, hour, min, max
stdlib_extensions.datetime.date
-> year, month, day, min, max, today
stdlib_extensions.time.time_ns()
stdlib_extensions.uuid.uuid4()
stdlib_extensions.uuid.UUID
-> __str__, hex, ==, <, bytes, urn, variant, version
```
### Features missing from mojo to have a perfect replica of the api:
* `__iter__` (we need this badly to avoid indexing errors)
* `@property` decorator
* struct attributes
### Features missing from mojo to improve code readability:
* Union types (we need this badly to avoid code duplication)
* `String.__mul__()`
* f-strings
* subclassing struct
* absolute imports working with `mojo package`
### Contributing:
Any function from the Python stdlib is welcome. Make sure to have the same signatures and apis
(or as close as possible if mojo doesn't support something yet).
Run the tests with `mojo run_all_tests.mojo`.
Reformat with `mojo format ./`.
You can also use the pre-commit hook if you don't want to run manually `mojo format ./` before each commit.
```bash
pip install pre-commit
pre-commit install
```