Metadata-Version: 2.1
Name: py-machineid
Version: 0.8.1
Summary: Get the unique machine ID of any host (without admin privileges)
Home-page: https://github.com/keygen-sh/py-machineid
Author: Zeke Gabrielse
Author-email: oss@keygen.sh
License: MIT
Description: # py-machineid
        
        [![CI](https://github.com/keygen-sh/py-machineid/actions/workflows/test.yml/badge.svg)](https://github.com/keygen-sh/py-machineid/actions)
        [![PyPI version](https://badge.fury.io/py/py-machineid.svg)](https://badge.fury.io/py/py-machineid)
        
        Get the unique machine ID of any host (without admin privileges).
        
        Sponsored by:
        
        <a href="https://keygen.sh?ref=py-machineid">
          <div>
            <img src="https://keygen.sh/images/logo-pill.png" width="200" alt="Keygen">
          </div>
        </a>
        
        _A fair source software licensing and distribution API._
        
        ## Install
        
        Install using [`pip`](https://docs.python.org/3/installing/index.html):
        
        ```bash
        python3 -m pip install py-machineid
        ```
        
        ## Usage
        
        To obtain the raw GUID of the device, use `id() -> str`:
        
        ```python
        import machineid
        
        print(machineid.id())
        ```
        
        To obtain an anonymized (hashed) version of the GUID, see below. The
        `hashed_id(str) -> str` function takes an optional application ID,
        which will ensure a unique ID per-app for the same device.
        
        ```python
        import machineid
        
        print(machineid.hashed_id('myappid'))
        print(machineid.hashed_id())
        ```
        
        Both `id()` and `hashed_id()` accept a `winregistry: bool` kwarg,
        which can be used to disable the registry query on Windows (enabled
        by default). Depending on your security posture, disabling the
        registry query may help prevent machine fingerprints from
        being manually modified by a bad actor.
        
        ## Testing
        
        To run tests, invoke `unittest`:
        
        ```bash
        python3 -m unittest
        ```
        
        ## Building
        
        To build a release, run:
        
        ```bash
        python3 setup.py sdist bdist_wheel
        ```
        
        ## Publishing
        
        To publish a release, run:
        
        ```bash
        twine upload dist/*
        ```
        
        ## Thanks
        
        Special thanks to Denis Brodbeck for his Go package, [`machineid`](https://github.com/denisbrodbeck/machineid).
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
