https://github.com/sebastinas/python-libdiscid

cython based Python bindings for libdiscid
https://github.com/sebastinas/python-libdiscid

Last synced: about 1 month ago
JSON representation

cython based Python bindings for libdiscid

• Host: GitHub
• URL: https://github.com/sebastinas/python-libdiscid
• Owner: sebastinas
• License: mit
• Created: 2013-04-11T13:40:31.000Z (over 11 years ago)
• Default Branch: main
• Last Pushed: 2024-02-06T07:56:45.000Z (11 months ago)
• Last Synced: 2024-11-05T14:05:37.802Z (about 2 months ago)
• Language: Python
• Size: 205 KB
• Stars: 4
• Watchers: 5
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# libdiscid Python bindings

python-libdiscid implements Python >= 3.6 bindings for libdiscid using Cython.

## Dependencies

* libdiscid

* Cython (>= 0.15, optional)

* pkgconfig (optional)

Note that the tarballs come with pre-built C source for the Cython module. So

Cython is only required if one builds python-libdiscid from the git repository

or if one wants to change anything in the Cython module.

If pkgconfig is installed, setup.py uses libdiscid's pkg-config information to

set include directories, libraries to link, etc.

## Quick installation guide

python-libdiscid is available in some distributions:

* Debian/Ubuntu: `apt-get install python3-libdiscid` (Python 3)

* Fedora: `dnf install python3-libdiscid` (Python 3)

python-libdiscid can be installed via `pip`:

```

$ pip install python-libdiscid

```

or by running:

```

$ python3 setup.py install

```

If you just want to try it locally, run:

```

$ python3 setup.py build_ext -i

```

and hack right away. You can also run:

```

$ python3 setup.py build

```

but please make sure that `build/lib.*` is in `sys.path` before the source

folder.

It is also avalaible on `conda-forge`: 

```

$ conda install python-libdiscid -c conda-forge

```

or 

```

$ mamba install python-libdiscid -c conda-forge

```

## A note for Windows users

There are eggs available from PyPI that don't require the extension module to be

built. If these are used, it is still required to drop a working discid.dll in

`C:\WINDOWS\system32` (or wherever it can be found).

Installing the package through `conda-forge` for Windows 64-Bit will automatically download and install the library.

## Usage

```python3

from libdiscid import read

disc = read("/dev/cdrom")

print("id: {}".format(disc.id))

```

## License

python-libdiscid is released under the MIT license. Check LICENSE for details.