icarus-python3 1.0.0__tar.gz

icarus_python3-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carlo Gatti
+
+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.

icarus_python3-1.0.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: icarus-python3
+Version: 1.0.0
+Summary: IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder
+Author-email: Carlo Gatti <carlo.gatti@me.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/64rl0/IcarusPython3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: build
+Requires-Dist: twine
+Requires-Dist: wheel
+Dynamic: license-file
+
+# IcarusPython3
+
+IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder.
+
+## Package documentation
+[Read the Docs](file:///Users/carlogtt/Library/CloudStorage/Dropbox/SDE/Python/CarloCodes/_Projects/IcarusPython3/docs/html/index.html)

icarus_python3-1.0.0/README.md

@@ -0,0 +1,6 @@
+# IcarusPython3
+
+IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder.
+
+## Package documentation
+[Read the Docs](file:///Users/carlogtt/Library/CloudStorage/Dropbox/SDE/Python/CarloCodes/_Projects/IcarusPython3/docs/html/index.html)

icarus_python3-1.0.0/pyproject.toml

@@ -0,0 +1,177 @@
+[project]
+name = "icarus-python3"
+description = "IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder"
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "Carlo Gatti", email = "carlo.gatti@me.com"}
+]
+requires-python = ">= 3.9"
+dynamic = ["version"]
+dependencies = [
+    "setuptools",
+    "build",
+    "twine",
+    "wheel",
+]
+
+[project.urls]
+Homepage = "https://github.com/64rl0/IcarusPython3"
+
+[project.optional-dependencies]
+# development = []
+
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.package-data]
+"*" = ["**/*"]
+
+
+[tool.black]
+# black docs
+# https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html
+
+# How many characters per line to allow. The default is 88.
+line-length = 100
+
+# Black normalize ' to ". Setting to 1 so that strings are left
+# unchanged instead.
+skip-string-normalization = 1
+
+# Enable potentially disruptive style changes that may be added to
+# Black’s main functionality in the next major release.
+preview = true
+unstable = true
+
+
+[tool.isort]
+# isort docs
+# https://pycqa.github.io/isort/docs/configuration/options.html
+
+# The max length of an import line (used for wrapping long imports).
+line_length = 100
+
+# Use parentheses for line continuation on length limit instead of
+# backslashes. NOTE: This is separate from wrap modes, and only affects
+# how individual lines that are too long get continued, not sections of
+# multiple imports.
+use_parentheses = true
+
+# What sections isort should display imports for and in what order.
+sections = ['FUTURE', 'STDLIB', 'THIRDPARTY', 'MYLIB', 'FIRSTPARTY', 'LOCALFOLDER']
+
+# Multi line output (0-grid, 1-vertical, 2-hanging, 3-vert-hanging,
+# 4-vert-grid, 5-vert-grid-grouped, 6-deprecated-alias-for-5, 7-noqa,
+# 8-vertical-hanging-indent-bracket,
+# 9-vertical-prefix-from-module-import,
+# 10-hanging-indent-with-parentheses).
+multi_line_output = 3
+
+# A mapping of import sections to import heading comments that should
+# show above them.
+import_headings = {future="Special Imports", stdlib="Standard Library Imports", thirdparty="Third Party Library Imports", mylib ="My Library Imports", firstparty="Local Application Imports", localfolder="Local Folder (Relative) Imports"}
+
+# Inserts a blank line before a comment following an import.
+ensure_newline_before_comments = true
+
+# Includes a trailing comma on multi line imports that include
+# parentheses.
+include_trailing_comma = true
+
+# Split imports list followed by a trailing comma into
+# VERTICAL_HANGING_INDENT mode. This follows Black style magic comma.
+split_on_trailing_comma = true
+
+# Causes all non-indented imports to float to the top of the file
+#having its imports sorted (immediately below the top of file comment).
+# This can be an excellent shortcut for collecting imports every once
+#in a while when you place them in the middle of a file to avoid context
+# switching.
+float_to_top = true
+
+# If enabled, isort will apply import headings to indended imports the
+# same way it does unindented ones.
+indented_import_headings = false
+
+# Force all imports to be sorted alphabetically within a section.
+#force_alphabetical_sort_within_sections = true
+
+# If enabled, isort will strip comments that exist within import lines.
+#ignore_comments = true
+
+# Add an explicitly defined source path (modules within src paths have
+#their imports automatically categorized as first_party). Glob expansion
+# (* and **) is supported for this option.
+src_paths = ['src/*']
+
+# Force isort to recognize a module as part of Python's internal future
+# compatibility libraries. WARNING: this overrides the behavior of
+# future handling and therefore can result in code that can't execute.
+known_future_library = ['__future__']
+
+# Extra modules to be included in the list of ones in Python's standard
+# library.
+extra_standard_library = []
+
+# Force isort to recognize a module as being part of a third party
+# library.
+known_third_party = []
+
+# known_OTHER is how imports of custom sections are defined.
+# OTHER is a placeholder for the custom section name.
+known_mylib = ['carlogtt_library', 'carlogtt_python_library']
+
+# Force isort to recognize a module as being part of the current python
+# project.
+known_first_party = []
+
+# Force isort to recognize a module as being a local folder. Generally,
+#this is reserved for relative imports (from . import module).
+known_local_folder = []
+
+
+[tool.mypy]
+# mypy docs
+# https://mypy.readthedocs.io/en/latest/config_file.html
+
+# Enables the type-checker on the interior of functions without type
+# annotations.
+check_untyped_defs = true
+
+# Generate a warning when returning a value with type Any from a function
+# declared with a non-Any return type.
+warn_return_any = true
+
+# Treat parameters with a None default value as having an implicit
+# optional type (T | None).
+implicit_optional = false
+
+# Displaying specific error codes makes it easier to silence specific
+# errors.
+show_error_codes = true
+
+# Show source code snippets and location markers in error messages.
+pretty = true
+
+# Suppresses errors about packages which do not implement type-hint
+# sharing.
+ignore_missing_imports = false
+
+# Warns about unneeded '# type: ignore' comments.
+warn_unused_ignores = true
+
+
+[tool.pytest.ini_options]
+addopts = "-vvv --color=yes --durations=5"
+testpaths = [
+    "test",
+    "tests",
+    "integration",
+]

icarus_python3-1.0.0/setup.cfg

@@ -0,0 +1,9 @@
+[flake8]
+ignore = E203,W503
+max-line-length = 100
+max-doc-length = 72
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

icarus_python3-1.0.0/setup.py

@@ -0,0 +1,65 @@
+# ======================================================================
+# MODULE DETAILS
+# This section provides metadata about the module, including its
+# creation date, author, copyright information, and a brief description
+# of the module's purpose and functionality.
+# ======================================================================
+
+#   __|    \    _ \  |      _ \   __| __ __| __ __|
+#  (      _ \     /  |     (   | (_ |    |      |
+# \___| _/  _\ _|_\ ____| \___/ \___|   _|     _|
+
+# setup.py
+# Created 2/16/26 - 9:50 AM UK Time (London) by carlogtt
+
+"""
+This module ...
+"""
+
+# ======================================================================
+# EXCEPTIONS
+# This section documents any exceptions made code or quality rules.
+# These exceptions may be necessary due to specific coding requirements
+# or to bypass false positives.
+# ======================================================================
+#
+
+# ======================================================================
+# IMPORTS
+# Importing required libraries and modules for the application.
+# ======================================================================
+
+# Standard Library Imports
+import os
+
+# Third Party Library Imports
+from setuptools import setup
+
+# END IMPORTS
+# ======================================================================
+
+
+def derive_version() -> str:
+    """
+    This function is required for Icarus Builder to  determine the
+    package version from the version in `icarus.cfg`.
+
+    The version number is expected to be provided via the
+    environment variable `ICARUS_PACKAGE_VERSION`.
+
+    If this variable is not found, a KeyError will be raised.
+
+    :return: The version number as a string.
+    """
+
+    version = os.environ.get('ICARUS_PACKAGE_VERSION')
+
+    if version is None:
+        raise KeyError("ICARUS_PACKAGE_VERSION not found in the environment.")
+
+    return version
+
+
+setup(
+    version=derive_version(),
+)

icarus_python3-1.0.0/src/icarus_python3/__init__.py

@@ -0,0 +1,35 @@
+# ======================================================================
+# MODULE DETAILS
+# This section provides metadata about the module, including its
+# creation date, author, copyright information, and a brief description
+# of the module's purpose and functionality.
+# ======================================================================
+
+#   __|    \    _ \  |      _ \   __| __ __| __ __|
+#  (      _ \     /  |     (   | (_ |    |      |
+# \___| _/  _\ _|_\ ____| \___/ \___|   _|     _|
+
+# src/icarus_python3/__init__.py
+# Created 7/19/23 - 10:24 AM UK Time (London) by carlogtt
+
+"""
+This module ...
+"""
+
+# ======================================================================
+# EXCEPTIONS
+# This section documents any exceptions made code or quality rules.
+# These exceptions may be necessary due to specific coding requirements
+# or to bypass false positives.
+# ======================================================================
+# flake8: noqa
+
+# ======================================================================
+# IMPORTS
+# Importing required libraries and modules for the application.
+# ======================================================================
+
+
+# END IMPORTS
+# ======================================================================
+

icarus_python3-1.0.0/src/icarus_python3/main.py

@@ -0,0 +1,35 @@
+# ======================================================================
+# MODULE DETAILS
+# This section provides metadata about the module, including its
+# creation date, author, copyright information, and a brief description
+# of the module's purpose and functionality.
+# ======================================================================
+
+#   __|    \    _ \  |      _ \   __| __ __| __ __|
+#  (      _ \     /  |     (   | (_ |    |      |
+# \___| _/  _\ _|_\ ____| \___/ \___|   _|     _|
+
+# src/icarus_python3/main.py
+# Created 1/25/24 - 10:07 PM UK Time (London) by carlogtt
+
+"""
+This module ...
+"""
+
+# ======================================================================
+# EXCEPTIONS
+# This section documents any exceptions made code or quality rules.
+# These exceptions may be necessary due to specific coding requirements
+# or to bypass false positives.
+# ======================================================================
+#
+
+# ======================================================================
+# IMPORTS
+# Importing required libraries and modules for the application.
+# ======================================================================
+
+
+# END IMPORTS
+# ======================================================================
+

icarus_python3-1.0.0/src/icarus_python3/py.typed

@@ -0,0 +1 @@
+# Marker file that indicates this package supports typing.

icarus_python3-1.0.0/src/icarus_python3.egg-info/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: icarus-python3
+Version: 1.0.0
+Summary: IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder
+Author-email: Carlo Gatti <carlo.gatti@me.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/64rl0/IcarusPython3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: setuptools
+Requires-Dist: build
+Requires-Dist: twine
+Requires-Dist: wheel
+Dynamic: license-file
+
+# IcarusPython3
+
+IcarusPython3 is the Python3 build system for first-party Python packages in Icarus Builder.
+
+## Package documentation
+[Read the Docs](file:///Users/carlogtt/Library/CloudStorage/Dropbox/SDE/Python/CarloCodes/_Projects/IcarusPython3/docs/html/index.html)

icarus_python3-1.0.0/src/icarus_python3.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+setup.py
+src/icarus_python3/__init__.py
+src/icarus_python3/main.py
+src/icarus_python3/py.typed
+src/icarus_python3.egg-info/PKG-INFO
+src/icarus_python3.egg-info/SOURCES.txt
+src/icarus_python3.egg-info/dependency_links.txt
+src/icarus_python3.egg-info/requires.txt
+src/icarus_python3.egg-info/top_level.txt
+test/test_application.py

icarus_python3-1.0.0/src/icarus_python3.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

icarus_python3-1.0.0/src/icarus_python3.egg-info/requires.txt

@@ -0,0 +1,4 @@
+setuptools
+build
+twine
+wheel

icarus_python3-1.0.0/src/icarus_python3.egg-info/top_level.txt

@@ -0,0 +1 @@
+icarus_python3

icarus_python3-1.0.0/test/test_application.py

@@ -0,0 +1,62 @@
+# ======================================================================
+# MODULE DETAILS
+# This section provides metadata about the module, including its
+# creation date, author, copyright information, and a brief description
+# of the module's purpose and functionality.
+# ======================================================================
+
+#   __|    \    _ \  |      _ \   __| __ __| __ __|
+#  (      _ \     /  |     (   | (_ |    |      |
+# \___| _/  _\ _|_\ ____| \___/ \___|   _|     _|
+
+# test/test_application.py
+# Created 2/27/24 - 11:14 AM UK Time (London) by carlogtt
+
+"""
+This module ...
+"""
+
+# ======================================================================
+# EXCEPTIONS
+# This section documents any exceptions made code or quality rules.
+# These exceptions may be necessary due to specific coding requirements
+# or to bypass false positives.
+# ======================================================================
+#
+
+# ======================================================================
+# IMPORTS
+# Importing required libraries and modules for the application.
+# ======================================================================
+
+# Standard Library Imports
+import textwrap
+
+# Third Party Library Imports
+import pytest
+
+# END IMPORTS
+# ======================================================================
+
+
+# List of public names in the module
+# __all__ = []
+
+# Setting up logger for current module
+# module_logger =
+
+# Type aliases
+#
+
+
+@pytest.mark.xfail
+def test_that_you_wrote_tests():
+    assertion_string = textwrap.dedent("""\
+    No, you have not written tests.
+
+    However, unless a test is run, the pytest execution will fail
+    due to no tests or missing coverage. So, write a real test and
+    then remove this!
+    """)
+    assert False, assertion_string
+