capistrano-symfony-asset-mapper 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9b773119a0849a1922bb6348c4707c64705635d3813cba66ee4a21c201565a89
+  data.tar.gz: da6887e5254f93ad9fbaf7fa0e38f9a008ff49512dbb54bffae48f2680ef08eb
+SHA512:
+  metadata.gz: 7f9bbc36ae378e8539801de42d68643dda3c1b85e1d95e4db6b8115b8f10cf34c0c9f7ba7da2f40da31cc5fecb39d7f31a27c8fe369c384b522daf18d959265f
+  data.tar.gz: fb1284c139c995c2523c2176b8a67849087e939a5ffc609fe3618fb06df71d0ea7ce5b9f15ad320b7e10b8c23a65def84daa5bf1f1089ca67656aee191581af1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.2.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capistrano-php-fpm.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,44 @@
+PATH
+  remote: .
+  specs:
+    capistrano-asset-mapper (0.1.0)
+      capistrano (>= 3.1.0)
+      capistrano-symfony (>= 0.4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    airbrussh (1.3.0)
+      sshkit (>= 1.6.1, != 1.7.0)
+    capistrano (3.9.0)
+      airbrussh (>= 1.0.0)
+      i18n
+      rake (>= 10.0.0)
+      sshkit (>= 1.9.0)
+    capistrano-composer (0.0.6)
+      capistrano (>= 3.0.0.pre)
+    capistrano-file-permissions (0.1.1)
+      capistrano (~> 3.1)
+    capistrano-symfony (0.4.0)
+      capistrano (~> 3.1)
+      capistrano-composer (~> 0.0.3)
+      capistrano-file-permissions (~> 0.1.0)
+    i18n (0.8.6)
+    net-scp (1.2.1)
+      net-ssh (>= 2.6.5)
+    net-ssh (4.1.0)
+    rake (10.5.0)
+    sshkit (1.14.0)
+      net-scp (>= 1.1.2)
+      net-ssh (>= 2.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10)
+  capistrano-asset-mapper!
+  rake (~> 10.0)
+
+BUNDLED WITH
+   1.14.6

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 glooby
+
+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

@@ -0,0 +1,149 @@
+# **Capistrano::Symfony::AssetMapper**
+
+[![Gem Version](https://badge.fury.io/rb/capistrano-asset-mapper.svg)](https://badge.fury.io/rb/capistrano-asset-mapper)
+
+**Seamless Integration for Symfony Asset Mapper in Capistrano Deployments**
+
+This gem extends Capistrano 3.x to support Symfony's Asset Mapper and SASS build tools, automating tasks like asset installation, compilation, and SASS-to-CSS builds during deployments. It's an essential tool for modern Symfony applications that utilize the Asset Mapper.
+
+---
+
+## **Installation**
+
+Before using this gem, ensure that Capistrano is properly set up in your project. Then, add the following lines to your `Gemfile`:
+
+```ruby
+gem 'capistrano', '~> 3.1.0'
+gem 'capistrano-symfony'
+gem 'capistrano-asset-mapper'
+```
+
+Run `bundle` to install the dependencies:
+
+```bash
+$ bundle
+```
+
+Or install the gem manually:
+
+```bash
+$ gem install capistrano-asset-mapper
+```
+
+---
+
+## **Usage**
+
+### **Requiring the Gem**
+
+To use the default tasks, require the gem in your `Capfile`:
+
+```ruby
+require 'capistrano/symfony'
+require 'capistrano/asset-mapper'
+```
+
+---
+
+### **Hooks Execution**
+
+The gem integrates with Capistrano’s deployment lifecycle. The following hooks are added automatically:
+
+```ruby
+after 'deploy:updated', 'symfony:asset_mapper:install'
+after 'deploy:updated', 'symfony:asset_mapper:sass_build'
+after 'deploy:updated', 'symfony:asset_mapper:compile'
+```
+
+These hooks perform the following tasks:
+- **`importmap:install`**: Installs JavaScript dependencies.
+- **`sass:build`**: Compiles SASS files into CSS.
+- **`asset-map:compile`**: Compiles asset mappings for production.
+
+---
+
+### **Disabling Hooks**
+
+If you want to skip these tasks during deployment (e.g., in non-production environments), you can disable them by setting the following variable in your `deploy.rb` or an environment-specific file (e.g., `config/deploy/production.rb`):
+
+```ruby
+set :enable_symfony_asset_mapper_hooks, false
+```
+
+Alternatively, you can disable the hooks for a single deployment by running:
+
+```bash
+cap production deploy enable_symfony_asset_mapper_hooks=false
+```
+
+---
+
+### **Server Configuration**
+
+Ensure that the server running the asset mapper tasks has the `web` role. For example:
+
+```ruby
+server 'node1.example.com', user: 'deploy', roles: %w{web}
+server 'node2.example.com', user: 'deploy', roles: %w{web}
+server 'node3.example.com', user: 'deploy', roles: %w{web}
+```
+
+This configuration ensures that tasks are executed only on servers with the `web` role.
+
+---
+
+### **Configurable Options**
+
+You can customize the behavior of the gem using the following options:
+
+```ruby
+# Enable or disable Symfony Asset Mapper hooks globally
+set :enable_symfony_asset_mapper_hooks, true
+
+# Flags for the Symfony importmap:install command
+set :symfony_importmap_install_flags, '--no-interaction --no-debug'
+
+# Flags for the Symfony sass:build command
+set :symfony_sass_build_flags, '--no-interaction --no-debug'
+
+# Flags for the Symfony asset-map:compile command
+set :symfony_asset_map_compile_flags, '--no-interaction --no-debug'
+```
+
+---
+
+## **Development**
+
+To install this gem onto your local machine, run:
+
+```bash
+$ bundle exec rake install
+```
+
+To release a new version:
+1. Update the version number in `capistrano-asset-mapper.gemspec`.
+2. Run:
+
+```bash
+$ bundle exec rake release
+```
+
+This command will create a git tag for the version, push commits and tags, and publish the `.gem` file to [RubyGems](https://rubygems.org).
+
+---
+
+## **Contributing**
+
+We welcome contributions to improve this gem! To contribute:
+1. Fork the repository.
+2. Create your feature branch: `git checkout -b my-new-feature`.
+3. Commit your changes: `git commit -am 'Add some feature'`.
+4. Push the branch: `git push origin my-new-feature`.
+5. Create a pull request.
+
+---
+
+## **License**
+
+This gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/capistrano-symfony-asset-mapper.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "capistrano-symfony-asset-mapper"
+  spec.version       = '0.1.0'  # Version initiale
+  spec.authors       = ["Ahmed EBEN HASSINE"]
+  spec.email         = ["ahmedbhs123@gmail.com"]
+
+  spec.summary       = %q{AssetMapper & sass build support for Capistrano 3.x}
+  spec.description   = %q{Provides integration for AssetMapper and Sass build support in Capistrano 3.x environments.}
+  spec.license       = "MIT"
+  spec.homepage      = "https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper"
+
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = "https://rubygems.org"
+    spec.metadata['homepage_uri'] = spec.homepage
+    spec.metadata['source_code_uri'] = "https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper"
+    spec.metadata['changelog_uri'] = "https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper/CHANGELOG.md"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'capistrano', '~> 3.1', '>= 3.1.0'
+  spec.add_dependency 'capistrano-symfony', '~> 0.4', '>= 0.4.0'
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/capistrano/symfony-asset-mapper.rb

@@ -0,0 +1 @@
+load File.expand_path('../tasks/symfony-asset-mapper.rake', __FILE__)

data/lib/capistrano/tasks/symfony-asset-mapper.rake

@@ -0,0 +1,39 @@
+namespace :symfony do
+  namespace :asset_mapper do
+    desc "Install JavaScript dependencies using ImportMap"
+    task :install do
+      on roles(:web) do
+        symfony_console "importmap:install", fetch(:symfony_importmap_install_flags)
+      end
+    end
+
+    desc "Compile SASS files into CSS"
+    task :sass_build do
+      on roles(:web) do
+        symfony_console "sass:build", fetch(:symfony_sass_build_flags)
+      end
+    end
+
+    desc "Compile asset mappings for production"
+    task :compile do
+      on roles(:web) do
+        symfony_console "asset-map:compile", fetch(:symfony_asset_map_compile_flags)
+      end
+    end
+  end
+end
+
+namespace :load do
+  desc "Set default flags for Symfony asset tasks"
+  task :defaults do
+    set :enable_symfony_asset_mapper_hooks, true
+    set :symfony_importmap_install_flags, '--no-interaction --no-debug'
+    set :symfony_sass_build_flags, '--no-interaction --no-debug'
+    set :symfony_asset_map_compile_flags, '--no-interaction --no-debug'
+  end
+end
+
+# Hooks pour exécuter automatiquement les tâches
+after 'deploy:updated', 'symfony:asset_mapper:install' if fetch(:enable_symfony_asset_mapper_hooks)
+after 'deploy:updated', 'symfony:asset_mapper:sass_build' if fetch(:enable_symfony_asset_mapper_hooks)
+after 'deploy:updated', 'symfony:asset_mapper:compile' if fetch(:enable_symfony_asset_mapper_hooks)

data/script/bootstrap

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+bundle install

data/script/release

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+rake release

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-symfony-asset-mapper
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ahmed EBEN HASSINE
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2024-12-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: capistrano-symfony
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Provides integration for AssetMapper and Sass build support in Capistrano
+  3.x environments.
+email:
+- ahmedbhs123@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- capistrano-symfony-asset-mapper.gemspec
+- lib/capistrano/symfony-asset-mapper.rb
+- lib/capistrano/tasks/symfony-asset-mapper.rake
+- script/bootstrap
+- script/release
+homepage: https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper
+  source_code_uri: https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper
+  changelog_uri: https://github.com/ahmed-bhs/capistrano-symfony-asset-mapper/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: AssetMapper & sass build support for Capistrano 3.x
+test_files: []