Commit Graph

1555 Commits

Author SHA1 Message Date
Mirko Galimberti a4c48b1fbb
Add `2.x.x` to `3.x.x` migration guide (#8772) 2024-07-06 10:25:12 +02:00
pedroarduini b39580041e
Move `kivy.core.audio` to `kivy.core.audio_output`, reserve `kivy.core.audio_input` for future use #8579 (#8721)
* Renamed kivy.core.audio to kivy.core.audio_output

* Corrected the documentation comment in init.py

* Refactored kivy.core.audio calls in C files

* Reserved audio_input module

* Rename kivy_options from audio to audio_output and changing core_register_libs audio_output call + Change test function calls

* Cleanup of unrelated files

* Fix broken references

---------

Co-authored-by: vikingmidia <vikingmidia@gmail.com>
Co-authored-by: Mirko Galimberti <me@mirkogalimberti.com>
2024-07-01 18:27:23 +02:00
Konstantin Baikov bde597c574
Sphinx/docs: Avoid usage of deprecated `style` keyword (#8709)
Fixes: 8230

Style keyword is deprecated in sphinx 7.x
2024-05-04 10:41:22 +02:00
Mirko Galimberti 413533b216
Remove unused `sphinxcontrib-*diag` dependencies (and `funcparserlib`) (#8711) 2024-05-01 14:35:13 +02:00
Mirko Galimberti ccc61047e3
Use PyPA `build` package to perform `bdist` and `kivy-examples`, to take advantage of build isolation (#8690)
* Use python build package to perform bdist and kivy-examples builds to keep build isolation

* Do not use setup.py in Makefile

* Install coveralls where needed
2024-04-21 11:45:53 +02:00
lee-rice 3846952165 Updated broken links in documentation. 2024-04-02 12:09:17 +05:30
Mirko Galimberti a6f69d595b
Remove the deprecated `pygame` window provider (#8320) 2024-03-31 11:15:23 +02:00
Mirko Galimberti 8cc881c1ae
Introduce `ANGLE` GL provider on Apple platforms on top of SDL2 window backend (#8534)
* Disable OpenGL for SDL2 window backend and introduce ANGLE egl_backend

* Allow to build with legacy OpenGL provided from Apple and add docs

* Apply code review suggestions
2024-03-13 18:16:20 +01:00
chemelnucfin 28ca16fb34
New <Getting started> link for Apple Developer in Docs (#8642)
https://help.apple.com/developer-account/

has moved to 

https://developer.apple.com/help/account/
2024-03-10 10:25:14 +01:00
Stephen Littman 2f6b8cad4f
Update python-for-android link in packaging-android.rst (#8638)
Added the correct link to avoid 404 error.
2024-03-02 09:07:35 +01:00
Mirko Galimberti ff80a2213a
Remove Windows 32-bit support (tests, builds, docs) (#8617)
* Remove Windows 32-bit support (tests, builds)

* Remove fancy rules for dependencies and remove docs regarding fancy rules
2024-02-18 10:22:35 +01:00
Nidhi Nishad 15f1db0394
Remove Python `3.7` from supported matrix and set minimum supported version to `3.8` (#8587) 2024-01-31 21:05:00 +01:00
Mirko Galimberti 5826696dc6
Update CHANGELOG for `2.3.0` (#8550) 2024-01-05 10:35:18 +01:00
Mirko Galimberti decde20ea5
Happy new year! Updated copyright year to 2024 (#8542) 2024-01-01 12:02:34 +01:00
Julian 7b84bf6151
Make doc structure consistent and up-to-date (#8514)
* Make doc structure consistent and up-to-date

This is part of an effort to make the Kivy sibling projects' documentation
structure consistent and up-to-date.

CHECKLIST

* CONTRIBUTING.md
   [X] If repo takes user contributions, is present
   [X] In root dir (not .github dir)
   [X] Explains relationship to Kivy, if unclear.
   [NA] Refers to kivy/kivy Contribution Guidelines.

* LICENSE
   [X] If repo takes user contributions, is present.
   [X] Acknowledges the range of years to 2023.
   [X] Acknowledges Kivy Team and other contributors
   [X] Mentions it is an MIT License.

* CODE_OF_CONDUCT.md
   [X] If repo takes user contributions or hosts discussions, is present.
   [NA] Refers to kivy/kivy CODE_OF_CONDUCT.md

* CONTACT.md
   [NA] Refers to kivy/kivy CONTACT.md

* FAQ.md
   [X] If repo is big enough for RST documentation, is present.

* README:
   [X] Is a Markdown file.
   [X] Describes the project.
   [X] Describes its place in the Kivy sibling projects.
   [X] If Documentation exists, mention it.
   [X] If CONTRIBUTING exists, mentions it.
   [X] If LICENSE exists, mentions it.
   [X] If CODE_OF_CONDUCT exists, mentions it.
   [X] Mentions kivy/kivy CONTACT.md
   [NA] Uses Python syntax colouring for embedded Python code.
   [] Uses badges to display current status, including:
        [X] Backers
		[X] Sponsors
		[X] GitHub contributors
		[X] Contributor Covenant
		[X] PyPI Version
		[X] PyPI Python Version
		[X] Build/Test status

   [X] Displays all contributors to the repo.
   [X] Displays backers
   [X] Displays top sponsors.

* RST documentation, if present
   [X] Describes the project.
   [???] Describes its place in the Kivy sibling projects.
   [X] Mentions (Kivy/Kivy) Contact Us link.
   [X] Mentions LICENSE.
   [X] Mentions CONTRIBUTING
   [X] Mentions FAQ
   [X] conf.py mentioned Kivy Team and other contributors
		- copyright, latex_documents, man_pages, texinfo documents

* WORKFLOWS
   [X] NO_RESPONSE.yml is present if the repo has awaiting_reply tag.
   [X] NO_RESPONSE uses latest script versions.
   [X] NO_RESPONSE runs every day, and skips if forked.
   [X] SUPPORT.yml is present if the repo has a `support` tag.
   [X] SUPPORT.yml refers to repo's CONTACT.md

* setup.py/cfg, if present and on PyPI
   [X] Supplies description to PyPI
   [X] Supplies Python versions to PyPI
   [X] Supplies Documentation, if any, to PyPI

* Review comment
2023-12-17 10:42:49 +01:00
Mirko Galimberti 74ed8e0785
Restrict the Pillow version to `>=9.5.0,<11` (#8505)
* Restrict the Pillow version to pillow>=9.5.0,<11

* Use --prefer-binary (will document it)

* Use --only-binary Pillow

* Document --only-binary for Windows 32 bit
2023-12-12 18:50:01 +01:00
Julian 9c8528df2e
Update Contribution Guidelines, add `FAQ`, `CONTACT` and `CONTRIBUTING` as separate documents, fix links (#8448)
* Add FAQ as separate document. Removed from RST docs.

Future work:

* Add references to contact us.

* Substantial Rewrite of Contributing Guidelines

* Updated with review comments.

* Avoid duplicating contribution instructions

Reference the contribution guidelines online rather than repeating them.
Make language more consistent with other sources.

* Reshuffle contents based on review comments.

* Move contributing to root dir, populate it with contents of contribute.rst and contribute-unittest.rst
* Delete contribute.rst and contribute-unittest.rst
* Delete the defunct Google Summers of Code
*Add CONTACT.md, populating it from CONTACT.rst.
* Reference new CONTACT.md from Index.
* Fix broken links, ToC.
* Fix another link.
* Bring in changes to README and setup.py from #8450.
* Include OpenGL reference
* Mention all the sponsors.

* Wrong README file was modified - try again

* Updated a bunch of http -> https

Not every single instance, but made a major dent.
Only instances where https worked (inclem.net, I am looking at you.)

* Update CODE_OF_CONDUCT.md to be the most modern version

* Update with review comments

* Correct link

* Add stubs for GitHub-hosted pages

* Fix links

RST broken by line feed.
Inline link.
2023-11-23 18:31:19 +01:00
Julian 1ec93cdab8
Correct documentation of schedule_interval (#8464)
Fixes #6739

Also, removed decimal point after 30 - not required in Python 3.
2023-11-16 18:19:12 +01:00
Julian 6ae4fc2923
Edit Contact Us page in docs (#8442)
In accordance with discussion #8424.
2023-11-12 16:16:51 +01:00
Julian 922cda230f
Fix `SyntaxWarnings` during doc generation (#8440)
* Copy edit comment
* Factor out common regular expression patterns to make intent clearer.
* Quote patterns with r"" to fix SyntaxWarning.
* Simplify "if not X return False else return True" to "return X"
* Lose unneeded parentheses giving IDE style warning.
2023-11-09 15:55:06 +01:00
Mirko Galimberti 533a95fafa
Add `balenalib/raspberrypi3-debian-python:3.11-bookworm` to rpi builds for newer RPi OS (#8428)
* Add python:3.11-bookworm to rpi builds

* Update patchelf to 0.18.0

* Do not unpack directly to /

* Use the proper manylinux target platform for bookworm

* Test back 0.17.2

* Updated docs to reflect bookworm support addition
2023-11-05 09:30:48 +01:00
Uchenna Wealth 1d324beb0a
Docs: Fixes spelling errors and typos (#8402)
* fixed grammar

* Corrected spelling of showcasing
2023-10-13 18:31:57 +02:00
Uchenna Wealth c777670a05
Docs: Fix grammar (#8387) 2023-10-04 18:38:14 +02:00
jfishzon d69693256d
Fix linux dependencies build instructions (#8324)
* fix linux venv & build_kivy_deps.sh creation in docs as per issue 8305

change from:
python -m virtualenv kivy_venv
to:
python -m venv kivy_venv

change from:
curl -O https://raw.githubusercontent.com/kivy/kivy/master/tools/build_linux_dependencies.sh -o build_kivy_deps.sh

to:
curl https://raw.githubusercontent.com/kivy/kivy/master/tools/build_linux_dependencies.sh -o build_kivy_deps.sh

* Update installation.rst

change from:
https://virtualenv.pypa.io/en/latest/
to:
https://docs.python.org/3/library/venv.html
2023-07-23 18:23:02 +02:00
Mirko Galimberti 84f9d77665 macOS dependencies: Build libpng16 for freetype, so can render colored emoji 2023-07-15 16:23:53 +05:30
Julian 22c9604a67
Copy-edit to layouts.rst (#8303)
Trivial copy-edits to text,
2023-07-02 09:55:34 +02:00
Mirko Galimberti 668b0e76e6
Add CHANGELOG for 2.2.1 (#8287) (#8289) 2023-06-18 09:43:44 +02:00
Mirko Galimberti 9d7df3f105
Ensures that jQuery is always installed (on newer sphinx versions is not the default) (#8251) 2023-05-20 16:22:47 +02:00
Mirko Galimberti fe5e16cf1a
Update changelog for 2.2.0 (#8245) 2023-05-20 08:59:15 +02:00
Mirko Galimberti 879b0c640b
Docs review for RPi installation and build instructions (#8234) 2023-05-10 20:39:10 +02:00
Mirko Galimberti 0fc8c678eb
Migrate from `autotools` to `cmake` for SDL2 linux dependencies (#8203)
* Migrate from autotools to cmake for SDL2 linux dependencies

* Update Linux install docs
2023-04-15 14:59:50 +02:00
Mirko Galimberti 6161417835
Update Copyright and LICENSE dates (#8175) 2023-03-18 11:51:47 +01:00
Akshay Arora 6a29251604
Add libxext-dev as a requirement for ubuntu build. 2023-03-09 14:38:06 +05:30
Mirko Galimberti ff7960be84 Docs: Update the Ubuntu prereq to build Kivy and its dependencies 2023-03-06 20:33:14 +01:00
Dexer f222bfb8a6
`BoxShadow`: Accept values for vertical and horizontal `spread_radius` (#8138)
* Accept values for vertical and horizontal `spread_radius`

* fix image

* update docs
2023-02-22 21:04:11 +01:00
Dexer bc766c64b5
Improve docs about `BoxShadow` behavior and usage. (#8139)
* update BoxShadow docs

* update images
2023-02-19 05:51:18 +01:00
Akshay Arora 2f1d20dd50
Merge pull request #8096 from misl6/feat/build-dependencies
Introduce build script for SDL dependencies and `KIVY_DEPS_ROOT`
2023-02-18 23:54:46 +05:30
Dexer 0bd9901d6a
`BoxShadow`: Add `inset` feature (#8132)
* add inset feature

* update docs

* Refactor shadow calculation
2023-02-18 15:50:33 +01:00
Mirko Galimberti cad29c6331 Update docs 2023-02-04 12:07:36 +01:00
Mirko Galimberti f84f8c9478 Update docs 2023-01-07 17:26:49 +01:00
Mirko Galimberti 88905bbc17
Add support sphinx 6.0.0 (#8088) 2023-01-01 10:30:12 +01:00
Dexer a7c6688027
Add `BoxShadow` graphic instruction (#8056)
* add BoxShadow instruction

* update docs, fix shader for some devices

* assign texture only on initialization

* check initial attributes

* change to tuple

* refactoring

* update docs

* add unit tests
2022-12-18 10:09:16 +01:00
Peter Tripp 4b5b7a1021
Update installation-osx.rst (#8041)
Remove extraneous backticks.
2022-10-26 21:16:20 +02:00
Gabriel Pettier bfd90c4d6f
Link to buildozer installation instructions instead of duplicating them (#8039) 2022-10-23 10:20:00 +02:00
Tomasz CEDRO a4ae5e3d01
doc: Initial remarks on *BSD compatibility. (#8032)
Signed-off-by: Tomasz 'CeDeROM' CEDRO <tomek@cedro.info>

Signed-off-by: Tomasz 'CeDeROM' CEDRO <tomek@cedro.info>
2022-10-22 19:34:36 +02:00
Tom Dudley 0455d2008b
Fix backticks typo in pong tutorial (#8034) 2022-10-16 09:19:30 +02:00
Romain Heller dd4ae807e1
Typo : missing coma in the doc (#8026) 2022-10-05 20:15:02 +02:00
Paul Cochrane b873d82e9a
Use consistent source code notes in pong tutorial (#7929)
* Highlight parenthetical expression with hyphens

The expression "and source code files for each step" was only partially
in a parenthesis: there wasn't a closing comma after the word "step" to
highlight that the expression was extra information in the sentence.
This commit changes the punctuation around the parenthetical expression
to use hyphpens to make it stand out more and adds the missing closing
punctuation.

* Add missing full stop at end of note sentence

Since this note is a sentence, it probably should have a full-stop at
the end.

* Mention source location consistently in pong tutorial

The two notes mentioning the source code location were formatted
differently.  To be consistent, they both now use the same formatting.
2022-10-02 20:49:15 +02:00
Paul Cochrane ce0bf8c7dc
Purge trailing whitespace in docs source files (#7930)
Trailing whitespace is forbidden in source code for this project
(implemented as part of the PEP8 checks), however the documentation
source files contained trailing whitespace.  It seemed appropriate to
remove trailing whitespace in the documentation source files as well.
2022-10-02 20:47:05 +02:00
RobertF fd12906efa
Android Lifecycle convergence (#7989)
* Android pause on back key/gesture

Replaces previous divergence between Android and Kivy state machines.

* Android exit app when on_pause returns False

Corrects previous behavior where Kivy app stops, but Android does not stop.

* stop() - set Android state

Let Kivy app state follow Android state.

* Add pause()

* typo

* Disambiguate

It is unclear it "default case" refers to existence of a return statement, or existence of a method.

* add versionadded

* pep8

* pep8

* pep8

* Update kivy/app.py

Co-authored-by: Mirko Galimberti <me@mirkogalimberti.com>

* Update app.py

Co-authored-by: Mirko Galimberti <me@mirkogalimberti.com>
2022-10-01 11:27:05 +02:00