nice 0.0.7 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 453be594423ebb52c2d2f79176d99ccf45978a186866c05b95865570753b2af4
+  data.tar.gz: 94dd016e6281da05dcc3ec203069c6618d47930a9b021357c1eac76e547daf3b
+SHA512:
+  metadata.gz: b2099b60716dd2bb8e2b053e5e33bd7f633259b7ba2b26ff4bd2fe14024d4a31211fbe6d94980b6a5e99cc5f75e91fa416f917de0aad96f7f0ad87245265c13e
+  data.tar.gz: 32c4dd74d029529ef5439787bfb8233ab34b22439de997bd53fdb1867e4cd9761d041525eecd23128fe17663461610de2c218e74dc9c475c10c7bf08acaf2984

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--color
+--format documentation

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 1.0.0 (2026-02-12)
+
+
+### Features
+
+* add simple Nice client for CKAN data ([#1](https://github.com/nicolasleger/nice/issues/1)) ([2a7a318](https://github.com/nicolasleger/nice/commit/2a7a3185c7dc799d2b59e5320c97a0697e7de985))

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gemspec
+
+# Use nicolasleger updated CKAN fork for v3 API support
+gem 'ckan', github: 'nicolasleger/ckan', branch: 'feat/add-ckan-v3-support'

data/Gemfile.lock

@@ -0,0 +1,162 @@
+GIT
+  remote: https://github.com/nicolasleger/ckan.git
+  revision: 0f89d5f23b62b83c98b5371d9243e36c2d42839e
+  branch: feat/add-ckan-v3-support
+  specs:
+    ckan (0.0.3)
+
+PATH
+  remote: .
+  specs:
+    nice (0.1.0)
+      ckan
+      httparty (~> 0.21)
+      json (~> 2.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.0.1)
+    byebug (13.0.0)
+      reline (>= 0.6.0)
+    coderay (1.1.3)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    csv (3.3.5)
+    diff-lcs (1.6.2)
+    hashdiff (1.2.1)
+    httparty (0.24.2)
+      csv
+      mini_mime (>= 1.0.0)
+      multi_xml (>= 0.5.2)
+    io-console (0.8.2)
+    json (2.18.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    method_source (1.1.0)
+    mini_mime (1.1.5)
+    multi_xml (0.8.1)
+      bigdecimal (>= 3.1, < 5)
+    parallel (1.27.0)
+    parser (3.3.10.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    pry (0.16.0)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+      reline (>= 0.6.0)
+    pry-byebug (3.12.0)
+      byebug (~> 13.0)
+      pry (>= 0.13, < 0.17)
+    public_suffix (7.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.84.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    vcr (6.4.0)
+    webmock (3.26.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  ckan!
+  nice!
+  pry (~> 0.14)
+  pry-byebug (~> 3.10)
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.50)
+  vcr (~> 6.0)
+  webmock (~> 3.0)
+
+CHECKSUMS
+  addressable (2.8.8) sha256=7c13b8f9536cf6364c03b9d417c19986019e28f7c00ac8132da4eb0fe393b057
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
+  byebug (13.0.0) sha256=d2263efe751941ca520fa29744b71972d39cbc41839496706f5d9b22e92ae05d
+  ckan (0.0.3)
+  coderay (1.1.3) sha256=dc530018a4684512f8f38143cd2a096c9f02a1fc2459edcfe534787a7fc77d4b
+  crack (1.0.1) sha256=ff4a10390cd31d66440b7524eb1841874db86201d5b70032028553130b6d4c7e
+  csv (3.3.5) sha256=6e5134ac3383ef728b7f02725d9872934f523cb40b961479f69cf3afa6c8e73f
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  hashdiff (1.2.1) sha256=9c079dbc513dfc8833ab59c0c2d8f230fa28499cc5efb4b8dd276cf931457cd1
+  httparty (0.24.2) sha256=8fca6a54aa0c4aa4303a0fd33e5e2156175d6a5334f714263b458abd7fda9c38
+  io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
+  json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  method_source (1.1.0) sha256=181301c9c45b731b4769bc81e8860e72f9161ad7d66dd99103c9ab84f560f5c5
+  mini_mime (1.1.5) sha256=8681b7e2e4215f2a159f9400b5816d85e9d8c6c6b491e96a12797e798f8bccef
+  multi_xml (0.8.1) sha256=addba0290bac34e9088bfe73dc4878530297a82a7bbd66cb44dcd0a4b86edf5a
+  nice (0.1.0)
+  parallel (1.27.0) sha256=4ac151e1806b755fb4e2dc2332cbf0e54f2e24ba821ff2d3dcf86bf6dc4ae130
+  parser (3.3.10.1) sha256=06f6a725d2cd91e5e7f2b7c32ba143631e1f7c8ae2fb918fc4cebec187e6a688
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  pry (0.16.0) sha256=d76c69065698ed1f85e717bd33d7942c38a50868f6b0673c636192b3d1b6054e
+  pry-byebug (3.12.0) sha256=594e094ae8a8390a7ad4c7b36ae36e13304ed02664c67417d108dc5f7213d1b7
+  public_suffix (7.0.2) sha256=9114090c8e4e7135c1fd0e7acfea33afaab38101884320c65aaa0ffb8e26a857
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
+  reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
+  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.7) sha256=0979034e64b1d7a838aaaddf12bf065ea4dc40ef3d4c39f01f93ae2c66c62b1c
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.84.1) sha256=14cc626f355141f5a2ef53c10a68d66b13bb30639b26370a76559096cc6bcc1a
+  rubocop-ast (1.49.0) sha256=49c3676d3123a0923d333e20c6c2dbaaae2d2287b475273fddee0c61da9f71fd
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  vcr (6.4.0) sha256=077ac92cc16efc5904eb90492a18153b5e6ca5398046d8a249a7c96a9ea24ae6
+  webmock (3.26.1) sha256=4f696fb57c90a827c20aadb2d4f9058bbff10f7f043bd0d4c3f58791143b1cd7
+
+BUNDLED WITH
+  4.0.6

data/LICENSE

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

data/README.md

@@ -1,147 +1,141 @@
-# Nice \[franz. nis\]
+# nice
 
-## What?
+A Ruby gem for accessing and managing OpenData from Nice Côte d'Azur (NCA) metropolitan area via CKAN API.
 
-*Nice* is a light-weight engine which puts some *magic* into JS/AJAX driven Rails pages with the aim to ease the development of rich and interactive restful web applications.
+## Installation
 
-Go [here](http://nice.codebility.com) for an example and a detailed description.
+Add this line to your application's Gemfile:
 
-## How to use
+```ruby
+gem 'nice'
+```
 
-### Requirements
+And then execute:
 
-This gem was tested with **Rails 3.2** but should also work with Rails 3.1 which introduced the *Asset-Pipeline* used by this gem. 
-Furthermore, the current version uses **JQuery** to manipulate the DOM tree, so you should have the appropriate files in place. Although, it is easily possible to replace this by other frameworks (see *Contribution Section*) 
+    $ bundle install
 
-### Install
+Or install it yourself as:
 
-1. Add Gem dependency to your Gemfile
+    $ gem install nice
 
-	```ruby
-	#.Gemfile
+## Configuration
 
-	gem 'nice'
-	```
+Configure the gem with your CKAN instance URL and API key:
 
-2. Run 
+```ruby
+require 'nice'
 
-	```
-	bundle install
-	```
+Nice.configure do |config|
+  config.ckan_url = "https://opendata.nicecotedazur.org/data/"
+  config.api_key = "your-api-key-here"
+end
+```
 
-3. Add Middleware
+Alternatively, set environment variables:
 
-	```ruby
-	#config/application.rb
+```bash
+export NICE_CKAN_URL="https://opendata.nicecotedazur.org/data/"
+export NICE_CKAN_API_KEY="your-api-key-here"
+```
 
-	config.middleware.use Nice::Middleware
-	```
+## Usage
 
-4. Require Gem javascript in your applicaton.js manifest
+### Create a client
 
-	```js
-	//app/assets/javascripts/application.js
+```ruby
+client = Nice::Client.new
+```
 
-	//= require nice_jquery
-	```
+Or with direct credentials:
 
-### Basic Usage
+```ruby
+client = Nice::Client.new(
+  ckan_url: "https://opendata.nicecotedazur.org/data/",
+  api_key: "your-api-key-here"
+)
+```
 
-The idea is to combine all views of one controller into one layout file exactly as it was already possible with rails and make heavy use of **yield()** and **content_for** tags to include view specific content. 
-The convention of rails is to put a file named after your controller inside the *app/views/layouts/* folder. Such a file could look like this
+### List packages (datasets)
 
-```haml
--# app/views/layouts/books.html.haml
+```ruby
+packages = client.list_packages
+puts "Found #{packages.count} packages"
+```
 
-- content_for :content do
-  %div
-    .one{"data-state" => "get_books"}
-      %h1 Only visible in state index
-      = yield(:container1)
-    .two{"data-state" => "get_books_show"}
-      %h1 Only visible in state show
-      = yield(:container1)
+### Search for datasets
 
-= render :template => 'layouts/application'
+```ruby
+results = client.search_packages("transport")
+puts "Found #{results['count']} matches"
 ```
 
-```haml
--# app/views/layouts/application.html.haml
+### Get package details
 
-\#{content_for?(:content) ? yield(:content) : yield}
+```ruby
+package = client.get_package("package-id")
+puts package['title']
 ```
 
--  The *content_for* tag will make sure the following context gets rendered in the application layout file \(see [Rails Guide](http://guides.rubyonrails.org/layouts_and_rendering.html#using-nested-layouts) for a deeper understanding of nested layouts\).
--  *.one{"data-state" => "get_books"}* is [HAML](http://haml.info/) code to generate a DIV block with a HTML5 attribute **data-state**. This is the key part: The value of the **data-state** attribute *marks the state in which the annotated element should be included*. This attribute can also hold a list of *space-separated* state names.
--  *= yield(:container1)* is a placeholder where content from the view file will be inserted at runtime.
--  The last line is part of the nexted layout design and just makes sure that this *books* layout page gets rendered inside the application layout.
+### List organizations
 
-There is one golden rule when programming with this state engine:
+```ruby
+organizations = client.list_organizations
+```
 
-**All elements bounded to one or more states \(meaning that they are annotated with a *data-state* attribute\) must live in the *layout* file but not in a *view*!** 
+### Get organization details
 
-This restriction is imposed by the way how the middleware calculates reference points for elements but should normally not effect your workflow - just keep it in mind.
+```ruby
+org = client.get_organization("organization-id")
+```
 
-All links in your application should now use the ```:remote => :true``` attribute to ensure the requests will be sent using javascript by default.
+### List groups
 
-### State Transitions
+```ruby
+groups = client.list_groups
+```
 
-Nice offers the ability to make your state changes even smoother by using either JS and/or CSS. Every element inside a <code>data-state</code> with <code>data-state-transition=\"default\"</code> will be animated using the corresponding transition configuration. By default, a linear fade-in over 200ms is used, but you can override or configure any other property animation. You need to provide your configuration by creating some JS functions. I recommend using [coffee-script](http://coffeescript.org) and name the file *nice-transitions.js.coffee*:
+### Get resource details
 
+```ruby
+resource = client.get_resource("resource-id")
 ```
-class this.NiceTransitions
-	@default = 
-		duration: 1000
-		easing: "linear"
-		properties:
-			opacity: 0.0
-	
-	@fade_slow = 
-		duration: 2000
-		easing: "linear"			
-		properties:
-			opacity: 0.0
-			
-	@slide_top =
-		duration: 1000
-		easing: "swing"			
-		properties:
-			"top": "-200px"
-```			
 
-The body class gets the always a CSS class with the following naming convention assigned: <code>state-\{current_state_name\}</code>. You can use this to configure your styles per state like this:
+## Development
 
+After checking out the repo, run `bundle install` to install dependencies.
+
+### Running Tests
+
+Run the test suite:
+
+```bash
+bundle exec rspec
 ```
-.state-get_basic_a{
-	.set2, .set3{
-		opacity: 0.4;
-	}
-}
+
+Run tests with detailed output:
+
+```bash
+bundle exec rspec --format documentation
 ```
 
-### Features
+Run a specific test file:
+
+```bash
+bundle exec rspec spec/nice/client_spec.rb
+```
 
-*Nice* is still in early stages and there is truly a lot to do. If you feel intrested and want to contribute, please don't hestitate to start work on one of the following features or enhance existing ones. 
+### Linting
 
--  state annotation via HTML5 data attribute **data-state**
--  elements can belong to more than one state annotated by space separated list
--  naming convention for state names follows the appropriate REST route: method_controller_action
--  if an elements exist in the current and the following state it can be optionally left untouched with the **data-state-update** property set to *no*. Default is true.
--  automated Browser history management
--  javascript code for DOM manipulation is separated and can be replaced to use other frameworks easily \(just remove *nice_jquery* requirement in application.js manifest and put your own methods in place. Hava a look in *Nice-GEM/lib/assets/javascripts/dom_jquery.js.coffee* and *Nice-GEM/lib/assets/javascripts/dom_jquery.js.coffee* for the signature to implement\)
+Check code style with RuboCop:
 
-## Behind the scenes
+```bash
+bundle exec rubocop
+```
 
-Nice is a middleware which processes all HTML and JS requests by either removing non-state specific content from the rendered page or generates JS code to manipulate the DOM tree client side.
+## Contributing
 
-## Roadmap / Contribute
+Bug reports and pull requests are welcome.
 
--  css class manipulation and css3 transition support
--  test cases
--  customization of state names
--  customization of HTML5 attribute names
--  add more js events which can be catched by application
--  preloading of states (for elements which do not require updated backend data)
+## License
 
-# License
-This project rocks and uses MIT-LICENSE.
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,47 +1,6 @@
-#!/usr/bin/env rake
-begin
-  require 'bundler/setup'
-rescue LoadError
-  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
-end
-begin
-  require 'rdoc/task'
-rescue LoadError
-  require 'rdoc/rdoc'
-  require 'rake/rdoctask'
-  RDoc::Task = Rake::RDocTask
-end
-
-RDoc::Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'Nice'
-  rdoc.options << '--line-numbers'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-
-
-
-Bundler::GemHelper.install_tasks
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.libs << 'test'
-  t.pattern = 'test/integration/*_test.rb'
-  t.verbose = false
-end
-
-task :default => :test
-
-
-# rspec tests
-#require 'rspec/core/rake_task'
-
-#RSpec::Core::RakeTask.new(:spec)
-
-#task :default => :spec
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
+RSpec::Core::RakeTask.new(:spec)
 
+task default: :spec

data/lib/nice/client.rb

@@ -0,0 +1,51 @@
+require 'ckan'
+
+module Nice
+  class Client
+    attr_reader :ckan_url, :api_key
+
+    def initialize(ckan_url: nil, api_key: nil)
+      @ckan_url = ckan_url || Nice.configuration&.ckan_url
+      @api_key = api_key || Nice.configuration&.api_key
+
+      validate_credentials!
+
+      # add ending slash if missing
+      fixed_ckan_url = @ckan_url.end_with?('/') ? @ckan_url : "#{@ckan_url}/"
+      CKAN::API.api_url = fixed_ckan_url
+      CKAN::API.api_version = "3"
+      CKAN::API.api_key = @api_key
+    end
+
+    # List all package IDs (datasets)
+    def list_package_ids
+      CKAN::Package.find
+    rescue => e
+      raise APIError, "Failed to list packages: #{e.message}"
+    end
+
+    # Get package details
+    def get_package(package_or_id)
+      package_id = package_or_id.is_a?(CKAN::Package) ? package_or_id.id : package_or_id
+      package = CKAN::Package.find(package_id)
+      {
+        'id' => package.id,
+        'name' => package.name,
+        'title' => package.title,
+        'resources' => package.resources
+      }
+    rescue => e
+      raise APIError, "Failed to get package: #{e.message}"
+    end
+
+    private
+
+    def validate_credentials!
+      raise ConfigurationError, "CKAN URL is required" if @ckan_url.nil? || @ckan_url.empty?
+
+      # API key is not mandatory for public datasets, so we won't raise an error if it's missing.
+      # However, we might check if it's provided and warn if not, depending on the use case.
+      # raise ConfigurationError, "API key is required" if @api_key.nil? || @api_key.empty?
+    end
+  end
+end

data/lib/nice/version.rb

@@ -1,3 +1,3 @@
 module Nice
-  VERSION = "0.0.7"
+  VERSION = "0.1.0"
 end

data/lib/nice.rb

@@ -1,5 +1,33 @@
-require 'nice/middleware'
-require 'nice/engine'
+require 'ckan'
+require_relative 'nice/client'
+require_relative 'nice/version'
 
 module Nice
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class APIError < Error; end
+
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
+
+  class Configuration
+    attr_accessor :ckan_url, :api_key
+
+    def initialize
+      @ckan_url = ENV['NICE_CKAN_URL'] || 'https://opendata.nicecotedazur.org/data/'
+
+      @api_key = ENV['NICE_CKAN_API_KEY']
+    end
+
+    def validate!
+      raise ConfigurationError, "CKAN URL is required" if ckan_url.nil? || ckan_url.empty?
+      raise ConfigurationError, "API key is required" if api_key.nil? || api_key.empty?
+    end
+  end
 end

data/nice.gemspec

@@ -0,0 +1,43 @@
+require_relative "lib/nice/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "nice"
+  spec.version       = Nice::VERSION
+  spec.authors       = ["Nicolas Leger"]
+  spec.email         = ["nicolasleger@users.noreply.github.com"]
+
+  spec.summary       = "OpenData NCA - Métropole Nice Côte d'Azur"
+  spec.description   = "A Ruby gem for accessing and managing OpenData from Nice Côte d'Azur metropolitan area via CKAN API"
+  spec.homepage      = "https://github.com/nicolasleger/nice"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/nicolasleger/nice"
+  spec.metadata["changelog_uri"] = "https://github.com/nicolasleger/nice/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # CKAN dependency
+  spec.add_dependency "ckan"
+  
+  # Additional useful dependencies
+  spec.add_dependency "httparty", "~> 0.21"
+  spec.add_dependency "json", "~> 2.6"
+
+  # Development dependencies
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rubocop", "~> 1.50"
+  spec.add_development_dependency "vcr", "~> 6.0"
+  spec.add_development_dependency "webmock", "~> 3.0"
+  spec.add_development_dependency "pry", "~> 0.14"
+  spec.add_development_dependency "pry-byebug", "~> 3.10"
+end