izzylib/README.md

54 lines
2 KiB
Markdown
Raw Normal View History

# IzzyLib
2020-03-05 11:20:50 -05:00
2021-06-07 16:45:29 -04:00
These are just a number of functions I keep reusing over and over again in most of my projects. It's okay to use them if you also find them useful
2020-03-07 14:25:45 -05:00
2021-06-07 16:45:29 -04:00
## Installation
You only need to install the base and whatever sub-modules you want to use
### From Git
2021-06-07 16:57:38 -04:00
2021-06-07 16:59:47 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-base&subdirectory=base"
2021-06-07 16:57:38 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-dbus&subdirectory=dbus"
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-hasher&subdirectory=hasher"
2021-06-07 16:59:47 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-http-server&subdirectory=http_server"
2021-06-07 16:57:38 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-http-urllib-client&subdirectory=http_urllib_client"
2021-06-07 16:57:38 -04:00
2021-06-07 16:59:47 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-sql&subdirectory=sql"
2021-06-07 16:57:38 -04:00
2021-06-07 16:59:47 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-templates&subdirectory=template"
2021-06-07 16:57:38 -04:00
2021-06-07 16:59:47 -04:00
$(venv)/bin/python -m pip install -e "git+https://git.barkshark.xyz/izaliamae/izzylib.git@rework#egg=izzylib-tinydb&subdirectory=tinydb"
2021-06-07 16:45:29 -04:00
### From Source
$(venv)/bin/python setup.py install ['all' or a combination of these: dbus hasher http_server http_urllib_client sql template tinydb]
2021-06-07 16:45:29 -04:00
## Documentation
### Importing
2021-06-07 16:57:38 -04:00
Most useful classes and functions are imported in the module root, so you don't need to do any multi-level imports. Example
This is fine:
2021-06-07 16:59:47 -04:00
from izzylib import SqlDatabase
2021-06-07 16:57:38 -04:00
and points to:
2021-06-07 16:59:47 -04:00
from izzylib.sql.generic import SqlDatabase
2021-06-07 16:57:38 -04:00
Or even simply do `import izzylib` and use `izzylib.SqlDatabase()`.
2021-06-07 16:45:29 -04:00
### Usage
All classes and functions will have docstrings. Either look through the code or run `help()` on an object
# NOTE!
2021-06-07 16:57:38 -04:00
Not in a stable state yet. Expect major changes