Modernize repo and make sure it works with ST4

.github/workflows/tests.yaml

@@ -0,0 +1,21 @@
+name: tests
+
+on: [push, pull_request]
+
+jobs:
+  run-tests:
+    strategy:
+      fail-fast: false
+      matrix:
+        st-version: [3, 4]
+        os: ["ubuntu-latest", "macOS-latest", "windows-latest"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: SublimeText/UnitTesting/actions/setup@v1
+        with:
+          sublime-text-version: ${{ matrix.st-version }}
+      - uses: SublimeText/UnitTesting/actions/run-tests@v1
+        with:
+          coverage: true
+      - uses: codecov/codecov-action@v4

.gitignore

@@ -1,13 +1,11 @@
-*.hgignore
-*.hgtags
-*.pyc
-*.cache
-*.sublime-project
-
-_*.txt
-sample-grammar.js
-Manifest
-MANIFEST
-
-dist/
-build/
+*.pyc
+*.cache
+*.sublime-project
+
+_*.txt
+sample-grammar.js
+Manifest
+MANIFEST
+
+dist/
+build/

.python-version

@@ -0,0 +1 @@
+3.8

Default.sublime-commands

@@ -0,0 +1,10 @@
+[
+	{
+		"caption": "Preferences: Sublime Modelines Settings",
+		"command": "edit_settings",
+		"args": {
+			"base_file": "${packages}/Modelines/Sublime Modelines.sublime-settings",
+			"default": "/* See the left pane for the list of settings and valid values. */\n{\n\t$0\n}\n",
+		}
+	}
+]

LICENSE.TXT → License.txt

@@ -1,19 +1,20 @@
-Copyright (c) 2010 Guillermo López-Anglada
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+Copyright (c) 2010 Guillermo López-Anglada
+          (c) 2026 Frizlab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

Main.sublime-menu

@@ -0,0 +1,22 @@
+[{
+	"id": "preferences",
+	"children": [
+		{
+			"caption": "Package Settings",
+			"mnemonic": "P",
+			"id": "package-settings",
+			"children": [
+				{
+					"caption": "Sublime Modelines",
+					"id": "sublime-modelines-settings",
+					"command": "edit_settings",
+					"args": {
+						"base_file": "${packages}/Modelines/Sublime Modelines.sublime-settings",
+						"default": "/* See the left pane for the list of settings and valid values. */\n{\n\t$0\n}\n",
+					}
+				}
+			]
+		}
+	]
+}
+]

Readme.md

@@ -0,0 +1,90 @@
+# Sublime Modelines
+
+Set settings local to a single buffer.  
+A more granular approach to settings than the per file type `.sublime-settings` files.
+
+Inspired by Vim’s modelines feature.
+
+
+## Getting Started
+
+### Recommended Installation
+
+Use Package Control and install `SublimeModelines`.
+
+### Manual Installation
+
+Download and install [SublimeModelines](<https://github.com/SublimeText/Modelines>).
+
+See the [installation instructions](<https://docs.sublimetext.io/guide/extensibility/packages.html#installing-packages>) for `.sublime-package`s.
+
+
+## Side Effects
+
+Buffers will be scanned `.on_load()` for modelines and settings will be set accordingly.
+Settings will apply **only** to the buffer declaring them.
+
+**Note**: Application- and window-level options declared in modelines are obviously global.
+
+
+## Usage
+
+### How to Declare Modelines
+
+Modelines must be declared at the top or the bottom of source code files with one of the following syntaxes:
+
+```text
+# sublime: option_name value
+# sublime: option_name value; another_option value; third_option value
+```
+
+**Note**:
+`#` is the default comment character.
+Use the corresponding single-line comment character for your language.
+When there isn't a concept of comment, the default comment character must be used.
+
+### How to Define Comment Characters in Sublime Text
+
+SublimeModelines finds the appropriate single-line comment character by inspecting the `shellVariables` preference,
+ which must be defined in a `.tmPreferences` file.
+To see an example of how this is done, open `Packages/Python/Miscellaneous.tmPreferences`.
+
+Many packages giving support for programming languages already include this,
+ but you might need to create a `.tmPreferences` file for the language you're working with
+ if you want SublimeModelines to be available.
+
+
+## Caveats
+
+If the option’s value contains a semicolon (`;`), make sure it isn't followed by a blank space.
+Otherwise it will be interpreted as a multi-option separator.
+
+
+## Non-Standard Options
+
+For some common cases, no directly settable option exists (for example, a setting to specify a syntax).
+For such cases, Sublime Modelines provides non-standard accessors as a stop-gap solution.
+
+```text
+# sublime: x_syntax Foo
+or
+# sublime: x_syntax Packages/Foo/Foo.tmLanguage
+```
+
+Sets the syntax to the specified `.tmLanguage` file.
+
+
+# Contributors
+
+[Guillermo López-Anglada](<https://github.com/guillermooo>):
+- Implemented the first version of this package (for Sublime Text 2).
+
+Kay-Uwe (Kiwi) Lorenz <kiwi@franka.dyndns.org> (<http://quelltexter.org>):
+- Added VIM compatibility;
+- Smart syntax matching;
+- Modelines also parsed on save;
+- Settings are erased from view, if removed from modeline.
+
+[Frizlab](<https://github.com/Frizlab>):
+- Removed VIM compatibility (use `VimModelines` if you need that);
+- Modernize/clean the project, and make sure it works with SublimeText 4.

Sublime Modelines.sublime-settings

@@ -0,0 +1,17 @@
+{
+	/* Which types of modelines format are allowed. */
+	"formats": [
+		/* `# sublime: key val(; key2 val2)*`
+		 * Usually works well unless putting the modeline in a `/*`-style comment.
+		 * Can also not work when the syntax of the file is not known, because we check the line to begin with the comment char before parsing it. */
+		"classic",
+		/* `#~~ sublime: key val(; key2 val2)* ~~`
+		 * For this format the comment char does not matter.
+		 * All that matter is there is a `~~` token before the 9th char of the line (and another one anywhere in the line). */
+		//"delimited",
+	],
+
+	/* These two settings determine how far the search for a modeline should be done. */
+	"number_of_lines_to_check_from_beginning": 5,
+	"number_of_lines_to_check_from_end": 5,
+}

app/__init__.py

@@ -0,0 +1,9 @@
+from . import logger
+from . import settings
+from . import sublime_modelines
+
+__all__ = [
+	"logger",
+	"settings",
+	"sublime_modelines",
+]

app/logger.py

@@ -0,0 +1,38 @@
+import sys
+
+
+
+class Logger:
+	"""A simple logger."""
+
+	# Default config for the logger.
+	log_to_tmp = False
+	enable_debug_log = False
+
+	def __new__(cls, *args, **kwargs):
+		raise RuntimeError("Logger is static and thus cannot be instantiated.")
+
+	@staticmethod
+	def debug(s, *args):
+		if not Logger.enable_debug_log:
+			return
+		Logger._log(Logger._format("", s, *args))
+
+	@staticmethod
+	def info(s, *args):
+		Logger._log(Logger._format("", s, *args))
+
+	@staticmethod
+	def warning(s, *args):
+		Logger._log(Logger._format("*** ", s, *args))
+
+	@staticmethod
+	def _format(prefix, s, *args):
+		return "[Sublime Modelines] " + prefix + (s % args) + "\n"
+
+	@staticmethod
+	def _log(str):
+		if Logger.log_to_tmp:
+			with open("/tmp/sublime_modelines_debug.log", "a") as myfile:
+				myfile.write(str)
+		sys.stderr.write(str)