swisseph 1.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: aa1f02504d32c51d08e76d5198f94810f43bfe5dbbebd159936cf3e7daad6132
+  data.tar.gz: 7d185d5cf22a9a81955ee713945bbb12e03fdd13614aca4ca19faaa4dc194837
+SHA512:
+  metadata.gz: cb03742afc4ea4ddc959921e8bfa9e5b8b0879a99027e25e4b0442a33c3a2a113d2a9b6107dc378f0510814dc468fdffd0a0966b0d2a590bc8ab6e66c55d32d8
+  data.tar.gz: 8fc99879df66a86c08c3199fb81e8b99021bfb6d166f013f6c2a08b1a2fac04a72f61179804acb7dc64452f0cf4335e9087811422de655eebf3c5587631607b3

data/README.md

@@ -0,0 +1,144 @@
+# Swisseph
+
+**Swiss Ephemeris for Ruby**
+
+[![Gem Version](https://badge.fury.io/rb/swisseph.svg)](https://badge.fury.io/rb/swisseph)
+
+Native Ruby bindings for the [Swiss Ephemeris](http://www.astro.com/swisseph/) library (v2.10.3a), providing high-precision astronomical calculations for astrological applications.
+
+## History & Motivation
+
+This gem is a modernized fork of the original [aakara/swe4r](https://github.com/aakara/swe4r). Since the original project has been abandoned, this version was created to:
+
+-   Ensure compatibility with modern Ruby versions.
+-   Automate the build process using CMake.
+-   Provide more idiomatic Ruby aliases and convenience methods.
+-   Maintain active support for the latest Swiss Ephemeris releases.
+
+## Convenience Features
+
+### Shorthand Methods
+All `swe_*` methods are also available without the `swe_` prefix:
+
+```ruby
+# Traditional way:
+Swisseph.swe_julday(2024, 1, 1, 12.0)
+
+# Modern shorthand:
+Swisseph.julday(2024, 1, 1, 12.0)
+```
+
+### Module Aliases
+For even shorter code, you can use the `Sweph` alias:
+
+```ruby
+Sweph.julday(2024, 1, 1, 12.0)
+```
+
+---
+
+## Installation
+
+```bash
+gem install swisseph
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'swisseph'
+```
+
+### Build Requirements
+
+This gem requires **CMake 3.14 or later** to build from source. CMake is used to automatically download the Swiss Ephemeris library from GitHub during installation.
+
+**Installing CMake:**
+- **macOS:** `brew install cmake`
+- **Ubuntu/Debian:** `sudo apt-get install cmake`
+- **Windows:** Download from [cmake.org](https://cmake.org/download/)
+
+---
+
+## Quick Examples
+
+### Calculate Planetary Position
+```ruby
+require 'swisseph'
+
+# Get Julian day for May 14, 2012 at 10:15
+jd = Sweph.julday(2012, 5, 14, 10.25)
+
+# Calculate Sun position using Moshier ephemeris
+sun = Sweph.calc_ut(jd, Sweph::SE_SUN, Sweph::SEFLG_MOSEPH | Sweph::SEFLG_SPEED)
+
+puts "Sun longitude: #{sun[0]}°"
+puts "Sun latitude: #{sun[1]}°"
+```
+
+### Calculate House Cusps
+```ruby
+require 'swisseph'
+
+jd = Sweph.julday(2012, 5, 14, 10.25)
+lat, lon = 45.45, -112.18
+
+# Calculate Placidus houses
+cusps, angles = Sweph.houses(jd, lat, lon, 'P')
+
+puts "Ascendant: #{angles[0]}°"
+puts "House 1: #{cusps[1]}°"
+```
+
+---
+
+## Supported Functions
+
+The gem provides full coverage of the Swiss Ephemeris API. All functions are available in both `swe_prefix` and `shorthand` forms.
+
+| Category | Key Functions |
+| :--- | :--- |
+| **Planets** | `calc_ut`, `calc`, `get_orbital_elements`, `pheno_ut` |
+| **Fixed Stars** | `fixstar_ut`, `fixstar2_ut`, `fixstar_mag` |
+| **Houses** | `houses`, `houses_ex`, `house_pos`, `house_name` |
+| **Eclipses** | `sol_eclipse_when_glob`, `lun_eclipse_when`, `sol_eclipse_where` |
+| **Transits** | `solcross_ut`, `mooncross_ut`, `rise_trans` |
+| **Time** | `julday`, `revjul`, `utc_to_jd`, `deltat`, `sidtime` |
+| **Utilities** | `set_ephe_path`, `set_topo`, `get_planet_name`, `split_deg` |
+
+---
+
+## Constants
+
+The gem provides constants for planets, calculation flags, and more:
+
+```ruby
+# Bodies
+Swisseph::SE_SUN, SE_MOON, SE_MERCURY, SE_VENUS, SE_MARS...
+# Flags
+Swisseph::SEFLG_MOSEPH, SEFLG_SWIEPH, SEFLG_SPEED, SEFLG_SIDEREAL...
+# Houses
+'P' (Placidus), 'K' (Koch), 'E' (Equal), 'C' (Campanus)...
+```
+
+---
+
+## Ephemeris Files
+
+The **Moshier ephemeris** (`SEFLG_MOSEPH`) is built-in and requires no files.
+
+For high-precision calculations, a minimal set of Swiss Ephemeris data files is **automatically included** during installation. For extended time ranges or asteroid files, download them from [astro.com](https://www.astro.com/ftp/swisseph/ephe/) and configure:
+
+```ruby
+Sweph.set_ephe_path('/path/to/ephemeris/files')
+```
+
+## Documentation
+
+- [Swiss Ephemeris Programmer's Documentation](https://www.astro.com/swisseph/swephprg.htm)
+- [Official Library Homepage](http://www.astro.com/swisseph/)
+
+## License
+
+GPL-2.0-or-later. See [LICENSE](LICENSE) for details.
+Swiss Ephemeris library is (C) Astrodienst AG.

data/ext/swisseph/CMakeLists.txt

@@ -0,0 +1,117 @@
+cmake_minimum_required(VERSION 3.14)
+project(SwissEphemerisDownloader)
+
+# Include FetchContent module for downloading dependencies
+include(FetchContent)
+
+# Swiss Ephemeris version pinning
+# Use v2.10.3a as the latest stable release
+# Can be overridden via: cmake -DSWISSEPH_VERSION=<tag>
+set(SWISSEPH_VERSION "v2.10.3a" CACHE STRING "Swiss Ephemeris version tag")
+
+# Fetch Swiss Ephemeris from GitHub
+FetchContent_Declare(
+  swisseph
+  GIT_REPOSITORY https://github.com/aloistr/swisseph.git
+  GIT_TAG        ${SWISSEPH_VERSION}
+  GIT_SHALLOW    TRUE  # Only fetch the specific tag, not full history
+  SOURCE_DIR     ${CMAKE_CURRENT_SOURCE_DIR}/swisseph_src
+)
+
+message(STATUS "Fetching Swiss Ephemeris ${SWISSEPH_VERSION} from GitHub...")
+FetchContent_MakeAvailable(swisseph)
+
+# List of C source files to copy (exclude utility programs)
+set(SWEPH_SOURCES
+  swecl.c
+  swedate.c
+  sweephe4.c
+  swehel.c
+  swehouse.c
+  swejpl.c
+  swemmoon.c
+  swemplan.c
+  sweph.c
+  swephlib.c
+)
+
+# List of header files to copy
+set(SWEPH_HEADERS
+  swedate.h
+  swedll.h
+  sweephe4.h
+  swehouse.h
+  swejpl.h
+  swemptab.h
+  swenut2000a.h
+  sweodef.h
+  sweph.h
+  swephexp.h
+  swephlib.h
+  swevents.h
+)
+
+# Copy source files from fetched directory to ext/swisseph
+foreach(src_file ${SWEPH_SOURCES})
+  configure_file(
+    ${swisseph_SOURCE_DIR}/${src_file}
+    ${CMAKE_CURRENT_SOURCE_DIR}/${src_file}
+    COPYONLY
+  )
+endforeach()
+
+# Copy header files
+foreach(hdr_file ${SWEPH_HEADERS})
+  configure_file(
+    ${swisseph_SOURCE_DIR}/${hdr_file}
+    ${CMAKE_CURRENT_SOURCE_DIR}/${hdr_file}
+    COPYONLY
+  )
+endforeach()
+
+# Copy data files from root directory
+configure_file(
+  ${swisseph_SOURCE_DIR}/agpl-3.0.txt
+  ${CMAKE_CURRENT_SOURCE_DIR}/agpl-3.0.txt
+  COPYONLY
+)
+
+configure_file(
+  ${swisseph_SOURCE_DIR}/seleapsec.txt
+  ${CMAKE_CURRENT_SOURCE_DIR}/seleapsec.txt
+  COPYONLY
+)
+
+# Copy sefstars.txt from ephe/ subdirectory
+configure_file(
+  ${swisseph_SOURCE_DIR}/ephe/sefstars.txt
+  ${CMAKE_CURRENT_SOURCE_DIR}/sefstars.txt
+  COPYONLY
+)
+
+# Copy ephemeris data files from ephe/ directory
+set(SWEPH_EPHE_FILES
+  seas_18.se1
+  seasm18.se1
+  semo_18.se1
+  semom18.se1
+  sepl_18.se1
+  seplm18.se1
+)
+
+foreach(ephe_file ${SWEPH_EPHE_FILES})
+  if(EXISTS ${swisseph_SOURCE_DIR}/ephe/${ephe_file})
+    configure_file(
+      ${swisseph_SOURCE_DIR}/ephe/${ephe_file}
+      ${CMAKE_CURRENT_SOURCE_DIR}/${ephe_file}
+      COPYONLY
+    )
+  else()
+    message(WARNING "Ephemeris file not found: ${ephe_file}")
+  endif()
+endforeach()
+
+message(STATUS "Swiss Ephemeris sources and data files copied successfully")
+
+# Create a stamp file to indicate successful fetch
+file(WRITE ${CMAKE_CURRENT_SOURCE_DIR}/.swisseph_fetched "${SWISSEPH_VERSION}")

data/ext/swisseph/extconf.rb

@@ -0,0 +1,67 @@
+require 'mkmf'
+require 'fileutils'
+
+# Check if CMake is available
+def cmake_available?
+  system('cmake --version > /dev/null 2>&1')
+end
+
+# Run CMake to fetch Swiss Ephemeris sources
+def fetch_swisseph_with_cmake
+  puts "Fetching Swiss Ephemeris sources with CMake..."
+
+  build_dir = File.join(__dir__, 'cmake_build')
+  FileUtils.mkdir_p(build_dir)
+
+  # Configure CMake
+  unless system("cmake -S #{__dir__} -B #{build_dir}")
+    raise "CMake configuration failed. Please ensure CMake 3.14+ is installed."
+  end
+
+  # Build (which triggers FetchContent)
+  unless system("cmake --build #{build_dir}")
+    raise "CMake build failed."
+  end
+
+  # Verify sources were fetched
+  stamp_file = File.join(__dir__, '.swisseph_fetched')
+  unless File.exist?(stamp_file)
+    raise "Swiss Ephemeris sources not fetched successfully."
+  end
+
+  # Clean up build directory (keep fetched sources)
+  FileUtils.rm_rf(build_dir)
+
+  puts "Swiss Ephemeris sources fetched successfully."
+end
+
+# Check if Swiss Ephemeris sources need to be fetched
+stamp_file = File.join(__dir__, '.swisseph_fetched')
+swisseph_sources_exist = File.exist?(File.join(__dir__, 'sweph.c'))
+
+if !swisseph_sources_exist || !File.exist?(stamp_file)
+  unless cmake_available?
+    raise <<~ERROR
+      CMake is required to build this gem but was not found.
+
+      Please install CMake 3.14 or later:
+      - macOS: brew install cmake
+      - Ubuntu/Debian: sudo apt-get install cmake
+      - Or download from: https://cmake.org/download/
+    ERROR
+  end
+
+  fetch_swisseph_with_cmake
+end
+
+# Get all C source files, excluding utility programs
+$srcs = Dir.glob('*.c').select { |f|
+  !['swephgen4.c', 'swemini.c', 'sweasp.c', 'swevents.c', 'swetest.c'].include?(f)
+}
+
+# Verify we have the necessary sources
+if $srcs.empty? || !$srcs.include?('swisseph.c')
+  raise "Required Swiss Ephemeris source files (swisseph.c) not found. Build cannot proceed."
+end
+
+create_makefile("swisseph/swisseph")