radiasoft · robnagler · Nov 29, 2025 · Nov 28, 2025 · Nov 28, 2025 · Nov 29, 2025
diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml
diff --git a/.gitignore b/.gitignore
@@ -1,68 +1,17 @@
 pyhellweg.cpp
-__history
+pyhellweg.o
 
-# Created by https://www.gitignore.io/api/c++
-
-### C++ ###
-# Prerequisites
-*.d
-
-# Compiled Object files
-*.slo
-*.lo
-*.o
-*.obj
-
-# Precompiled Headers
-*.gch
-*.pch
-
-# Compiled Dynamic libraries
-*.so
-*.dylib
-*.dll
-
-# Fortran module files
-*.mod
-*.smod
-
-# Compiled Static libraries
-*.lai
-*.la
-*.a
-*.lib
-
-# Executables
-*.exe
-*.out
-*.app
-
-# Created by https://www.gitignore.io/api/cmake
-
-### CMake ###
-CMakeCache.txt
-CMakeFiles
-CMakeScripts
-Makefile
-cmake_install.cmake
-install_manifest.txt
-CTestTestfile.cmake
-
-# Backup files
-*.#00
-*.~1~
-*.~3~
-*.~4~
-*~
-
-
-# Created by https://www.gitignore.io/api/python
+pytest.ini
+tox.ini
+.python-version
+.#*
+\#*
+.idea/
+.vscode/
 
-### Python ###
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
-*$py.class
 
 # C extensions
 *.so
@@ -74,8 +23,8 @@ build/
 develop-eggs/
 dist/
 downloads/
-eggs/
 .eggs/
+eggs/
 lib/
 lib64/
 parts/
@@ -104,52 +53,18 @@ htmlcov/
 nosetests.xml
 coverage.xml
 *,cover
-.hypothesis/
+.pytest_cache
 
 # Translations
 *.mo
 *.pot
 
 # Django stuff:
 *.log
-local_settings.py
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
 
 # Sphinx documentation
 docs/_build/
+_build_html/
 
 # PyBuilder
 target/
-
-# IPython Notebook
-.ipynb_checkpoints
-
-# pyenv
-.python-version
-
-# celery beat schedule file
-celerybeat-schedule
-
-# dotenv
-.env
-
-# virtualenv
-.venv/
-venv/
-ENV/
-.direnv/
-
-# Spyder project settings
-.spyderproject
-
-# Rope project settings
-.ropeproject
-
-PARSED.TXT
-MANIFEST.in
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -0,0 +1,12 @@
+# Read The Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+version: 2
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.9"
+  jobs:
+    pre_build:
+     - curl https://radia.run | bash -s readthedocs
+sphinx:
+  configuration: docs/conf.py
diff --git a/LICENSE b/LICENSE
@@ -1,3 +1,4 @@
+
                                  Apache License
                            Version 2.0, January 2004
                         http://www.apache.org/licenses/
@@ -178,15 +179,15 @@
    APPENDIX: How to apply the Apache License to your work.
 
       To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "{}"
+      boilerplate notice, with the fields enclosed by brackets "[]"
       replaced with your own identifying information. (Don't include
       the brackets!)  The text should be enclosed in the appropriate
       comment syntax for the file format. We also recommend that a
       file or class name and description of purpose be included on the
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright {yyyy} {name of copyright owner}
+   Copyright [yyyy] [name of copyright owner]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

diff --git a/MANIFEST.in b/MANIFEST.in
@@ -0,0 +1,3 @@
+include src/physics/*.h
+include src/libHellweg2D/*.h
+include src/libHellweg2D/*.hpp
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -0,0 +1,5 @@
+*
+!.gitignore
+!_static/
+!_templates/
+!index.rst
diff --git a/docs/index.rst b/docs/index.rst
@@ -3,6 +3,10 @@ Welcome to rshellweg
 
 description
 
+.. autosummary::
+   :toctree: _autosummary
+   :recursive:
+
 .. toctree::
    :maxdepth: 2
 

diff --git a/pyproject.toml b/pyproject.toml
@@ -0,0 +1,66 @@
+[build-system]
+requires = [
+    "chronver",
+    "setuptools>=66",
+    "Cython>=3.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+authors = [
+    { name = "RadiaSoft LLC", email = "pip@radiasoft.net" },
+]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Programming Language :: Python",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "pykern",
+    "Cython",
+]
+description = "description"
+dynamic = ["version"]
+name = "rshellweg"
+readme = "README.md"
+
+[project.scripts]
+rshellweg = "rshellweg.rshellweg_console:main"
+
+[project.urls]
+Homepage = "https://git.radiasoft.org/rshellweg"
+
+[tool.setuptools.package-data]
+rshellweg = ["package_data/**"]
+
+[tool.setuptools.packages.find]
+include = ["rshellweg*"]
+
+[[tool.setuptools.ext-modules]]
+name = "rshellweg.pyhellweg"
+language = "c++"
+extra-compile-args = ["-std=c++11", "-DRSHELLWEG_LINUX=1"]
+include-dirs = [
+    "src/libHellweg2D",
+    "src/physics",
+]
+sources = [
+    "pyhellweg.pyx",
+    "src/libHellweg2D/AnsiString.cpp",
+    "src/libHellweg2D/IniFiles.cpp",
+    "src/libHellweg2D/TStringList.cpp",
+    "src/libHellweg2D/libHellweg2D.cpp",
+    "src/physics/Beam.cpp",
+    "src/physics/BeamSolver.cpp",
+    "src/physics/ConstUnit.cpp",
+    "src/physics/Functions.cpp",
+    "src/physics/Matrix.cpp",
+    "src/physics/Spectrum.cpp",
+    "src/physics/SpectrumPhase.cpp",
+    "src/physics/Spline.cpp",
+    "src/physics/Types.cpp",
+]
diff --git a/requirements.txt b/requirements.txt
diff --git a/rshellweg/__init__.py b/rshellweg/__init__.py
@@ -1 +1,12 @@
-#
+""":mod:`rshellweg` package
+
+:copyright: Copyright (c) 2025 RadiaSoft LLC.  All Rights Reserved.
+:license: https://www.apache.org/licenses/LICENSE-2.0.html
+"""
+import importlib.metadata
+
+try:
+    # We only have a version once the package is installed.
+    __version__ = importlib.metadata.version("rshellweg")
+except importlib.metadata.PackageNotFoundError:
+    pass
diff --git a/rshellweg/rshellweg_console.py b/rshellweg/rshellweg_console.py
@@ -1,20 +1,17 @@
-# -*- coding: utf-8 -*-
 """Front-end command line for :mod:`rshellweg`.
 
 See :mod:`pykern.pkcli` for how this module is used.
 
-:copyright: Copyright (c) 2016 RadiaSoft LLC.  All Rights Reserved.
-:license: http://www.apache.org/licenses/LICENSE-2.0.html
+:copyright: Copyright (c) 2025 RadiaSoft LLC.  All Rights Reserved.
+:license: https://www.apache.org/licenses/LICENSE-2.0.html
 """
-from __future__ import absolute_import, division, print_function
 
+import pykern.pkcli
 import sys
 
-from pykern import pkcli
-
 
 def main():
-    return pkcli.main("rshellweg")
+    return pykern.pkcli.main("rshellweg")
 
 
 if __name__ == "__main__":

diff --git a/setup.py b/setup.py