mapFolding 0.3.6__py3-none-any.whl → 0.3.8__py3-none-any.whl

citations/constants.py

@@ -0,0 +1,3 @@
+GITHUB_API_VERSION_HEADER = {
+    "X-GitHub-Api-Version": "2022-11-28"
+}

citations/updateCitation.py

@@ -1,116 +1,354 @@
 from cffconvert.cli.create_citation import create_citation
-from cffconvert.cli.validate_or_write_output import validate_or_write_output
-from typing import Any, Dict
+from mapFolding.citations.constants import GITHUB_API_VERSION_HEADER
+from packaging.metadata import Metadata as PyPAMetadata
+from typing import Any, Dict, List
+import attrs
 import cffconvert
-import pathlib
-import packaging.metadata
-import tomli
-import inspect
-import json
-import ruamel.yaml
+import os
 import packaging
-from packaging.metadata import Metadata as PyPAMetadata
+import packaging.metadata
 import packaging.utils
 import packaging.version
+import pathlib
+import requests
+import ruamel.yaml
+import tomli
+
+listProjectURLsTarget: List[str] = ["homepage", "license", "repository"]
+
+"""
+Tentative plan:
+- Commit and push to GitHub
+- GitHub Action gathers information from the sources of truth
+- If the citation needs to be updated, write to both
+    - pathFilenameCitationSSOT
+    - pathFilenameCitationDOTcffRepo
+- Commit and push to GitHub
+    - this complicates things
+    - I want the updated citation to be in the `commit` field of itself: but the commit field isn't even working right now
+"""
 
-def addPypaMetadata(citation: cffconvert.Citation, metadata: PyPAMetadata) -> cffconvert.Citation:
-    # https://github.com/citation-file-format/cff-initializer-javascript
+@attrs.define
+class CitationNexus:
     """
-keywords: pathFilenamePackageSSOT; packaging.metadata.Metadata.keywords
-license: pathFilenamePackageSSOT; packaging.metadata.Metadata.license_expression
-title: pathFilenamePackageSSOT; packaging.metadata.Metadata.name
-url: pathFilenamePackageSSOT; packaging.metadata.Metadata.project_urls: homepage
-repository: pathFilenamePackageSSOT; packaging.metadata.Metadata.project_urls: repository
-version: pathFilenamePackageSSOT; packaging.metadata.Metadata.version
+    - one-to-one correlation with `cffconvert.lib.cff_1_2_x.citation` class Citation_1_2_x.cffobj
     """
-    return citation
+    cffDASHversion: str
+    message: str
+
+    abstract: str | None = None
+    authors: list[dict[str,str]] = attrs.field(factory=list)
+    # GitHub TODO
+    commit: str | None = None
+    contact: list[dict[str,str]] = attrs.field(factory=list)
+    dateDASHreleased: str | None = None
+    doi: str | None = None
+    identifiers: list[str] = attrs.field(factory=list)
+    keywords: list[str] = attrs.field(factory=list)
+    license: str | None = None
+    licenseDASHurl: str | None = None
+    preferredDASHcitation: str | None = None
+    # TODO bibtex files in pathCitationSSOT. Conversion method and timing TBD.
+    references: list[str] = attrs.field(factory=list)
+    repository: str | None = None
+    repositoryDASHartifact: str | None = None
+    repositoryDASHcode: str | None = None
+    title: str | None = None
+    type: str | None = None
+    url: str | None = None
+    version: str | None = None
+
+    def setInStone(self, prophet: str) -> "CitationNexus":
+        match prophet:
+            case "Citation":
+                pass
+                # "freeze" these items
+                # setattr(self.cffDASHversion, 'type', Final[str])
+                # setattr(self.doi, 'type', Final[str])
+                # cffDASHversion: str
+                # message: str
+                # abstract: str | None = None
+                # doi: str | None = None
+                # preferredDASHcitation: str | None = None
+                # type: str | None = None
+            case "GitHub":
+                pass
+                # "freeze" these items
+                # setattr(self.commit, 'type', Final[str])
+                # setattr(self.dateDASHreleased, 'type', Final[str])
+                # setattr(self.identifiers, 'type', Final[list[str]])
+                # setattr(self.repositoryDASHcode, 'type', Final[str])
+            case "PyPA":
+                pass
+                # "freeze" these items
+                # setattr(self.keywords, 'type', Final[list[str]])
+                # setattr(self.license, 'type', Final[str])
+                # setattr(self.licenseDASHurl, 'type', Final[str])
+                # setattr(self.repository, 'type', Final[str])
+                # setattr(self.url, 'type', Final[str])
+                # setattr(self.version, 'type', Final[str])
+            case "PyPI":
+                pass
+                # "freeze" these items
+                # setattr(self.repositoryDASHartifact, 'type', Final[str])
+            case "pyprojectDOTtoml":
+                pass
+                # "freeze" these items
+                # setattr(self.authors, 'type', Final[list[dict[str,str]]])
+                # setattr(self.contact, 'type', Final[list[dict[str,str]]])
+                # setattr(self.title, 'type', Final[str])
+        return self
+
+def addPypaMetadata(nexusCitation: CitationNexus, metadata: PyPAMetadata) -> CitationNexus:
+    if not metadata.name:
+        raise ValueError("Metadata name is required.")
+
+    nexusCitation.title = metadata.name
+    if metadata.version: nexusCitation.version = str(metadata.version)
+    if metadata.keywords: nexusCitation.keywords = metadata.keywords
+    if metadata.license_expression: nexusCitation.license = metadata.license_expression
+
+    Z0Z_lookup: Dict[str, str] = {
+        "homepage": "url",
+        "license": "licenseDASHurl",
+        "repository": "repository",
+    }
+    if metadata.project_urls:
+        for urlTarget in listProjectURLsTarget:
+            url = metadata.project_urls.get(urlTarget, None)
+            if url:
+                setattr(nexusCitation, Z0Z_lookup[urlTarget], url)
+
+    nexusCitation = nexusCitation.setInStone("PyPA")
+    return nexusCitation
+
+def add_pyprojectDOTtoml(nexusCitation: CitationNexus, packageData: Dict[str, Any]) -> CitationNexus:
+    def Z0Z_ImaNotValidatingNoNames(person: Dict[str, str]) -> Dict[str, str]:
+        cffPerson: Dict[str, str] = {}
+        if person.get('name', None):
+            cffPerson['given-names'], cffPerson['family-names'] = person['name'].split(' ', 1)
+        if person.get('email', None):
+            cffPerson['email'] = person['email']
+        return cffPerson
+    listAuthors = packageData.get("authors", None)
+    if not listAuthors:
+        raise ValueError("Authors are required.")
+    else:
+        listPersons = []
+        for person in listAuthors:
+            listPersons.append(Z0Z_ImaNotValidatingNoNames(person))
+            nexusCitation.authors = listPersons
+    if packageData.get("maintainers", None):
+        listPersons = []
+        for person in packageData["maintainers"]:
+            listPersons.append(Z0Z_ImaNotValidatingNoNames(person))
+            nexusCitation.contact = listPersons
+    nexusCitation.title = packageData["name"]
+    nexusCitation = nexusCitation.setInStone("pyprojectDOTtoml")
+    return nexusCitation
+
+def getGitHubRelease(nexusCitation: CitationNexus) -> Dict[str, Any]:
+    """Return a dictionary with GitHub release data.
+
+    The dictionary contains the following keys:
+        commit: The commit hash (using the API field 'target_commitish').
+        date-released: The published date (in YYYY-MM-DD format).
+        identifiers: A list with one identifier object, whose description is
+            'The URL for {nexusCitation.title} {nexusCitation.version}.'
+        repository-code: A URL for the commit in the repository.
+
+    Raises:
+        ValueError: If the nexusCitation.repository is not set or cannot be parsed.
+        RuntimeError: If the HTTP request to GitHub fails.
+    """
+    if not nexusCitation.repository:
+        raise ValueError("Repository URL is required to get GitHub release info.")
+
+    urlparts = nexusCitation.repository.replace("https://github.com", "", 1).strip("/").split("/") + [None] * 5
+    ownername, reponame, _2, refvalue, *_filename_parts = urlparts
+    reponame = reponame.replace(".git", "") # type: ignore # Remove .git from the repository name, if present.
+    assert ownername is not None, "URL should include the name of the owner/organization."
+    assert reponame is not None, "URL should include the name of the repository."
+    if refvalue is None:
+        repos_api = f"https://api.github.com/repos/{ownername}/{reponame}/releases/latest"
+        headers = GITHUB_API_VERSION_HEADER
+        headers.update({"Accept": "application/vnd.github+json"})
+        token = os.environ.get("GITHUB_TOKEN")
+        headers.update({"Authorization": f"Bearer { token }"})
+        response = requests.get(repos_api, headers=headers)
+        if response.status_code != 200:
+            raise RuntimeError(f"Failed to get GitHub release info: {response.status_code}")
+
+    releaseData = response.json()
+    # commitHash = releaseData.get("target_commitish")
+    publishedAt = releaseData.get("published_at")
+    if publishedAt:
+        # Convert ISO timestamp (e.g., "2020-12-31T12:34:56Z") to "YYYY-MM-DD".
+        publishedAt = publishedAt.split("T")[0]
+
+    releaseHtmlUrl = releaseData.get("html_url")
+    identifierDescription = f"The URL for {nexusCitation.title} {nexusCitation.version}."
+    return {
+        # "commit": commitHash,
+        "dateDASHreleased": publishedAt,
+        "identifiers": [{
+            "type": "url",
+            "value": releaseHtmlUrl,
+            "description": identifierDescription,
+        }],
+        "repositoryDASHcode": releaseHtmlUrl,
+    }
+
+def addGitHubRelease(nexusCitation: CitationNexus) -> CitationNexus:
+    """
+    Update the nexusCitation with GitHub release information.
+
+    This function populates the following fields on the nexusCitation:
+        - commit: using the commit hash from GitHub.
+        - dateDASHreleased: the release date.
+        - identifiers: appends a GitHub-specific identifier.
+        - repositoryDASHcode: the URL to view the commit in the repository.
+
+    Returns:
+        The updated CitationNexus instance.
+
+    Raises:
+        Any exception raised by getGitHubRelease.
+    """
+    gitHubReleaseData = getGitHubRelease(nexusCitation)
+    nexusCitation.commit = gitHubReleaseData.get("commit")
+    nexusCitation.dateDASHreleased = gitHubReleaseData.get("dateDASHreleased")
+    # Overwrite the existing list of identifiers. This could be better
+    nexusCitation.identifiers = gitHubReleaseData.get("identifiers", [])
+    nexusCitation.repositoryDASHcode = gitHubReleaseData.get("repositoryDASHcode")
+    return nexusCitation
+
+def getPyPIrelease(nexusCitation: CitationNexus) -> Dict[str, Any]:
+    if not nexusCitation.title:
+        raise ValueError("Package name (title) is required to get PyPI release info.")
+    if not nexusCitation.version:
+        raise ValueError("Package version is required to get PyPI release info.")
+
+    packageName = packaging.utils.canonicalize_name(nexusCitation.title)
+    version = str(nexusCitation.version)
+    return {
+        "repositoryDASHartifact": f"https://pypi.org/project/{packageName}/{version}/"
+    }
+
+def addPyPIrelease(nexusCitation: CitationNexus) -> CitationNexus:
+    pypiReleaseData = getPyPIrelease(nexusCitation)
+    nexusCitation.repositoryDASHartifact = pypiReleaseData.get("repositoryDASHartifact")
+    return nexusCitation
+
+def getNexusCitation(pathFilenameCitationSSOT: pathlib.Path) -> CitationNexus:
+
+    # `cffconvert.cli.create_citation.create_citation()` is PAINFULLY mundane, but a major problem
+    # in the CFF ecosystem is divergence. Therefore, I will use this function so that my code
+    # converges with the CFF ecosystem.
+    citationObject: cffconvert.Citation = create_citation(infile=pathFilenameCitationSSOT, url=None)
+    # `._parse()` is a yaml loader: use it for convergence
+    cffobj: Dict[Any, Any] = citationObject._parse()
+
+    nexusCitation = CitationNexus(
+        cffDASHversion=cffobj["cff-version"],
+        message=cffobj["message"],
+    )
+
+    Z0Z_list: List[attrs.Attribute] = list(attrs.fields(type(nexusCitation)))
+    for Z0Z_field in Z0Z_list:
+        cffobjKeyName: str = Z0Z_field.name.replace("DASH", "-")
+        cffobjValue = cffobj.get(cffobjKeyName)
+        if cffobjValue: # An empty list will be False
+            setattr(nexusCitation, Z0Z_field.name, cffobjValue)
+
+    nexusCitation = nexusCitation.setInStone("Citation")
+    return nexusCitation
 
 def getPypaMetadata(packageData: Dict[str, Any]) -> PyPAMetadata:
-    # https://packaging.python.org/en/latest/specifications/core-metadata/
-    dictionaryProjectURLs = {}
-    for urlKey, urlValue in packageData.get('urls', {}).items():
-        if urlKey.lower() in ('homepage', 'repository'):
-            dictionaryProjectURLs[urlKey] = urlValue
+    """
+    Create a PyPA metadata object (version 2.4) from packageData.
+    https://packaging.python.org/en/latest/specifications/core-metadata/
+    """
+    dictionaryProjectURLs: Dict[str, str] = {}
+    for urlName, url in packageData.get("urls", {}).items():
+        urlName = urlName.lower()
+        if urlName in listProjectURLsTarget:
+            dictionaryProjectURLs[urlName] = url
 
     metadataRaw = packaging.metadata.RawMetadata(
-        keywords=packageData.get('keywords', []),
-        license_expression=packageData.get('license', {}).get('text', ''),
-        metadata_version='2.4',
-        name=packaging.utils.canonicalize_name(packageData.get('name', None), validate=True),
+        keywords=packageData.get("keywords", []),
+        license_expression=packageData.get("license", {}).get("text", ""),
+        metadata_version="2.4",
+        name=packaging.utils.canonicalize_name(packageData.get("name", None), validate=True), # packaging.metadata.InvalidMetadata: 'name' is a required field
         project_urls=dictionaryProjectURLs,
-        version=packageData.get('version', None),
+        version=packageData.get("version", None),
     )
 
     metadata = PyPAMetadata().from_raw(metadataRaw)
     return metadata
 
-"""
-Tentative plan:
-- Commit and push to GitHub
-- GitHub Action gathers information from the sources of truth
-- If the citation needs to be updated, write to both
-    - pathFilenameCitationSSOT
-    - pathFilenameCitationDOTcffRepo
-- Commit and push to GitHub
-    - this complicates things
-    - I want the updated citation to be in the `commit` field of itself
-"""
-"""cffconvert.Citation fields and the source of truth
-abstract: pathFilenameCitationSSOT
-authors: pathFilenamePackageSSOT
-cff-version: pathFilenameCitationSSOT
-commit: workflows['Make GitHub Release']
-contact: pathFilenamePackageSSOT
-date-released: workflows['Make GitHub Release']
-doi: pathFilenameCitationSSOT
-identifiers: workflows['Make GitHub Release']
-license-url: pathFilenamePackageSSOT
-message: pathFilenameCitationSSOT
-preferred-citation: pathFilenameCitationSSOT
-references: to be determined
-repository-artifact: (https://pypi.org/pypi/{package_name}/json').json()['releases']
-repository-code: workflows['Make GitHub Release']
-type: pathFilenameCitationSSOT
-
-keywords: pathFilenamePackageSSOT; packaging.metadata.Metadata.keywords
-license: pathFilenamePackageSSOT; packaging.metadata.Metadata.license_expression
-title: pathFilenamePackageSSOT; packaging.metadata.Metadata.name
-url: pathFilenamePackageSSOT; packaging.metadata.Metadata.project_urls: homepage
-repository: pathFilenamePackageSSOT; packaging.metadata.Metadata.project_urls: repository
-version: pathFilenamePackageSSOT; packaging.metadata.Metadata.version
-"""
+def writeCitation(nexusCitation: CitationNexus, pathFilenameCitationSSOT: pathlib.Path, pathFilenameCitationDOTcffRepo: pathlib.Path):
+    # NOTE embarrassingly hacky process to follow
+    parameterIndent= 2
+    parameterLineWidth = 60
+    yamlWorkhorse = ruamel.yaml.YAML()
+
+    def srsly(Z0Z_filed, Z0Z_value):
+        if Z0Z_value: # empty lists
+            return True
+        else:
+            return False
+
+    dictionaryCitation = attrs.asdict(nexusCitation, filter=srsly)
+    for keyName in list(dictionaryCitation.keys()):
+        dictionaryCitation[keyName.replace("DASH", "-")] = dictionaryCitation.pop(keyName)
+
+    pathFilenameForValidation = pathFilenameCitationSSOT.with_stem('validation')
+
+    def writeStream(pathFilename):
+        with open(pathFilename, 'w') as pathlibIsAStealthContextManagerThatRuamelCannotDetectAndRefusesToWorkWith:
+            yamlWorkhorse.dump(dictionaryCitation, pathlibIsAStealthContextManagerThatRuamelCannotDetectAndRefusesToWorkWith)
+
+    writeStream(pathFilenameForValidation)
+
+    citationObject: cffconvert.Citation = create_citation(infile=pathFilenameForValidation, url=None)
+    if citationObject.validate() is None:
+        writeStream(pathFilenameCitationSSOT)
+        writeStream(pathFilenameCitationDOTcffRepo)
+
+    pathFilenameForValidation.unlink()
 
 def logistics():
     # Prefer reliable, dynamic values over hardcoded ones
-    packageName: str = 'mapFolding'
     pathRepoRoot = pathlib.Path(__file__).parent.parent.parent
     pathFilenamePackageSSOT = pathRepoRoot / 'pyproject.toml'
-    filenameGitHubAction = 'updateCitation.yml'
-    pathFilenameGitHubAction = pathRepoRoot / '.github' / 'workflows' / filenameGitHubAction
+
+    tomlPackageData: Dict[str, Any] = tomli.loads(pathFilenamePackageSSOT.read_text())['project']
+    # https://packaging.python.org/en/latest/specifications/pyproject-toml/
+
+    packageName: str = tomlPackageData.get("name", None)
+    if not packageName:
+        raise ValueError("Package name is required.")
 
     filenameCitationDOTcff = 'CITATION.cff'
     pathCitations = pathRepoRoot / packageName / 'citations'
     pathFilenameCitationSSOT = pathCitations / filenameCitationDOTcff
     pathFilenameCitationDOTcffRepo = pathRepoRoot / filenameCitationDOTcff
 
-    citationObject: cffconvert.Citation = create_citation(infile=pathFilenameCitationSSOT, url=None)
-    print(citationObject._parse().as_cff())
+    nexusCitation = getNexusCitation(pathFilenameCitationSSOT)
 
-    tomlPackageData: Dict[str, Any] = tomli.loads(pathFilenamePackageSSOT.read_text())['project']
-    # https://packaging.python.org/en/latest/specifications/pyproject-toml/
     pypaMetadata: PyPAMetadata = getPypaMetadata(tomlPackageData)
 
-    validate_or_write_output(outfile=pathFilenameCitationSSOT, outputformat='cff', validate_only=False, citation=citationObject)
-    validate_or_write_output(outfile=pathFilenameCitationDOTcffRepo, outputformat='cff', validate_only=False, citation=citationObject)
+    nexusCitation = addPypaMetadata(nexusCitation, pypaMetadata)
+    nexusCitation = add_pyprojectDOTtoml(nexusCitation, tomlPackageData)
 
-if __name__ == '__main__':
-    logistics()
+    nexusCitation = addGitHubRelease(nexusCitation)
+    nexusCitation = addPyPIrelease(nexusCitation)
 
-    # print(f"{pypaMetadata.name=}, {pypaMetadata.version=}, {pypaMetadata.keywords=}, {pypaMetadata.license_expression=}, {pypaMetadata.project_urls=}")
-# path_cffconvert = pathlib.Path(inspect.getfile(cffconvert)).parent
-# pathFilenameSchema = path_cffconvert / "schemas/1.2.0/schema.json"
-# scheme: Dict[str, Any] = json.loads(pathFilenameSchema.read_text())
-# schemaSpecifications: Dict[str, Any] = scheme['properties']
+    filenameGitHubAction = 'updateCitation.yml'
+    pathFilenameGitHubAction = pathRepoRoot / '.github' / 'workflows' / filenameGitHubAction
+
+    writeCitation(nexusCitation, pathFilenameCitationSSOT, pathFilenameCitationDOTcffRepo)
 
-# for property, subProperties in schemaSpecifications.items():
-#     print(property, subProperties.get('items', None))
+if __name__ == '__main__':
+    logistics()

{mapFolding-0.3.6.dist-info → mapFolding-0.3.8.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.2
 Name: mapFolding
-Version: 0.3.6
+Version: 0.3.8
 Summary: Count distinct ways to fold a map (or a strip of stamps)
 Author-email: Hunter Hogan <HunterHogan@pm.me>
 License: CC-BY-NC-4.0
-Project-URL: homepage, https://github.com/hunterhogan/mapFolding
+Project-URL: Homepage, https://github.com/hunterhogan/mapFolding
 Project-URL: Donate, https://www.patreon.com/integrated
-Project-URL: repository, https://github.com/hunterhogan/mapFolding.git
+Project-URL: Repository, https://github.com/hunterhogan/mapFolding.git
 Keywords: A001415,A001416,A001417,A001418,A195646,folding,map folding,OEIS,stamp folding
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -30,12 +30,13 @@ Requires-Dist: jupyter; extra == "benchmark"
 Requires-Dist: pandas; extra == "benchmark"
 Requires-Dist: tqdm; extra == "benchmark"
 Provides-Extra: testing
+Requires-Dist: attrs; extra == "testing"
 Requires-Dist: cffconvert; extra == "testing"
 Requires-Dist: more_itertools; extra == "testing"
-Requires-Dist: pytest; extra == "testing"
 Requires-Dist: pytest-cov; extra == "testing"
 Requires-Dist: pytest-env; extra == "testing"
 Requires-Dist: pytest-xdist; extra == "testing"
+Requires-Dist: pytest; extra == "testing"
 Requires-Dist: python_minifier; extra == "testing"
 Requires-Dist: tomli; extra == "testing"
 

mapFolding-0.3.8.dist-info/RECORD

@@ -0,0 +1,26 @@
+benchmarks/benchmarking.py,sha256=HD_0NSvuabblg94ftDre6LFnXShTe8MYj3hIodW-zV0,3076
+citations/constants.py,sha256=1n3AC_18LOjmMLJWDo8YOGEIvDY7oZyLtI4QwqdB6z4,73
+citations/updateCitation.py,sha256=ihZFafY1TtVgQ1cnVNAHGCJMgoBUR8cm1qvGobwjNKA,14949
+reference/flattened.py,sha256=6blZ2Y9G8mu1F3gV8SKndPE398t2VVFlsgKlyeJ765A,16538
+reference/hunterNumba.py,sha256=HWndRgsajOf76rbb2LDNEZ6itsdYbyV-k3wgOFjeR6c,7104
+reference/irvineJavaPort.py,sha256=Sj-63Z-OsGuDoEBXuxyjRrNmmyl0d7Yz_XuY7I47Oyg,4250
+reference/jax.py,sha256=rojyK80lOATtbzxjGOHWHZngQa47CXCLJHZwIdN2MwI,14955
+reference/lunnan.py,sha256=XEcql_gxvCCghb6Or3qwmPbn4IZUbZTaSmw_fUjRxZE,5037
+reference/lunnanNumpy.py,sha256=HqDgSwTOZA-G0oophOEfc4zs25Mv4yw2aoF1v8miOLk,4653
+reference/lunnanWhile.py,sha256=7NY2IKO5XBgol0aWWF_Fi-7oTL9pvu_z6lB0TF1uVHk,4063
+reference/rotatedEntryPoint.py,sha256=z0QyDQtnMvXNj5ntWzzJUQUMFm1-xHGLVhtYzwmczUI,11530
+reference/total_countPlus1vsPlusN.py,sha256=usenM8Yn_G1dqlPl7NKKkcnbohBZVZBXTQRm2S3_EDA,8106
+someAssemblyRequired/__init__.py,sha256=3JnAKXfaYPtmxV_4AnZ6KpCosT_0GFV5Nw7K8sz4-Uo,34
+someAssemblyRequired/getLLVMforNoReason.py,sha256=FtJzw2pZS3A4NimWdZsegXaU-vKeCw8m67kcfb5wvGM,894
+someAssemblyRequired/makeJob.py,sha256=UUCNdkFnSrlhRAjkQp2_Qv4joKGXRnNJhZ4OdxI_aqU,2628
+someAssemblyRequired/synthesizeModuleJobNumba.py,sha256=TCYNNI19vCw0C1FLP691VPpYknkedj-zpx-xQFVIVJU,9851
+someAssemblyRequired/synthesizeModulesNumba.py,sha256=aOst0EC5zStLbUSDTpyMoyQe_8_3CLX7JSdHdPmlAsY,22847
+syntheticModules/__init__.py,sha256=XMjNt8x24M82i1eCNVcWpIIhXwfVCnjfbb-y36RAafA,131
+syntheticModules/numbaInitialize.py,sha256=H8Y22wwE5kYyroztAJ5HJ2W6qfw7Fu4iVrUsCPmnFjY,4088
+syntheticModules/numbaParallel.py,sha256=fvprhBepBxQkY5yQInYRWb7agDVMArypGC6Y510tAcU,5452
+syntheticModules/numbaSequential.py,sha256=Knru1I7BBvsBDTex7NfxO2U3IEcQfz-uG4Lpw2tLhOI,3629
+mapFolding-0.3.8.dist-info/METADATA,sha256=hgOrdxAEB5vsBdIK41JvUc65iHQladkMBbbXwg-YPnc,7729
+mapFolding-0.3.8.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+mapFolding-0.3.8.dist-info/entry_points.txt,sha256=F3OUeZR1XDTpoH7k3wXuRb3KF_kXTTeYhu5AGK1SiOQ,146
+mapFolding-0.3.8.dist-info/top_level.txt,sha256=yVG9dNZywoaddcsUdEDg7o0XOBzJd_4Z-sDaXGHpiMY,69
+mapFolding-0.3.8.dist-info/RECORD,,

someAssemblyRequired/makeJob.py

@@ -1,25 +1,53 @@
-from mapFolding import getPathFilenameFoldsTotal, computationState
-from mapFolding import outfitCountFolds
+import importlib.util
+from mapFolding import getPathFilenameFoldsTotal, computationState, outfitCountFolds, getAlgorithmSource
 from typing import Any, Literal, Optional, Sequence, Type, overload
 import pathlib
 import pickle
 
 @overload
 def makeStateJob(listDimensions: Sequence[int], writeJob: Literal[True] = True
-                 , **keywordArguments: Optional[Type[Any]]) -> pathlib.Path:
+                 , **keywordArguments: Optional[str]) -> pathlib.Path:
     ...
 
 @overload
 def makeStateJob(listDimensions: Sequence[int], writeJob: Literal[False] = False
-                 , **keywordArguments: Optional[Type[Any]]) -> computationState:
+                 , **keywordArguments: Optional[str]) -> computationState:
     ...
 
-def makeStateJob(listDimensions: Sequence[int], writeJob: bool = True, **keywordArguments: Optional[Type[Any]]) -> computationState | pathlib.Path:
+def makeStateJob(listDimensions: Sequence[int], writeJob: bool = True, **keywordArguments: Optional[str]) -> computationState | pathlib.Path:
+    """
+    Creates a computation state job for map folding calculations and optionally saves it to disk.
+
+    This function initializes a computation state for map folding calculations based on the given dimensions,
+    sets up the initial counting configuration, and can optionally save the state to a pickle file.
+
+    Parameters
+    ----------
+    listDimensions : Sequence[int]
+        The dimensions of the map to be folded, typically as [height, width].
+    writeJob : bool, optional
+        If True, saves the computation state to disk. If False, returns the state object directly.
+        Default is True.
+    **keywordArguments : Optional[str]
+        Additional keyword arguments to be passed to the outfitCountFolds function.
+
+    Returns
+    -------
+    Union[computationState, pathlib.Path]
+        If writeJob is False, returns the computation state object.
+        If writeJob is True, returns the Path object pointing to the saved state file.
+
+    Notes
+    -----
+    The function creates necessary directories and saves the state as a pickle file
+    when writeJob is True. The file is saved in a directory structure based on the map shape.
+    """
 
     stateUniversal: computationState = outfitCountFolds(listDimensions, computationDivisions=None, CPUlimit=None, **keywordArguments)
 
-    from mapFolding.syntheticModules import countInitialize
-    countInitialize(stateUniversal['connectionGraph'], stateUniversal['gapsWhere'], stateUniversal['my'], stateUniversal['track'])
+
+    moduleSource = getAlgorithmSource()
+    moduleSource.countInitialize(stateUniversal['connectionGraph'], stateUniversal['gapsWhere'], stateUniversal['my'], stateUniversal['track'])
 
     if not writeJob:
         return stateUniversal