LinkPython-extern 1.2.0__tar.gz → 1.2.1__tar.gz

linkpython_extern-1.2.1/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: LinkPython-extern
+Version: 1.2.1
+Summary: A fork of the LinkPython wrapper for Ableton Link
+Author: gonzaloflirt
+Maintainer: thegamecracks
+License: Unlicense
+Project-URL: Homepage, https://github.com/thegamecracks/link-python
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python
+Classifier: Topic :: System :: Networking
+Requires-Python: <3.15,>=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Dynamic: license
+Dynamic: license-file
+
+# Python wrapper for [Ableton Link][1]
+
+[![Build](https://github.com/thegamecracks/link-python/actions/workflows/build_wheels.yml/badge.svg)](https://github.com/thegamecracks/link-python/actions/workflows/build_wheels.yml)
+[![PyPI](https://img.shields.io/pypi/v/LinkPython-extern?label=View%20on%20pypi&style=flat-square)](https://pypi.org/project/LinkPython-extern/)
+
+This fork was created to streamline the user experience for installing LinkPython
+by uploading pre-built wheels on PyPI. More information about LinkPython
+can be found [in their repository][2].
+
+## Python compatibility
+
+|               | v1.0.0 | v1.0.1 | v1.0.4 | v1.1.0 | v1.2.0 | main |
+|---------------|:------:|:------:|:------:|:------:|:------:|:----:|
+| CPython 3.6   |   ✅   |   ✅   |   ✅   |  ❌  |  ❌   |  ❌  |
+| CPython 3.7   |   ✅   |   ✅   |   ✅   |  ✅  |  ❌   |  ❌  |
+| CPython 3.8   |   ✅   |   ✅   |   ✅   |  ✅  |  ✅   |  ✅  |
+| CPython 3.9   |   ✅   |   ✅   |   ✅   |  ✅  |  ✅   |  ✅  |
+| CPython 3.10  |   ✅   |   ✅   |   ✅   |  ✅  |  ✅   |  ✅  |
+| CPython 3.11  |   ❌   |   ✅   |   ✅   |  ✅  |  ✅   |  ✅  |
+| CPython 3.12  |   ❌   |   ❌   |   ✅   |  ✅  |  ✅   |  ✅  |
+| CPython 3.13  |   ❌   |   ❌   |   ❌   |  ✅¹ |  ✅¹  |  ✅¹ |
+| CPython 3.14  |   ❌   |   ❌   |   ❌   |  ❌  |  ✅   |  ✅  |
+| CPython 3.15+ |   ❌   |   ❌   |   ❌   |  ❌  |  ❌   |  ❌  |
+
+¹ CPython 3.13's experimental free-threading builds are not supported.
+
+## Installation
+
+Distributions are available on PyPI with the [LinkPython-extern][3] package.
+Example install command:
+
+```sh
+pip install LinkPython-extern
+```
+
+## Building from source
+
+If you want to build this package from source, you will need CMake installed.
+You however do not need to manually build the project, as setuptools will
+handle invoking cmake when you install it with pip. To install directly
+from the main branch:
+
+```sh
+pip install git+https://github.com/thegamecracks/link-python
+```
+
+## License:
+This depends on [Link][1] and [pybind11][4]. Please mind the licenses of those libraries and their dependencies.
+
+[1]: https://github.com/ableton/link.git
+[2]: https://github.com/gonzaloflirt/link-python
+[3]: https://pypi.org/project/LinkPython-extern/
+[4]: https://github.com/pybind/pybind11

linkpython_extern-1.2.1/modules/link/.clang-format

@@ -0,0 +1,15 @@
+AllowShortFunctionsOnASingleLine: Inline
+BinPackArguments: false
+BinPackParameters: false
+BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeBraces: Allman
+BreakConstructorInitializers: BeforeComma
+BreakTemplateDeclarations: Yes
+ColumnLimit: 90
+ConstructorInitializerIndentWidth: 2
+ContinuationIndentWidth: 2
+IndentWidth: 2
+MaxEmptyLinesToKeep: 2
+PenaltyBreakBeforeFirstCallParameter: 0
+PenaltyReturnTypeOnItsOwnLine: 1000
+PointerAlignment: Left

linkpython_extern-1.2.1/modules/link/cmake_include/ConfigureCompileFlags.cmake

@@ -0,0 +1,171 @@
+cmake_minimum_required(VERSION 3.10)
+
+set(build_flags_COMMON_LIST)
+set(build_flags_DEBUG_LIST)
+set(build_flags_RELEASE_LIST)
+
+#  _   _       _
+# | | | |_ __ (_)_  __
+# | | | | '_ \| \ \/ /
+# | |_| | | | | |>  <
+#  \___/|_| |_|_/_/\_\
+#
+
+if(UNIX)
+  # Common flags for all Unix compilers
+  set(build_flags_DEBUG_LIST
+    "-DDEBUG=1"
+  )
+  set(build_flags_RELEASE_LIST
+    "-DNDEBUG=1"
+  )
+
+  # Clang-specific flags
+  if(${CMAKE_CXX_COMPILER_ID} MATCHES Clang)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "-Weverything"
+      "-Werror"
+      "-Wno-c++98-compat"
+      "-Wno-c++98-compat-pedantic"
+      "-Wno-deprecated"
+      "-Wno-disabled-macro-expansion"
+      "-Wno-exit-time-destructors"
+      "-Wno-padded"
+      "-Wno-poison-system-directories"
+      "-Wno-reserved-id-macro"
+      "-Wno-unknown-warning-option"
+      "-Wno-unsafe-buffer-usage"
+      "-Wno-unused-member-function"
+    )
+
+  # GCC-specific flags
+  # Unfortunately, we can't use -Werror on GCC, since there is no way to suppress the
+  # warnings generated by -fpermissive.
+  elseif(${CMAKE_CXX_COMPILER_ID} STREQUAL GNU)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "-Werror"
+      "-Wno-multichar"
+    )
+  endif()
+
+  # ASan support
+  if(LINK_ENABLE_ASAN)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "-fsanitize=address"
+      "-fno-omit-frame-pointer"
+    )
+  endif()
+
+# __        ___           _
+# \ \      / (_)_ __   __| | _____      _____
+#  \ \ /\ / /| | '_ \ / _` |/ _ \ \ /\ / / __|
+#   \ V  V / | | | | | (_| | (_) \ V  V /\__ \
+#    \_/\_/  |_|_| |_|\__,_|\___/ \_/\_/ |___/
+#
+
+elseif(${CMAKE_CXX_COMPILER_ID} STREQUAL MSVC)
+  add_definitions("/D_SCL_SECURE_NO_WARNINGS")
+  if(LINK_BUILD_VLD)
+    add_definitions("/DLINK_BUILD_VLD=1")
+  else()
+    add_definitions("/DLINK_BUILD_VLD=0")
+  endif()
+  if(LINK_WINDOWS_SETTHREADDESCRIPTION)
+    add_definitions("/DLINK_WINDOWS_SETTHREADDESCRIPTION")
+  endif()
+
+  set(build_flags_DEBUG_LIST
+    "/DDEBUG=1"
+  )
+  set(build_flags_RELEASE_LIST
+    "/DNDEBUG=1"
+  )
+
+  set(build_flags_COMMON_LIST
+    ${build_flags_COMMON_LIST}
+    "/MP"
+    "/Wall"
+    "/WX"
+    "/EHsc"
+
+    #############################
+    # Ignored compiler warnings #
+    #############################
+    "/wd4061" # Enumerator 'identifier' in switch of enum 'enumeration' is not explicitly handled by a case label
+    "/wd4265" # 'Class' : class has virtual functions, but destructor is not virtual
+    "/wd4350" # Behavior change: 'member1' called instead of 'member2'
+    "/wd4355" # 'This' : used in base member initializer list
+    "/wd4365" # 'Action': conversion from 'type_1' to 'type_2', signed/unsigned mismatch
+    "/wd4371" # Layout of class may have changed from a previous version of the compiler due to better packing of member 'member'
+    "/wd4503" # 'Identifier': decorated name length exceeded, name was truncated
+    "/wd4510" # 'Class': default constructor could not be generated
+    "/wd4512" # 'Class': assignment operator could not be generated
+    "/wd4514" # 'Function' : unreferenced inline function has been removed
+    "/wd4571" # Informational: catch(...) semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught
+    "/wd4610" # 'Class': can never be instantiated - user defined constructor required
+    "/wd4625" # 'Derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted
+    "/wd4626" # 'Derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted
+    "/wd4628" # digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char'
+    "/wd4640" # 'Instance': construction of local static object is not thread-safe
+    "/wd4710" # 'Function': function not inlined
+    "/wd4711" # Function 'function' selected for inline expansion
+    "/wd4723" # potential divide by 0
+    "/wd4738" # Storing 32-bit float result in memory, possible loss of performance
+    "/wd4820" # 'Bytes': bytes padding added after construct 'member_name'
+    "/wd4996" # Your code uses a function, class member, variable, or typedef that's marked deprecated
+    "/wd5045" # Compiler will insert Spectre mitigation for memory load if /Qspectre switch specified
+    "/wd5204" # 'class' : class has virtual functions, but destructor is not virtual
+  )
+
+  if(MSVC_VERSION VERSION_GREATER 1800)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "/wd4464" # Relative include path contains '..'
+      "/wd4548" # Expression before comma has no effect; expected expression with side-effect
+      "/wd4623" # 'Derived class': default constructor could not be generated because a base class default constructor is inaccessible
+      "/wd4868" # Compiler may not enforce left-to-right evaluation order in braced initializer list
+      "/wd5026" # Move constructor was implicitly defined as deleted
+      "/wd5027" # Move assignment operator was implicitly defined as deleted
+      "/wd5262" # implicit fall-through
+      "/wd5264" # 'variable-name': 'const' variable is not used
+    )
+  endif()
+
+  if(MSVC_VERSION VERSION_GREATER 1900)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "/wd4987" # nonstandard extension used: 'throw (...)'
+      "/wd4774" # 'printf_s' : format string expected in argument 1 is not a string literal
+      "/wd5039" # "pointer or reference to potentially throwing function passed to extern C function under -EHc. Undefined behavior may occur if this function throws an exception."
+    )
+  endif()
+
+  if(NOT LINK_BUILD_ASIO)
+    set(build_flags_COMMON_LIST
+      ${build_flags_COMMON_LIST}
+      "/wd4917" # 'Symbol': a GUID can only be associated with a class, interface or namespace
+                # This compiler warning is generated by Microsoft's own ocidl.h, which is
+                # used when building the WASAPI driver.
+    )
+  endif()
+endif()
+
+#  ____       _      __ _
+# / ___|  ___| |_   / _| | __ _  __ _ ___
+# \___ \ / _ \ __| | |_| |/ _` |/ _` / __|
+#  ___) |  __/ |_  |  _| | (_| | (_| \__ \
+# |____/ \___|\__| |_| |_|\__,_|\__, |___/
+#                               |___/
+
+# Translate lists to strings
+string(REPLACE ";" " " build_flags_COMMON "${build_flags_COMMON_LIST}")
+string(REPLACE ";" " " build_flags_DEBUG "${build_flags_DEBUG_LIST}")
+string(REPLACE ";" " " build_flags_RELEASE "${build_flags_RELEASE_LIST}")
+
+# Set flags for different build types
+set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${build_flags_COMMON}")
+set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} ${build_flags_DEBUG}")
+set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} ${build_flags_RELEASE}")

linkpython_extern-1.2.1/modules/link/extensions/abl_link/src/abl_link.cpp

@@ -0,0 +1,214 @@
+/* Copyright 2021, Ableton AG, Berlin. All rights reserved.
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 2 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ *  If you would like to incorporate Link into a proprietary software application,
+ *  please contact <link-devs@ableton.com>.
+ */
+
+#include <abl_link.h>
+#include <ableton/Link.hpp>
+
+extern "C"
+{
+  abl_link abl_link_create(double bpm)
+  {
+    return abl_link{reinterpret_cast<void *>(new ableton::Link(bpm))};
+  }
+
+  void abl_link_destroy(abl_link link)
+  {
+    delete reinterpret_cast<ableton::Link *>(link.impl);
+  }
+
+  bool abl_link_is_enabled(abl_link link)
+  {
+    return reinterpret_cast<ableton::Link *>(link.impl)->isEnabled();
+  }
+
+  void abl_link_enable(abl_link link, bool enabled)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->enable(enabled);
+  }
+
+  bool abl_link_is_start_stop_sync_enabled(abl_link link)
+  {
+    return reinterpret_cast<ableton::Link *>(link.impl)->isStartStopSyncEnabled();
+  }
+
+  void abl_link_enable_start_stop_sync(abl_link link, bool enabled)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->enableStartStopSync(enabled);
+  }
+
+  uint64_t abl_link_num_peers(abl_link link)
+  {
+    return reinterpret_cast<ableton::Link *>(link.impl)->numPeers();
+  }
+
+  void abl_link_set_num_peers_callback(
+    abl_link link, abl_link_num_peers_callback callback, void *context)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->setNumPeersCallback(
+      [callback, context](std::size_t numPeers)
+      { (*callback)(static_cast<uint64_t>(numPeers), context); });
+  }
+
+  void abl_link_set_tempo_callback(
+    abl_link link, abl_link_tempo_callback callback, void *context)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->setTempoCallback(
+      [callback, context](double tempo) { (*callback)(tempo, context); });
+  }
+
+  void abl_link_set_start_stop_callback(
+    abl_link link, abl_link_start_stop_callback callback, void *context)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->setStartStopCallback(
+      [callback, context](bool isPlaying) { (*callback)(isPlaying, context); });
+  }
+
+  int64_t abl_link_clock_micros(abl_link link)
+  {
+    return reinterpret_cast<ableton::Link *>(link.impl)->clock().micros().count();
+  }
+
+  abl_link_session_state abl_link_create_session_state(void)
+  {
+    return abl_link_session_state{reinterpret_cast<void *>(
+      new ableton::Link::SessionState{ableton::link::ApiState{}, {}})};
+  }
+
+  void abl_link_destroy_session_state(abl_link_session_state session_state)
+  {
+    delete reinterpret_cast<ableton::Link::SessionState *>(session_state.impl);
+  }
+
+  void abl_link_capture_app_session_state(
+    abl_link link, abl_link_session_state session_state)
+  {
+    *reinterpret_cast<ableton::Link::SessionState *>(session_state.impl) =
+      reinterpret_cast<ableton::Link *>(link.impl)->captureAppSessionState();
+  }
+
+  void abl_link_commit_app_session_state(
+    abl_link link, abl_link_session_state session_state)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->commitAppSessionState(
+      *reinterpret_cast<ableton::Link::SessionState *>(session_state.impl));
+  }
+
+  void abl_link_capture_audio_session_state(
+    abl_link link, abl_link_session_state session_state)
+  {
+    *reinterpret_cast<ableton::Link::SessionState *>(session_state.impl) =
+      reinterpret_cast<ableton::Link *>(link.impl)->captureAudioSessionState();
+  }
+
+  void abl_link_commit_audio_session_state(
+    abl_link link, abl_link_session_state session_state)
+  {
+    reinterpret_cast<ableton::Link *>(link.impl)->commitAudioSessionState(
+      *reinterpret_cast<ableton::Link::SessionState *>(session_state.impl));
+  }
+
+  double abl_link_tempo(abl_link_session_state session_state)
+  {
+    return reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)->tempo();
+  }
+
+  void abl_link_set_tempo(
+    abl_link_session_state session_state, double bpm, int64_t at_time)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->setTempo(bpm, std::chrono::microseconds{at_time});
+  }
+
+  double abl_link_beat_at_time(
+    abl_link_session_state session_state, int64_t time, double quantum)
+  {
+    auto micros = std::chrono::microseconds{time};
+    return reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->beatAtTime(micros, quantum);
+  }
+
+  double abl_link_phase_at_time(
+    abl_link_session_state session_state, int64_t time, double quantum)
+  {
+    return reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->phaseAtTime(std::chrono::microseconds{time}, quantum);
+  }
+
+  int64_t abl_link_time_at_beat(
+    abl_link_session_state session_state, double beat, double quantum)
+  {
+    return reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->timeAtBeat(beat, quantum)
+      .count();
+  }
+
+  void abl_link_request_beat_at_time(
+    abl_link_session_state session_state, double beat, int64_t time, double quantum)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->requestBeatAtTime(beat, std::chrono::microseconds{time}, quantum);
+  }
+
+  void abl_link_force_beat_at_time(
+    abl_link_session_state session_state, double beat, uint64_t time, double quantum)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->forceBeatAtTime(beat, std::chrono::microseconds{time}, quantum);
+  }
+
+  void abl_link_set_is_playing(
+    abl_link_session_state session_state, bool is_playing, uint64_t time)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->setIsPlaying(is_playing, std::chrono::microseconds(time));
+  }
+
+  bool abl_link_is_playing(abl_link_session_state session_state)
+  {
+    return reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->isPlaying();
+  }
+
+  uint64_t abl_link_time_for_is_playing(abl_link_session_state session_state)
+  {
+    return static_cast<uint64_t>(
+      reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+        ->timeForIsPlaying()
+        .count());
+  }
+
+  void abl_link_request_beat_at_start_playing_time(
+    abl_link_session_state session_state, double beat, double quantum)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->requestBeatAtStartPlayingTime(beat, quantum);
+  }
+
+  void abl_link_set_is_playing_and_request_beat_at_time(
+    abl_link_session_state session_state,
+    bool is_playing,
+    uint64_t time,
+    double beat,
+    double quantum)
+  {
+    reinterpret_cast<ableton::Link::SessionState *>(session_state.impl)
+      ->setIsPlayingAndRequestBeatAtTime(
+        is_playing, std::chrono::microseconds{time}, beat, quantum);
+  }
+}