Skip to main content

micropy

My little lib of Python goodies

Micropy is auto-formatted using yapf.

Nice things

dig()

CSS selector like deep value grabbing from almost any object.

>>> from micropy import dig
>>> dig.xget((1, 2, 3), 1)
2
>>> dig.xget({'foo': 'bar'}, 'foo')
'bar'
>>> dig.dig({'foo': 1, 'bar': [1,2,3]}, 'bar.1')
2
>>> dig.dig({'foo': 1, 'bar': [1,{'baz':'jox'},3]}, 'bar.1.baz')
'jox'
>>>

The difference between dig.dig() and funcy.get_in() is that you can use shell-like blob patterns to get several values keyed by similar names:

>>> from micropy import dig
>>> res = dig.dig({'foo': 1, 'foop': 2}, 'f*')
>>> res
[foo=1:int, foop=2:int]
>>> # (textual representation of an indexable object)
>>> res[0]
foo=1:int
>>> res[1]
foop=2:int
>>>

Programmatic class creation

Programmatic creation of arbitrary named classes in module definition, add methods using a decorator notation:

>>> from micropy import lang
>>> mystuff = (('Foo', 1), ('Bar', 2))
>>> for name, num in mystuff: locals()[name] = lang.mkclass(name, **{'num': num})
>>> Foo
<class 'micropy.lang.Foo'>
>>> Foo.num
1
>>> \
... @Foo.classmethod
... def myclassmethod(cls, x):
...     return x + 1
>>> Foo.myclassmethod(1)
2
>>>
>>> \
... @Foo.staticmethod
... def mystaticmethod(x, y):
...     return x + y
>>> Foo.mystaticmethod(1, 2)
3
>>> \
... @Foo.method
... def mymethod(self, x):
...     self.y = self.num + x
...     return self.y
>>> foo = Foo()
>>> foo.mymethod(1)
2
>>> foo.y
2
>>>

micropy module with developer convenience tools

The micropy.microscope module contains utilities that aid development. It has to ways to inspect live objects:

  1. Via ‘AbneuYAML’

    AbneuYAML is “Almost, but not entirely unlike YAML”. Objects dumped to ‘AbneuYAML’ should be easy to get a visual overview of for humans.

    To dump any object:

    >>> from micropy import microscope
    >>> class Cls: pass
    ...
    >>> c = Cls()
    >>> c.foo, c.bar = 1, 2
    >>> c.sub = Cls()
    >>> c.sub.foo, c.sub.bar, c.sub.baz = 3, 4, [1, 2]
    >>> encoded = microscope.abneuyaml(c)
    >>> print(encoded) #doctest: +ELLIPSIS
    <__main__.Cls object at 0x...>:Cls
      foo=1:int
      bar=2:int
      sub=<__main__.Cls object at 0x...>:Cls
        foo=3:int
        bar=4:int
        baz=[1, 2]:list
    >>>

A simple way of creating small DSL’s using Python operator overloading.

>>> from micropy import lang
>>> \
... class PipingExample(lang.Piping):
...     def __add__(self, value) -> lang.Piping:
...         self.queue(lambda a, b: a + b, value)
...         return self
...
>>> simplest_pipe = PipingExample(10)
>>> res = simplest_pipe + 10 + 20
>>> res()
40
>>>

Mostly, you’ll want to use the pipe operator to define simple composition:

>>> from micropy import lang
>>> incr = lambda x: x + 1
>>> showr = "It is {}!".format
>>> (lang.ComposePiping(5) >> incr >> incr >> showr)()
'It is 7!'
>>>

‘Call by type’ convenience objects

>>> from micropy import lang
>>> foo = lang.Match({int: lambda x: x*100, str: lambda x: f'Hello {x}'})
>>> foo(10)
1000
>>> foo('bar')
'Hello bar'
>>>

Narrowable collections

Uses indexes to narrow collections to fewer values. You can narrow by type, a predicate function or value equality. The return value is always a new Narrowable derived type from the initial value. Therefore, you can chain several narrowing operations in the same expression.

Errors raised by the narrowing predicates are considered misses.

Some examples:

Narrow by type

>>> from micropy.primitives import narrowable
>>> narrowable((1,2,3,'foo', 'bar'))[int]
(1, 2, 3)
>>>

Narrow by callable

>>> from micropy.primitives import narrowable
>>> narrowable((1, 2, 3))[lambda x: x > 1]
(2, 3)
>>>
>>> narrowable((1,2,3,'foo', 'bar'))[int]
(1, 2, 3)
>>> narrowable((1,2,3,'foo', 'bar'))[lambda x: x > 1]
(2, 3)
>>> # Note, swallows ValueError raised by 'foo' > 1 etc
>>>

Supress empty iterable objects

>>> from micropy.primitives import narrowable
>>> narrowable([[1], [2], [], []])[lambda x: x[0]]
[[1], [2]]
>>>

Narrow using exact match

>>> from micropy.primitives import narrowable
>>> narrowable((1, 2, 3, 'foo'))['foo']
('foo',)
>>>

Narrow using a regexp

>>> from micropy.primitives import narrowable
>>> import re
>>> narrowable(('foo', 'fom', 'jox', 8, 'fim'))[re.compile('fo.*').match]
('foo', 'fom')
>>>

Combine

>>> from micropy.primitives import narrowable
>>> narrowable((1,2,3,'foo', 'bar'))[str]['foo']
('foo',)
>>>

Go deeper

>>> from micropy.primitives import narrowable
>>> narrowable((1, 2, 3, (41, 42, 43)))[tuple][0][lambda x: x > 41]
(42, 43)
>>>

No matches found

If no element matches, an empty version of the collection parameter will be returned:

>>> from micropy.primitives import narrowable
>>> narrowable((1,2,3))[lambda x: x > 3]
()
>>>

Metadata

Release files for micropy 0.6.2

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

Source distribution (sdist)

Source distribution for micropy 0.6.2
File Size Uploaded Provenance Actions
micropy-0.6.2.tar.gz 17.2 kB Without provenance Details for micropy-0.6.2.tar.gz

Release files / micropy-0.6.2.tar.gz

Download URL micropy-0.6.2.tar.gz
Size 17.2 kB
Tags Source
SHA-256 checksum
How to use checksums
635b49f6c6e05da0f877800fea4abb73163ece2f9b55b527946816a00d23f70e
BLAKE2b-256 checksum
How to use checksums
a8b88679af2a5738e517905ff6e7ddc8b36eae34eea2bac37c989c0d90dc58f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.3

Security for micropy 0.6.2

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.

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