overrides: Fix buffer API break

When introducing zero copy buffers/memory mapping we broke the API,
this brings back the exact same API as before for all the previously
handled cases but still raises an exception when using a context
to map buffers.

Fixes https://gitlab.freedesktop.org/gstreamer/gst-python/-/issues/40

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-python/-/merge_requests/39>

overrides: memory and buffer unmap code can be shared

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-python/-/merge_requests/35>

overrides: _remap: refactor to avoid memory leaks with PyObject

- unref PyObject on exit with Py_XDECREF
- better error handling
- free memory view in case of erros

Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-python/-/merge_requests/34>

Gst.py: raise an error if we can't unmap the memory

Gst.py: unref __parent__ on unmap otherwise it cause a memory leak

overrides: fix memory leak in pyg_boxed_new

pyg_boxed_new cause a memory leak if it hold a copy of the boxed wrapper and freed when the wrapper is deallocated.
use the boxed wrapper value itself and don't hold a copy of the value.

Back to development

Release 1.17.2

Back to development

Release 1.17.1

Add an example to record audio

Fix configure python lib detection in macOS

pylib_loc = python.get_variable('LIBPL', '') alreay returns
the correct path for python's library dir

gstmodule: Fix reference counts of Py_True and Py_False

When returning those values, extensions must take a new reference.

Fixes #33

testsuite: remove cleanup

It's no longer used.

test: Add test for the plugin loader

Fix #8

plugin: Also look at GST_PLUGIN_PATH_1_0

Do not declare mix declaration and code

Fix build with Python 3.8 by also checking for python-3.X-embed.pc

Since Python 3.8 the normal checks don't include the Python libraries
anymore and linking of the gst-python module would fail.

See also https://github.com/mesonbuild/meson/issues/5629

Fixes https://gitlab.freedesktop.org/gstreamer/gst-python/issues/28

example: Use do_fill in AudioTestSrc instead of do_create

With the new mapping API we can efficiently use the ->fill vmethod
which is sensibly better.

Subclass Exception for mapping and unmapping errors

And minor cleanup in the way errors are handled

tests: Add buffer map/unmap tests

Changes the mapinfo so that the mapped data is writable

The Problem is, that in the current state it is not easily possible to
edit the buffer data in a gstreamer python element since you get a copy
of the real buffer.

This patch overrides the mapinfo and the function generating it in a way
so that mapinfo.data is now a memoryview pointing to the real buffer.
Depending on the flags given for this buffer the memoryview is r/w.

python: Fix type type qualifiers issues

Remove python2 support

We have notified application developers this would happen a long time
ago and python2 is going to be deprecated very soon now, before 1.18
is going to be released.

Remove autotools build

overrides: fix callback setter overrides (bis)

The previous commit broke those by trying to pass weak refs
through pygobject, but we should probably have tested the elements
beyond instantiation: weakref.WeakMethod returns a callable, but
that callable when called only returns the ephemeral bound method,
which is the object we want to call, but pygobject has no support
for that.

Instead, fix the memory leaks we were going after by decoupling the
lifecycle of the callback and that of the pad, by passing functors
to pygobject.

overrides: fix callback setter overrides

Use weakref to avoid leaks, and remove refcount hack as the actual
issue has been fixed in pygobject

suppr: Add a supression on wrong jump in python from fedora 30

meson: expose plugins variable

override Element before Bin so we can access element fields of bins

And add a test

See https://gitlab.gnome.org/GNOME/pygobject/issues/325

Gst.py: add high-level helpers

Back to development

Release 1.16.0

Update TODO

Release 1.15.90

Back to development

Release 1.15.2

Gst.init() has to be called before GstPbutils is imported

This makes sure that we do not try to use GstPbutils before Gst is init
and in case GstPbutils is imported while Gst is not imported, use the
`GstPbutils.pb_utils_init()` function to have the oportunity to
initialize the overrides.

Not that we also introduce a `GstPbutils.init()` variant because
`GstPbutils.pb_utils_init()` is an ugly name.

meson: Re add workarounds to detect libpython path

This was removed all together in af4ade37435fcc31c8489f4d7c7496fef5f74b05
"meson: use new python module".

And add `-Dlibpython-dir` option for the cases the logic fails.

Release 1.15.1

overrides: add a set_caps() method to the Pad override

The C API provides the gst_pad_set_caps() helper which makes it easier
to set caps on pads (see gst/gstcompat.h in gstreamer core).

Add such handy helper to the python bindings too.

The implementation follows as close as possible the one in gstcompat.h
with two changes:
  1. the type check on the pad has been removed because self is
     guaranteed to be a Gst.Pad in python.
  2. the null check on the caps has been extended to be a type check.

Fixes https://gitlab.freedesktop.org/gstreamer/gst-python/issues/19

autogen.sh: update to match updated common submodule

Unbreaks the autotools build and fixes #15.

Fix indentation of .c files

Required to make gst-indent linter on CI happy.

Update common submodule

Add Gitlab CI configuration

This commit adds a .gitlab-ci.yml file, which uses a feature
to fetch the config from a centralized repository. The intent is
to have all the gstreamer modules use the same configuration.

The configuration is currently hosted at the gst-ci repository
under the gitlab/ci_template.yml path.

Part of https://gitlab.freedesktop.org/gstreamer/gstreamer-project/issues/29

Update git locations to gitlab

Tests: the sys.meta_path trick does not work for python2

Instead, for python2 revert to manipulating gi.overrides.__path__

Tests: refactor testing approach

Instead of fiddling with sys.path, we instead use a custom
sys.meta_path importer

meson: address python module port comments

meson: use new python module

This patch makes the tests pass running uninstalled and installed, with
python2 and python3 on linux, windows and osx.

The main gist is to use the new python-module to do the lifting done
by pythondetector, and with that add support for python2 and windows.

automake: remove __init__.py's

Remove __init__.py files

They were not installed, and were simply used for our
uninstalled setup, which we now implement differently.

meson: add pygobject fallback

Examples: add audiotestsrc plugin example

Examples: add audioplot plugin example

Examples: add mixer plugin example

examples: add a dynamic pipeline example

helloworld: fix typo

gstmodule: fix warning when building against python2

PyMapping_GetItemString’ discards ‘const’ qualifier from pointer target type

https://bugzilla.gnome.org/show_bug.cgi?id=796093

Fix distcheck

meson: drop config.h.meson template

Bump pygobject dependency to 3.8

overrides: use get_introspection_module

https://bugzilla.gnome.org/show_bug.cgi?id=795555

overrides: Fix mixup between query function and chain one

Dist autogen.sh and configure.ac

Back to development

Release 1.14.0

Release 1.13.91

Release 1.13.90

configure.ac: Don't use runtime location of overrides by default

If someone wants to put the overrides in a non-standard location,
they can use the --with-pygi-overrides-dir option.

The default is to put them in ${pyexecdir}/gi/overrides

Fixes make distcheck

https://bugzilla.gnome.org/show_bug.cgi?id=793756

makefiles: Add missing dist files

https://bugzilla.gnome.org/show_bug.cgi?id=793560

bitmask: Do not use long() directly with python3

It doesn't exist anymore there

gi: Check Gst has not been initialized before loading bindings

It can have been initialized by some C code (in a C app with plugins
for example).

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=788088

Allow Bitmask to be created from ints and longs but always store as long

We need a 64 bit integer, and previously the test failed because it was
already created from longs in various cases (e.g. when reading from a
GstStructure).

Back to development

overrides: accept Gst.Structure in Caps.__new__

Also rename misleading parameter (*kwargs -> *args)

https://bugzilla.gnome.org/show_bug.cgi?id=793493

Release 1.13.1

Print Python version after initialization

pluginloader: Print Python library path that is tried to be loaded

Ship meson build system in autotools generated tarballs

meson: Fix detection of overrides path in some cases

plugin: Always initialize GIL state

gcc warns about possibly unintialized use of it

(even if it can't actually happen)

Fix simply running testsuite in meson

- Make sure to never have root folder in sys.path when running meson,
  as pythondetector won't be able to access gi._overridesdir

- Generate a mesonconfig.py file that will be used by the testsuite to
  know where meson generated files, making `python -m unittest` working.

Add support for Gst.Bitmask

tests: Stop using deprecated assertion methods

tests: Move all Fundamental types tests in a file

No reason to have one file per type and it makes it more complicated
to handle.

structure: Add a .keys() method and implement __str__

We are making it behave like a dict, so we should provide the
same kind of utilities.

Return a Gst.*Range instead of a python range converting from GValue to python

Otherwise we lose the information about what type of range it is, which
is mandatory, especially when dealing with Structure and Caps.

structures: Override __new__ to make it more pythonic

overrides: Remove IntRange And Int64Range on Python2

They use the range() built-in type which is a Python 3 change.

https://bugzilla.gnome.org/show_bug.cgi?id=782927

pythonplugin: Rename plugin file to match plugin name

This is required by the new loader macro.

Back to development

Release 1.12.0

Release 1.11.91

Release 1.11.90

array/list: Make gvalue conversion symmetric

This is needed to support matrix. Otherwise, getting
a matrix would remove the rows envelopess, which would
make the "cast" fails, since it would not know if the
internal rows are ValueArray or ValueList. I think reading,
modifying and setting back the matrix is an important use
case.

gstmodule: Factor out gst type creation

This reduces a lot the boiler plate all over. At the same
time, use N instead of O when passing PyObject to fix
the objects leaks.

Add /build and install to the gitignore

overrides: Add more GstValue overrides

This patch adds overrides to support IntRange, Int64Range, DoubleRange,
FractionRange, Array and List. For integer ranges, it maps this
to python 'range'. Gst.IntRange() and Gst.Int64Range() are simple cast
to let the underlying code know which GType to use. To set such range in
python you will do:

  structure["range"] = Gst.IntRange(range(0,10,2)))

Same for the 64 bit variant. And when you do:

  r = structure.get_value("range")

A range will be returned directly, without the wrapper. For DoubleRange
and FractionRange, there is no native support in python. So the usage
will be:

  structure["range"] = Gst.DoubleRange(0,10.0)
  structure["range"] =
      Gst.FractionRange(Gst.Fraction(1/30), Gst.Fraction(1/5)

When getting this value, Gst.DoubleRange and Gst.FractionRange class are
returned. They both have start/stop members. The naming was taken from
range type.

For Array and List, both uses the native list type, though they can be
constructed from any python sequence. So again, the class is just like
a cast, to let it pick the right GType and python list are being
returned.

  structure["list"] = Gst.ValueList([1,2,3,4])
  structure["array"] = Gst.ValueArray([1,2,3,4)

Using string and tuple could also work. Since Gst.ValueList/Array are
sequence, you can convert one to the other with:

  list = Gst.ValueList([1,2,3,4])
  array = Gst.ValueArray (list)

https://bugzilla.gnome.org/show_bug.cgi?id=753754

meson: Install in gi._overidesdir only if we are installing in right prefix

And make sure python detector did not fail

https://bugzilla.gnome.org/show_bug.cgi?id=780369