Metadata-Version: 2.1
Name: FL_Studio_API_Stubs
Version: 13.0
Summary: Module and function definitions and documentation for the FL Studio Python API
Home-page: https://github.com/MiguelGuthridge/FL-Midi-Stub
Author: Miguel Guthridge
Author-email: hdsq@outlook.com.au
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/MiguelGuthridge/FL-Midi-Stub/issues
Keywords: fl-studio,midi,api,documentation,stubs,fl,studio,daw
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# FL Studio MIDI Python API

This project contains simple stub functions to provide intellisense while
working on scripts for FL Studio's MIDI Python API.

Currently, it only provides function definitions and docstrings, but these
functions don't do anything. It is NOT a complete testing framework, and it
cannot guarantee your script will work correctly. However, it may help you to
resolve issues with incorrect function calls when interacting with the API.

# Important Note

Currently, these stubs are incomplete. Contributions are encouraged, although
I'd prefer for people to stick to the style of the existing documentation.

# Differences to Official Implementation

A small number of tweaks have been made to these stubs in order to ease code 
writing. These shouldn't have any functional impact on the behaviour of the API
compared to the implied behaviour from the stubs, but should help clarify some
properties of certain functions.

 * Functions whose returns are boolean by nature are listed as returning a 
 `bool` type, even though the implementation returns the integers `0` and `1`.
 This change should help to describe the context in which the functions should 
 be called when writing scripts, which in a language like Python is far more 
 important than the actual implementation of the functions.

# Installation

To avoid module conflicts with other Python projects, it is recommended that 
you install this script in a virtual environment by following 
[these instructions](https://docs.python.org/3/library/venv.html) in the 
official Python documentation.

After activating the environment in your editor, you can install the stub 
modules by running the command `pip3 install [MODULE-NAME]`.

NOTE: Not yet published


