notalib


Namenotalib JSON
Version 2.4.0 PyPI version JSON
download
home_pagehttps://github.com/m1kc/notalib
SummaryA collection of utility functions & classes
upload_time2024-09-05 14:37:02
maintainerNone
docs_urlNone
authorm1kc (Max Musatov)
requires_python<4.0.0,>=3.7.3
licenseMIT
keywords utility django pandas
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # notalib [![Django CI](https://github.com/m1kc/notalib/actions/workflows/django.yml/badge.svg)](https://github.com/m1kc/notalib/actions/workflows/django.yml) [![Coverage Status](https://coveralls.io/repos/github/m1kc/notalib/badge.svg?branch=master)](https://coveralls.io/github/m1kc/notalib?branch=master)

Collection of small Python utility functions and classes. Each one was created because I needed it and it didn't exist or I didn't like the existing implementations. 100% of code is used in real-world projects.

(And one day, the documentation is going to be actually good. In the meanwhile, don't hesitate to ask if something's not clear.)


## Install

```sh
pip install notalib
```

Or with [poetry](https://python-poetry.org/):

```sh
poetry add notalib
```


## Compatibility promise

Version numbers follow the semver rules.
* Minor releases are backwards-compatible. For example, an upgrade from 1.2 to 1.4 should be safe.
* Major releases are not backwards-compatible. For example, an upgrade from 1.4 to 2.0 is unsafe — read the release notes to see what's changed.


## Maintenance & bugfixes

While I try to fix bugs, add new features, and review any PRs when I have time, there're no promises and no set timeframes, even if a bug is critical. That's a project I do in my free time, free of charge.

If that's not enough for you or you have an urgent request, there are paid maintenance options (bugfixing, features, expedite PR review, 24h security responses). Contact me for prices: m1kc@yandex.ru

Also feel free to just send me money:

* MasterCard: 5559 4925 7484 0297
* PayPal: [paypal.me/thisism1kc](https://paypal.me/thisism1kc)

Donations are always appreciated, even if you send 10$.


## Constants included

* `notalib.utf.BOM`: contains string `b'\xEF\xBB\xBF'` (UTF-8 little endian byte order mark).

## Utils included

#### notalib.array.as_chunks :fire:

Iterates over your array in chunks of at most N elements.

```python
from notalib.array import as_chunks

arr = [1,2,3,4,5]
for chunk in as_chunks(arr, 2):
    print(chunk)
# [1,2]
# [3,4]
# [5]
```

#### notalib.array.ensure_iterable :fire:

Keeps iterable things like lists intact, turns single values into single-element lists. Useful for functions that can accept both.

```python
ensure_iterable([1,2,3])  # --> [1,2,3]
ensure_iterable((1,2,3))  # --> (1,2,3)
ensure_iterable(1)        # --> [1]
ensure_iterable('smth')   # --> ['smth']

def my_function(one_or_multiple_args):
    for arg in ensure_iterable(one_or_multiple_args):
        ...

my_function(['log', 'smog'])
my_function('dog')
```

#### notalib.array.batched

Batch data from the iterable into tuples of length n.

```python
from notalib.array import batched


def generate_numbers():
    for i in range(10):
        yield i


batches = list(batched(generate_numbers(), 5))     # --> [(0, 1, 2, 3, 4), (5, 6, 7, 8, 9)]
batches = list(batched("Hello", 2))     # --> [('H', 'e'), ('l', 'l'), ('o',)]
```

#### notalib.combinator.Combinator :fire:
#### notalib.date.parse_month
#### notalib.date.parse_date
#### notalib.date.normalize_date :fire:

Re-formats a date, parsing it as any of the `input_formats` and outputting it as `output_format`.

This function uses Arrow date formats. See [Arrow docs](https://arrow.readthedocs.io/en/latest/guide.html#supported-tokens) for details.

```
Args:
	s: The source date in one of the input_formats to be converted to target format.
	input_formats: Source date representation formats.
	output_format: The format in which the date will be output.
	allow_empty: if true, `None` input will produce `None` output, otherwise a ValueError will be thrown.

Example:
	>>> normalize_date('12.07.2023', ('D.M.YYYY', 'DD.MM.YYYY'), 'YYYY-MM-DD', False)
	'2023-07-12'

Returns:
	Converted date string from any of the input formats to the specified output format.
```

#### <s>notalib.date.get_week_number</s>

_Removed in 2.0.0. Use `get_week` instead. If you want the "old" week numbering, use get_week with `WeekNumbering.MATCH_YEAR` and add 1 to week number._

#### notalib.date.get_week

Returns named tuple with week number for the given date. Accepts Python dates and Arrow timestamps.

Optional argument `mode` tells what to do if the week started in previous year:

* WeekNumbering.NORMAL (default): consider it the last week of the previous year
* WeekNumbering.MATCH_YEAR: consider it 0-th week of current year

```python
from notalib.date import get_week, WeekNumbering
from datetime import date

date1, date2 = date(2022, 12, 31), date(2023, 1, 1)
get_week(date1, WeekNumbering.NORMAL)
# Week(week=52, year=2022)

get_week(date1, WeekNumbering.MATCH_YEAR)
# Week(week=52, year=2022)

get_week(date2, WeekNumbering.NORMAL)
# Week(week=52, year=2022)

get_week(date2, WeekNumbering.MATCH_YEAR)
# Week(week=0, year=2023)
```

#### notalib.dict.deep_merge

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Merges two dicts.

Modifies input. Use `copy.deepcopy` to create a deep copy of the original dictionary if you need it.

Accepts three arguments:

* original dict (also target)
* second dict
* overwrite=True if you want to overwrite matching paths, overwrite=False to raise an exception on path conflicts (default)

#### notalib.dict.find_field
#### notalib.dict.find_value
#### notalib.dict.normalize_dict :fire:
#### notalib.dict.filter_dict

Filters a dictionary, removing any keys except for the ones you choose.

```python
from notalib.dict import filter_dict

src = {
	'Some': "BODY",
	'once': "told me",
	'the world': "is gonna roll me",
}
filter_dict(src, ["Some", "once"])
# {'Some': 'BODY', 'once': 'told me'}
filter_dict(src, [])
# {}
```

#### notalib.format.format_long_list
#### notalib.timedelta.convert_timedelta

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Converts standard timedelta object to specified formats.

Allowed formats: 's', 'ms'.

```python
from notalib.timedelta import convert_timedelta
from datetime import timedelta

td = timedelta(seconds=1, milliseconds=23)
convert_timedelta(td, 's')
# 1.023
convert_timedelta(td, 'ms')
# 1023
```

#### notalib.hypertext.strip_tags :fire:
#### notalib.hypertext.TablePrinter :fire:

Prints an HTML table, row by row, from the given data, using attrs or dictionary keys as columns.

Two ways to use it:

* Call header() / entry() / footer() manually

```python
from notalib.hypertext import TablePrinter
t = TablePrinter(['a', 'b'])
t.header()
# '<table><thead><tr><th>a</th><th>b</th></tr></thead><tbody>'
t.entry({'a': 1, 'b': 2})
# '<tr><td>1</td><td>2</td></tr>\n'
t.entry({'a': 11, 'b': 22})
# '<tr><td>11</td><td>22</td></tr>\n'
t.footer()
# '</tbody></table>'
```

* Pass an iterable to iterator_over()

```python
from notalib.hypertext import TablePrinter
t = TablePrinter(['a', 'b'])
list(t.iterator_over([ {'a': 11, 'b': 22} ]))
# ['<table><thead><tr><th>a</th><th>b</th></tr></thead><tbody>',
#  '<tr><td>11</td><td>22</td></tr>\n',
#  '</tbody></table>']
```

#### notalib.polosa.polosa :fire: :fire: :fire: :fire: :fire:

```
18023/2000000   294.8/sec   Processing transaction ID#84378473 (2020-01-04)
```

The CLI progress indicator you've always dreamt of: shows current and total if available, measures current speed, can show your comments for each element, makes sure not to slow down your terminal with frequent updates. [See this short demo](https://asciinema.org/a/UI1aOqjQC1KXx303kaVGrxjQp).

_Cheat sheet_

```python
## Basic usage
with polosa() as p:
    p.tick()
# 467344   201.2/sec

## Specify total number of elements:
with polosa(total=1337) as p:
# 26/1337   1.2/sec

## Print something useful about every element:
p.tick(caption=my_order.time_created)
# 1723910/2000000   319231.2/sec   2020-01-01 15:37:00
```

#### notalib.range.Range
#### notalib.time.Timing :fire:

Measures time spent on executing your code. Killer feature: it can be used as a reusable context.

```python
timing = Timing()
...
with timing:
    do_something()
# That's it, do something with the measurement
log(f'Operation took {timing.result} sec')
```

If you just want to print measurements into console, there's a shorthand:

```python
timing = Timing(auto_print=True)
...
with timing:
    do_something()
```

#### notalib.trendsetter.Trendsetter :fire:

#### notalib.git.get_current_commit

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Returns short description and hash of last commit of current branch.
If function is called outside git repo or there are no commits in the history, `None` will be returned.

```python
from notalib.git import get_current_commit

commit = get_current_commit()
# Commit(hash='db0e5c1de83f233abef823fd92490727f4ee9d50', short_description='Add timedelta module with convert_timedelta function')
```
#### notalib.git.get_last_tag

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Returns last tag label and hash. If function is called outside git repo or there are no tags in the history, `None` will be returned.

```python
from notalib.git import get_last_tag

tag = get_last_tag()
# Tag(hash='c4b6e06f57ab4773e2881d286804d4e3141b5195', label='v1.4.0')
```

#### notalib.file_iterator.file_iterator
Iterates over byte buffer and yields chunks of specified size.

```python
with open("<file_path>", mode="rb") as file:
    for chunk in file_iterator(file):
        ...
```

## Tools for Pandas

#### notalib.pandas.pandasplus.row_to_dict
#### notalib.pandas.pandasplus.replace_null_objects

Replaces all types of null values in a DataFrame with the given value.

```python
df = pd.DataFrame({'A': [pd.NA, pd.NaT, 'SomeVal', None]})
new_df = replace_null_objects(df, "Hello, notalib!")
new_df
#                  A
# 0  Hello, notalib!
# 1  Hello, notalib!
# 2          SomeVal
# 3  Hello, notalib!
```

## Tools for Django

#### notalib.django.auth.StaticBackend
#### notalib.django.auth.SettingsBackend

#### notalib.django.xauth

Endpoints for easier authentication in APIs. Requires Django REST framework.

Provides endpoints:

* `GET /xauth/check` — returns code 200 if client is authenticated (or global permissions are set to AllowAny), 403 if not
* `POST /xauth/auth-post` — authenticates a client; accepts two POST parameters `username` and `password`; returns code 200 on success and 403 on failure
* `POST /xauth/logout` — de-authenticates a client

How to use:

1. Make sure Django REST framework is installed.
2. Add `'notalib.django_xauth'` to INSTALLED_APPS.
3. Run `manage.py migrate django_xauth` (doesn't actually change your DB).
4. Add something like this to your urls.py: `path('xauth/', include('notalib.django_xauth.urls')),`

#### notalib.django.colorlog.ColorFormatter
#### notalib.django.filterset :fire:
#### notalib.django.formplus.MonthField
#### notalib.django.formplus.ChoiceWithDefault
#### notalib.django.formplus.IntegerArrayField
#### notalib.django.formplus.StringArrayField
#### notalib.django.formplus.MonthArrayField

#### notalib.django.http.HttpResponseSeeOther

Spec-compliant HTTP 303 See Other redirect (Django only provides deprecated 301 and 302).

#### notalib.django.http.HttpResponseTemporaryRedirect

Spec-compliant HTTP 307 Temporary Redirect (Django only provides deprecated 301 and 302).

#### notalib.django.request_time_middleware.RequestTimeLoggingMiddleware
#### notalib.django.stream.stream_json

Stream all elements of iterable object as JSON array using the StreamingHttpResponse class. Unlike DRF's Response class, it can handle arrays of any size.

```python
class SomeViewSet(...):
    ...

    def list(self, request, *args, **kwargs):
        ...
        return stream_json(data)
```


#### notalib.django.bytes_stream.get_stream_bytes_response

Stream bytes IO part by the RANGE header value or all buffer content.

```python
class SomeView(...):
    def get(self, request, *args, **kwargs):
        with open("<file_path>", mode="rb") as file:
            ...
            return get_stream_bytes_response(file, request, content_type="<file_content_type>")
```


## <s>Django/Clickhouse</s>

_Deprecated since 2.2.0._

<details><summary>Click to expand</summary>

Required packages: `clickhouse-sqlalchemy`

Required two django.settings variables:

* **CLICKHOUSE_URL** — database URL
* **CLICKHOUSE_PROFILE** — dump all queries and their timing to console, true/false

#### notalib.django.clickhouse.base.get_connection
#### notalib.django.clickhouse.base.get_database_name
#### notalib.django.clickhouse.base.Query

A wrapper for SQLAlchemy's `select` with some useful postprocessing options.

* `execute` — no postprocessing
* `execute_val` — returns single value
* `execute_list` — returns single column as list
* `execute_kv` — returns dict, first column becomes keys, second column becomes values
* `execute_na` — returns number of affected rows

Usage example:

```python
q = Query(
    select([ SomeTable.c.notalib ])
)
q.execute_list()
# ["Example", "OOOOO", "my", "defence", ...]
```

#### notalib.django.clickhouse.mutations.get_mutations_in_progress_count

Returns the number of mutations in progress for the specified table.

```python
get_mutations_in_progress_count("SOME_DATABASE", "SOME_TABLE_IN_DATABASE")
# 5
```

#### notalib.django.clickhouse.wait.wait_result :fire:

Waits until all mutations for the given table are complete.

```python
# blah blah blah, ALTER TABLE ... UPDATE ...
wait_result("SOME_DATABASE", "SOME_TABLE_IN_DATABASE")
# UPDATE complete, continue
```

</details>

## Tools for Tablib

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Required packages: [tablib](https://pypi.org/project/tablib/)

#### notalib.tablib.shortcuts.load_dataset

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Allows to simplify the loading of datasets, even custom ones.

```python
from notalib.tablib.shortcuts import load_dataset

with open("report.xlsx", mode='rb') as file:
    ds = load_dataset(file)

### Or you can use custom Dataset class and format

from tablib import Dataset


class MyDataset(Dataset):
    pass


with open("report.csv", mode='rb') as file:
    ds = load_dataset(file, 'csv', MyDataset)
```

#### notalib.tablib.dataset.ExtendedDataset

_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._

Extended tablib.Dataset class, which adds useful data processing methods.

#### notalib.tablib.dataset.ExtendedDataset.drop_duplicates

Removes all duplicate rows from the `ExtendedDataset` object while maintaining the original order.

#### notalib.tablib.dataset.ExtendedDataset.drop_empty

Removes rows with empty data in specified columns.

#### notalib.tablib.dataset.ExtendedDataset.drop_empty_rows

Removes rows in which all values are empty.

#### notalib.tablib.dataset.ExtendedDataset.apply_to_column

Applies the function to the values in the specified column.

#### notalib.tablib.dataset.ExtendedDataset.replace_empty_objects

Replaces empty values with a new one.

#### notalib.tablib.dataset.ExtendedDataset.set_used_columns

Returns a new dataset based on the specified header labels.

#### notalib.tablib.dataset.ExtendedDataset.get_headers_map

Returns a list of Boolean objects based on a given set of header labels.

#### notalib.tablib.dataset.ExtendedDataset.get_header_index

Calculates the index of the header by its label.

#### notalib.tablib.dataset.ExtendedDataset.groupby

Sets tags to rows and returns list of groups for filtering.

#### notalib.tablib.dataset.ExtendedDataset.rename_headers

Renames header labels.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/m1kc/notalib",
    "name": "notalib",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0.0,>=3.7.3",
    "maintainer_email": null,
    "keywords": "utility, django, pandas",
    "author": "m1kc (Max Musatov)",
    "author_email": "m1kc@yandex.ru",
    "download_url": "https://files.pythonhosted.org/packages/ae/ca/b78889d79852e561449a6b149a47cb5cea595293f65a384a059dde8c1a97/notalib-2.4.0.tar.gz",
    "platform": null,
    "description": "# notalib [![Django CI](https://github.com/m1kc/notalib/actions/workflows/django.yml/badge.svg)](https://github.com/m1kc/notalib/actions/workflows/django.yml) [![Coverage Status](https://coveralls.io/repos/github/m1kc/notalib/badge.svg?branch=master)](https://coveralls.io/github/m1kc/notalib?branch=master)\n\nCollection of small Python utility functions and classes. Each one was created because I needed it and it didn't exist or I didn't like the existing implementations. 100% of code is used in real-world projects.\n\n(And one day, the documentation is going to be actually good. In the meanwhile, don't hesitate to ask if something's not clear.)\n\n\n## Install\n\n```sh\npip install notalib\n```\n\nOr with [poetry](https://python-poetry.org/):\n\n```sh\npoetry add notalib\n```\n\n\n## Compatibility promise\n\nVersion numbers follow the semver rules.\n* Minor releases are backwards-compatible. For example, an upgrade from 1.2 to 1.4 should be safe.\n* Major releases are not backwards-compatible. For example, an upgrade from 1.4 to 2.0 is unsafe \u2014 read the release notes to see what's changed.\n\n\n## Maintenance & bugfixes\n\nWhile I try to fix bugs, add new features, and review any PRs when I have time, there're no promises and no set timeframes, even if a bug is critical. That's a project I do in my free time, free of charge.\n\nIf that's not enough for you or you have an urgent request, there are paid maintenance options (bugfixing, features, expedite PR review, 24h security responses). Contact me for prices: m1kc@yandex.ru\n\nAlso feel free to just send me money:\n\n* MasterCard: 5559 4925 7484 0297\n* PayPal: [paypal.me/thisism1kc](https://paypal.me/thisism1kc)\n\nDonations are always appreciated, even if you send 10$.\n\n\n## Constants included\n\n* `notalib.utf.BOM`: contains string `b'\\xEF\\xBB\\xBF'` (UTF-8 little endian byte order mark).\n\n## Utils included\n\n#### notalib.array.as_chunks :fire:\n\nIterates over your array in chunks of at most N elements.\n\n```python\nfrom notalib.array import as_chunks\n\narr = [1,2,3,4,5]\nfor chunk in as_chunks(arr, 2):\n    print(chunk)\n# [1,2]\n# [3,4]\n# [5]\n```\n\n#### notalib.array.ensure_iterable :fire:\n\nKeeps iterable things like lists intact, turns single values into single-element lists. Useful for functions that can accept both.\n\n```python\nensure_iterable([1,2,3])  # --> [1,2,3]\nensure_iterable((1,2,3))  # --> (1,2,3)\nensure_iterable(1)        # --> [1]\nensure_iterable('smth')   # --> ['smth']\n\ndef my_function(one_or_multiple_args):\n    for arg in ensure_iterable(one_or_multiple_args):\n        ...\n\nmy_function(['log', 'smog'])\nmy_function('dog')\n```\n\n#### notalib.array.batched\n\nBatch data from the iterable into tuples of length n.\n\n```python\nfrom notalib.array import batched\n\n\ndef generate_numbers():\n    for i in range(10):\n        yield i\n\n\nbatches = list(batched(generate_numbers(), 5))     # --> [(0, 1, 2, 3, 4), (5, 6, 7, 8, 9)]\nbatches = list(batched(\"Hello\", 2))     # --> [('H', 'e'), ('l', 'l'), ('o',)]\n```\n\n#### notalib.combinator.Combinator :fire:\n#### notalib.date.parse_month\n#### notalib.date.parse_date\n#### notalib.date.normalize_date :fire:\n\nRe-formats a date, parsing it as any of the `input_formats` and outputting it as `output_format`.\n\nThis function uses Arrow date formats. See [Arrow docs](https://arrow.readthedocs.io/en/latest/guide.html#supported-tokens) for details.\n\n```\nArgs:\n\ts: The source date in one of the input_formats to be converted to target format.\n\tinput_formats: Source date representation formats.\n\toutput_format: The format in which the date will be output.\n\tallow_empty: if true, `None` input will produce `None` output, otherwise a ValueError will be thrown.\n\nExample:\n\t>>> normalize_date('12.07.2023', ('D.M.YYYY', 'DD.MM.YYYY'), 'YYYY-MM-DD', False)\n\t'2023-07-12'\n\nReturns:\n\tConverted date string from any of the input formats to the specified output format.\n```\n\n#### <s>notalib.date.get_week_number</s>\n\n_Removed in 2.0.0. Use `get_week` instead. If you want the \"old\" week numbering, use get_week with `WeekNumbering.MATCH_YEAR` and add 1 to week number._\n\n#### notalib.date.get_week\n\nReturns named tuple with week number for the given date. Accepts Python dates and Arrow timestamps.\n\nOptional argument `mode` tells what to do if the week started in previous year:\n\n* WeekNumbering.NORMAL (default): consider it the last week of the previous year\n* WeekNumbering.MATCH_YEAR: consider it 0-th week of current year\n\n```python\nfrom notalib.date import get_week, WeekNumbering\nfrom datetime import date\n\ndate1, date2 = date(2022, 12, 31), date(2023, 1, 1)\nget_week(date1, WeekNumbering.NORMAL)\n# Week(week=52, year=2022)\n\nget_week(date1, WeekNumbering.MATCH_YEAR)\n# Week(week=52, year=2022)\n\nget_week(date2, WeekNumbering.NORMAL)\n# Week(week=52, year=2022)\n\nget_week(date2, WeekNumbering.MATCH_YEAR)\n# Week(week=0, year=2023)\n```\n\n#### notalib.dict.deep_merge\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nMerges two dicts.\n\nModifies input. Use `copy.deepcopy` to create a deep copy of the original dictionary if you need it.\n\nAccepts three arguments:\n\n* original dict (also target)\n* second dict\n* overwrite=True if you want to overwrite matching paths, overwrite=False to raise an exception on path conflicts (default)\n\n#### notalib.dict.find_field\n#### notalib.dict.find_value\n#### notalib.dict.normalize_dict :fire:\n#### notalib.dict.filter_dict\n\nFilters a dictionary, removing any keys except for the ones you choose.\n\n```python\nfrom notalib.dict import filter_dict\n\nsrc = {\n\t'Some': \"BODY\",\n\t'once': \"told me\",\n\t'the world': \"is gonna roll me\",\n}\nfilter_dict(src, [\"Some\", \"once\"])\n# {'Some': 'BODY', 'once': 'told me'}\nfilter_dict(src, [])\n# {}\n```\n\n#### notalib.format.format_long_list\n#### notalib.timedelta.convert_timedelta\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nConverts standard timedelta object to specified formats.\n\nAllowed formats: 's', 'ms'.\n\n```python\nfrom notalib.timedelta import convert_timedelta\nfrom datetime import timedelta\n\ntd = timedelta(seconds=1, milliseconds=23)\nconvert_timedelta(td, 's')\n# 1.023\nconvert_timedelta(td, 'ms')\n# 1023\n```\n\n#### notalib.hypertext.strip_tags :fire:\n#### notalib.hypertext.TablePrinter :fire:\n\nPrints an HTML table, row by row, from the given data, using attrs or dictionary keys as columns.\n\nTwo ways to use it:\n\n* Call header() / entry() / footer() manually\n\n```python\nfrom notalib.hypertext import TablePrinter\nt = TablePrinter(['a', 'b'])\nt.header()\n# '<table><thead><tr><th>a</th><th>b</th></tr></thead><tbody>'\nt.entry({'a': 1, 'b': 2})\n# '<tr><td>1</td><td>2</td></tr>\\n'\nt.entry({'a': 11, 'b': 22})\n# '<tr><td>11</td><td>22</td></tr>\\n'\nt.footer()\n# '</tbody></table>'\n```\n\n* Pass an iterable to iterator_over()\n\n```python\nfrom notalib.hypertext import TablePrinter\nt = TablePrinter(['a', 'b'])\nlist(t.iterator_over([ {'a': 11, 'b': 22} ]))\n# ['<table><thead><tr><th>a</th><th>b</th></tr></thead><tbody>',\n#  '<tr><td>11</td><td>22</td></tr>\\n',\n#  '</tbody></table>']\n```\n\n#### notalib.polosa.polosa :fire: :fire: :fire: :fire: :fire:\n\n```\n18023/2000000   294.8/sec   Processing transaction ID#84378473 (2020-01-04)\n```\n\nThe CLI progress indicator you've always dreamt of: shows current and total if available, measures current speed, can show your comments for each element, makes sure not to slow down your terminal with frequent updates. [See this short demo](https://asciinema.org/a/UI1aOqjQC1KXx303kaVGrxjQp).\n\n_Cheat sheet_\n\n```python\n## Basic usage\nwith polosa() as p:\n    p.tick()\n# 467344   201.2/sec\n\n## Specify total number of elements:\nwith polosa(total=1337) as p:\n# 26/1337   1.2/sec\n\n## Print something useful about every element:\np.tick(caption=my_order.time_created)\n# 1723910/2000000   319231.2/sec   2020-01-01 15:37:00\n```\n\n#### notalib.range.Range\n#### notalib.time.Timing :fire:\n\nMeasures time spent on executing your code. Killer feature: it can be used as a reusable context.\n\n```python\ntiming = Timing()\n...\nwith timing:\n    do_something()\n# That's it, do something with the measurement\nlog(f'Operation took {timing.result} sec')\n```\n\nIf you just want to print measurements into console, there's a shorthand:\n\n```python\ntiming = Timing(auto_print=True)\n...\nwith timing:\n    do_something()\n```\n\n#### notalib.trendsetter.Trendsetter :fire:\n\n#### notalib.git.get_current_commit\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nReturns short description and hash of last commit of current branch.\nIf function is called outside git repo or there are no commits in the history, `None` will be returned.\n\n```python\nfrom notalib.git import get_current_commit\n\ncommit = get_current_commit()\n# Commit(hash='db0e5c1de83f233abef823fd92490727f4ee9d50', short_description='Add timedelta module with convert_timedelta function')\n```\n#### notalib.git.get_last_tag\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nReturns last tag label and hash. If function is called outside git repo or there are no tags in the history, `None` will be returned.\n\n```python\nfrom notalib.git import get_last_tag\n\ntag = get_last_tag()\n# Tag(hash='c4b6e06f57ab4773e2881d286804d4e3141b5195', label='v1.4.0')\n```\n\n#### notalib.file_iterator.file_iterator\nIterates over byte buffer and yields chunks of specified size.\n\n```python\nwith open(\"<file_path>\", mode=\"rb\") as file:\n    for chunk in file_iterator(file):\n        ...\n```\n\n## Tools for Pandas\n\n#### notalib.pandas.pandasplus.row_to_dict\n#### notalib.pandas.pandasplus.replace_null_objects\n\nReplaces all types of null values in a DataFrame with the given value.\n\n```python\ndf = pd.DataFrame({'A': [pd.NA, pd.NaT, 'SomeVal', None]})\nnew_df = replace_null_objects(df, \"Hello, notalib!\")\nnew_df\n#                  A\n# 0  Hello, notalib!\n# 1  Hello, notalib!\n# 2          SomeVal\n# 3  Hello, notalib!\n```\n\n## Tools for Django\n\n#### notalib.django.auth.StaticBackend\n#### notalib.django.auth.SettingsBackend\n\n#### notalib.django.xauth\n\nEndpoints for easier authentication in APIs. Requires Django REST framework.\n\nProvides endpoints:\n\n* `GET /xauth/check` \u2014 returns code 200 if client is authenticated (or global permissions are set to AllowAny), 403 if not\n* `POST /xauth/auth-post` \u2014 authenticates a client; accepts two POST parameters `username` and `password`; returns code 200 on success and 403 on failure\n* `POST /xauth/logout` \u2014 de-authenticates a client\n\nHow to use:\n\n1. Make sure Django REST framework is installed.\n2. Add `'notalib.django_xauth'` to INSTALLED_APPS.\n3. Run `manage.py migrate django_xauth` (doesn't actually change your DB).\n4. Add something like this to your urls.py: `path('xauth/', include('notalib.django_xauth.urls')),`\n\n#### notalib.django.colorlog.ColorFormatter\n#### notalib.django.filterset :fire:\n#### notalib.django.formplus.MonthField\n#### notalib.django.formplus.ChoiceWithDefault\n#### notalib.django.formplus.IntegerArrayField\n#### notalib.django.formplus.StringArrayField\n#### notalib.django.formplus.MonthArrayField\n\n#### notalib.django.http.HttpResponseSeeOther\n\nSpec-compliant HTTP 303 See Other redirect (Django only provides deprecated 301 and 302).\n\n#### notalib.django.http.HttpResponseTemporaryRedirect\n\nSpec-compliant HTTP 307 Temporary Redirect (Django only provides deprecated 301 and 302).\n\n#### notalib.django.request_time_middleware.RequestTimeLoggingMiddleware\n#### notalib.django.stream.stream_json\n\nStream all elements of iterable object as JSON array using the StreamingHttpResponse class. Unlike DRF's Response class, it can handle arrays of any size.\n\n```python\nclass SomeViewSet(...):\n    ...\n\n    def list(self, request, *args, **kwargs):\n        ...\n        return stream_json(data)\n```\n\n\n#### notalib.django.bytes_stream.get_stream_bytes_response\n\nStream bytes IO part by the RANGE header value or all buffer content.\n\n```python\nclass SomeView(...):\n    def get(self, request, *args, **kwargs):\n        with open(\"<file_path>\", mode=\"rb\") as file:\n            ...\n            return get_stream_bytes_response(file, request, content_type=\"<file_content_type>\")\n```\n\n\n## <s>Django/Clickhouse</s>\n\n_Deprecated since 2.2.0._\n\n<details><summary>Click to expand</summary>\n\nRequired packages: `clickhouse-sqlalchemy`\n\nRequired two django.settings variables:\n\n* **CLICKHOUSE_URL** \u2014 database URL\n* **CLICKHOUSE_PROFILE** \u2014 dump all queries and their timing to console, true/false\n\n#### notalib.django.clickhouse.base.get_connection\n#### notalib.django.clickhouse.base.get_database_name\n#### notalib.django.clickhouse.base.Query\n\nA wrapper for SQLAlchemy's `select` with some useful postprocessing options.\n\n* `execute` \u2014 no postprocessing\n* `execute_val` \u2014 returns single value\n* `execute_list` \u2014 returns single column as list\n* `execute_kv` \u2014 returns dict, first column becomes keys, second column becomes values\n* `execute_na` \u2014 returns number of affected rows\n\nUsage example:\n\n```python\nq = Query(\n    select([ SomeTable.c.notalib ])\n)\nq.execute_list()\n# [\"Example\", \"OOOOO\", \"my\", \"defence\", ...]\n```\n\n#### notalib.django.clickhouse.mutations.get_mutations_in_progress_count\n\nReturns the number of mutations in progress for the specified table.\n\n```python\nget_mutations_in_progress_count(\"SOME_DATABASE\", \"SOME_TABLE_IN_DATABASE\")\n# 5\n```\n\n#### notalib.django.clickhouse.wait.wait_result :fire:\n\nWaits until all mutations for the given table are complete.\n\n```python\n# blah blah blah, ALTER TABLE ... UPDATE ...\nwait_result(\"SOME_DATABASE\", \"SOME_TABLE_IN_DATABASE\")\n# UPDATE complete, continue\n```\n\n</details>\n\n## Tools for Tablib\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nRequired packages: [tablib](https://pypi.org/project/tablib/)\n\n#### notalib.tablib.shortcuts.load_dataset\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nAllows to simplify the loading of datasets, even custom ones.\n\n```python\nfrom notalib.tablib.shortcuts import load_dataset\n\nwith open(\"report.xlsx\", mode='rb') as file:\n    ds = load_dataset(file)\n\n### Or you can use custom Dataset class and format\n\nfrom tablib import Dataset\n\n\nclass MyDataset(Dataset):\n    pass\n\n\nwith open(\"report.csv\", mode='rb') as file:\n    ds = load_dataset(file, 'csv', MyDataset)\n```\n\n#### notalib.tablib.dataset.ExtendedDataset\n\n_:warning: Experimental API. Subject to change. Don't use in production. You've been warned._\n\nExtended tablib.Dataset class, which adds useful data processing methods.\n\n#### notalib.tablib.dataset.ExtendedDataset.drop_duplicates\n\nRemoves all duplicate rows from the `ExtendedDataset` object while maintaining the original order.\n\n#### notalib.tablib.dataset.ExtendedDataset.drop_empty\n\nRemoves rows with empty data in specified columns.\n\n#### notalib.tablib.dataset.ExtendedDataset.drop_empty_rows\n\nRemoves rows in which all values are empty.\n\n#### notalib.tablib.dataset.ExtendedDataset.apply_to_column\n\nApplies the function to the values in the specified column.\n\n#### notalib.tablib.dataset.ExtendedDataset.replace_empty_objects\n\nReplaces empty values with a new one.\n\n#### notalib.tablib.dataset.ExtendedDataset.set_used_columns\n\nReturns a new dataset based on the specified header labels.\n\n#### notalib.tablib.dataset.ExtendedDataset.get_headers_map\n\nReturns a list of Boolean objects based on a given set of header labels.\n\n#### notalib.tablib.dataset.ExtendedDataset.get_header_index\n\nCalculates the index of the header by its label.\n\n#### notalib.tablib.dataset.ExtendedDataset.groupby\n\nSets tags to rows and returns list of groups for filtering.\n\n#### notalib.tablib.dataset.ExtendedDataset.rename_headers\n\nRenames header labels.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A collection of utility functions & classes",
    "version": "2.4.0",
    "project_urls": {
        "Documentation": "https://github.com/m1kc/notalib",
        "Homepage": "https://github.com/m1kc/notalib",
        "Repository": "https://github.com/m1kc/notalib.git"
    },
    "split_keywords": [
        "utility",
        " django",
        " pandas"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ddd5de7ec62efdfb07285e8fddfdc769cab1136711b12b7f5e1b974e135fcffe",
                "md5": "397a411fb55fc2d984c46eb7a83ef0f1",
                "sha256": "4a32a12b27af1fc4daf3de86cbf8a049abb8a2a48abd5bafd990ee028a6334d6"
            },
            "downloads": -1,
            "filename": "notalib-2.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "397a411fb55fc2d984c46eb7a83ef0f1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0.0,>=3.7.3",
            "size": 64517,
            "upload_time": "2024-09-05T14:37:00",
            "upload_time_iso_8601": "2024-09-05T14:37:00.198577Z",
            "url": "https://files.pythonhosted.org/packages/dd/d5/de7ec62efdfb07285e8fddfdc769cab1136711b12b7f5e1b974e135fcffe/notalib-2.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "aecab78889d79852e561449a6b149a47cb5cea595293f65a384a059dde8c1a97",
                "md5": "421cfabb5347b565dd7137b24833a065",
                "sha256": "8d600d9ab4a8649e4b8df113bf41269932a4ad6270e9e5b56ce11f1277bc43af"
            },
            "downloads": -1,
            "filename": "notalib-2.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "421cfabb5347b565dd7137b24833a065",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0.0,>=3.7.3",
            "size": 51420,
            "upload_time": "2024-09-05T14:37:02",
            "upload_time_iso_8601": "2024-09-05T14:37:02.696928Z",
            "url": "https://files.pythonhosted.org/packages/ae/ca/b78889d79852e561449a6b149a47cb5cea595293f65a384a059dde8c1a97/notalib-2.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-05 14:37:02",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "m1kc",
    "github_project": "notalib",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "notalib"
}
        
Elapsed time: 0.40632s