appsignal 2.5.0.alpha.1-java

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012-2017 AppSignal
+
+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,264 @@
+# AppSignal for Ruby
+
+AppSignal solves all your Ruby monitoring needs in a single tool. You and your
+team can focus on writing code and we'll provide the alerts if your app has any
+issues.
+
+- [AppSignal.com website][appsignal]
+- [Documentation][docs]
+- [Support][contact]
+
+[![Build Status](https://travis-ci.org/appsignal/appsignal-ruby.png?branch=master)](https://travis-ci.org/appsignal/appsignal-ruby)
+[![Gem Version](https://badge.fury.io/rb/appsignal.svg)](http://badge.fury.io/rb/appsignal)
+[![Code Climate](https://codeclimate.com/github/appsignal/appsignal.png)](https://codeclimate.com/github/appsignal/appsignal)
+
+## Description
+
+The AppSignal gem collects exceptions and performance data from your Ruby
+applications and sends it to [AppSignal][appsignal] for analysis. Get alerted
+when an error occurs or an endpoint is responding very slowly.
+
+AppSignal aims to provide a one stop solution to all your monitoring needs.
+Track metrics from your servers with our [Host metrics][host-metrics] and graph
+everything else with our [Custom metrics][custom-metrics] feature.
+
+## Usage
+
+First make sure you've installed AppSignal in your application by following the
+steps in [Installation](#installation).
+
+AppSignal will automatically monitor requests, report any exceptions that are
+thrown and any performance issues that might have occurred.
+
+You can also add extra information to requests by adding custom instrumentation
+and by adding tags.
+
+### Track any error
+
+Catch any error and report it to AppSignal, even if it doesn't crash a
+request.
+
+```ruby
+begin
+  config = File.read("config.yml")
+rescue => e
+  Appsignal.set_error(e)
+  # Load alternative config
+  config = { :name => ENV["NAME"] }
+end
+```
+
+Read more about [Exception handling][exception-handling] in our documentation.
+
+### Tagging
+
+Need more information with errors and performance issues? Add tags to your
+requests to identify common factors for problems.
+
+```ruby
+Appsignal.tag_request(
+  user: current_user.id,
+  locale: I18n.locale
+)
+```
+
+Read more about [Tagging][tagging] in our documentation.
+
+### Custom instrumentation
+
+If you need more fine-grained instrumentation you can add custom
+instrumentation anywhere in your code.
+
+```ruby
+# Simple instrumentation
+Appsignal.instrument("array_to_hash.expensive_logic", "Complex calculations") do
+  array = [["a", 1], ["b", 2], ["c", 3]]
+  Hash[array]
+end
+
+# Add the query that you're monitoring
+sql = "SELECT * FROM posts ORDER BY created_at DESC LIMIT 1"
+Appsignal.instrument("fetch.custom_database", "Fetch latest post", sql) do
+  # ...
+end
+
+# Nested instrumentation calls are also supported!
+Appsignal.instrument("fetch.custom_database", "Fetch current user") do
+  # ...
+
+  Appsignal.instrument("write.custom_database", "Write user update") do
+    # ...
+  end
+end
+```
+
+Read more about [custom instrumentation][custom-instrumentation] in our
+documentation.
+
+## Installation
+
+First, [sign up][appsignal-sign-up] for an AppSignal account and add the
+`appsignal` gem to your `Gemfile`. Then, run `bundle install`.
+
+```ruby
+# Gemfile
+gem "appsignal"
+```
+
+Afterward, you can use the `appsignal install` command to install AppSignal
+into your application by using the "Push API key". This will guide you through
+our installation wizard.
+
+```sh
+appsignal install [push api key]
+```
+
+Depending on what framework or gems you use some manual integration is
+required. Follow the steps in the wizard or consult our [integrations] page for
+help.
+
+If you're stuck feel free to [contact us][contact]!
+
+## Supported frameworks and gems
+
+AppSignal automatically supports a collection of Ruby frameworks and gems,
+including but not limited to:
+
+- Ruby on Rails
+- Rack
+- Sinatra
+- Padrino
+- Grape
+- Webmachine
+- Capistrano
+- Sidekiq
+- Delayed Job
+- Resque
+- Rake
+
+AppSignal instrumentation doesn't depend on automatic integrations. It's easy
+to set up [custom instrumentation][custom-instrumentation] to add keep track of
+anything.
+
+For more detailed information and examples please visit our
+[integrations] page.
+
+### Front-end monitoring (Beta)
+
+We have a [Front-end monitoring program][front-end-monitoring] running in Beta
+currently. Be sure to check it out!
+
+## Supported systems
+
+Currently the AppSignal agent works on most Unix-like operating systems, such
+as most Linux distributions, FreeBSD, macOS, excluding Microsoft Windows.
+
+For more detailed information please visit our [Supported
+systems][supported-systems] page.
+
+## Development
+
+### Installation
+
+Make sure you have Bundler installed and then use the Rake install task to
+install all possible dependencies.
+
+```bash
+# Install Bundler
+gem install bundler
+# Install the AppSignal extension and _all_ gems we support.
+bundle exec rake install
+# Only install the AppSignal extension.
+bundle exec rake extension:install
+```
+
+### Testing
+
+```bash
+bundle exec rspec
+# Or with one file
+bundle exec rspec spec/lib/appsignal_spec.rb
+```
+
+Note that some specs depend on certain other gems to run and if they are not
+loaded RSpec will not run them. See also [Testing with other
+gems](#testing-with-other-gems).
+
+#### Testing with other gems
+
+AppSignal runs in many different configurations. To replicate these
+configurations you need to run the spec suite with a specific Gemfile.
+
+```
+BUNDLE_GEMFILE=gemfiles/capistrano2.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/capistrano3.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/grape.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/no_dependencies.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/padrino.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails-3.2.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails-4.0.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails-4.1.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails-4.2.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails-5.0.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/resque.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/sequel-435.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/sequel.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/sinatra.gemfile bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/webmachine.gemfile bundle exec rspec
+```
+
+If you have either [RVM][rvm] or [rbenv][rbenv] installed you can also use
+`rake generate_bundle_and_spec_all` to generate a script that runs specs for
+all Ruby versions and gem combinations we support.
+
+We run the suite against all of the Gemfiles mentioned above and on
+a number of different Ruby versions.
+
+### Versioning
+
+This gem uses [Semantic Versioning][semver].
+
+The `master` branch corresponds to the current stable release of the gem.
+
+The `develop` branch is used for development of features that will end up in
+the next minor release.
+
+Open a Pull Request on the `master` branch if you're fixing a bug. For new new
+features, open a Pull Request on the `develop` branch.
+
+Every stable and unstable release is tagged in git with a version tag.
+
+## Contributing
+
+Thinking of contributing to our gem? Awesome! 🚀
+
+Please follow our [Contributing guide][contributing-guide] in our
+documentation.
+
+Also, we would be very happy to send you Stroopwafles. Have look at everyone
+we send a package to so far on our [Stroopwafles page][waffles-page].
+
+## Support
+
+[Contact us][contact] and speak directly with the engineers working on
+AppSignal. They will help you get set up, tweak your code and make sure you get
+the most out of using AppSignal.
+
+[appsignal]: https://appsignal.com
+[appsignal-sign-up]: https://appsignal.com/users/sign_up
+[contact]: mailto:support@appsignal.com
+[waffles-page]: https://appsignal.com/waffles
+[docs]: http://docs.appsignal.com
+[contributing-guide]: http://docs.appsignal.com/appsignal/contributing.html
+[supported-systems]: http://docs.appsignal.com/support/operating-systems.html
+[integrations]: http://docs.appsignal.com/ruby/integrations/index.html
+[custom-instrumentation]: http://docs.appsignal.com/ruby/instrumentation/
+[front-end-monitoring]: http://docs.appsignal.com/front-end/error-handling.html
+[exception-handling]: http://docs.appsignal.com/ruby/instrumentation/exception-handling.html
+[tagging]: http://docs.appsignal.com/ruby/instrumentation/tagging.html
+[host-metrics]: http://docs.appsignal.com/metrics/host.html
+[custom-metrics]: http://docs.appsignal.com/metrics/custom.html
+
+[semver]: http://semver.org/
+[rvm]: http://rvm.io/
+[rbenv]: https://github.com/rbenv/rbenv

data/Rakefile

@@ -0,0 +1,214 @@
+require "bundler"
+require "fileutils"
+
+GEMFILES = %w[
+  capistrano2
+  capistrano3
+  grape
+  no_dependencies
+  padrino
+  rails-3.2
+  rails-4.0
+  rails-4.1
+  rails-4.2
+  rails-5.0
+  resque
+  sequel
+  sequel-435
+  sinatra
+  grape
+  webmachine
+  que
+].freeze
+
+RUBY_VERSIONS = %w[
+  2.0.0-p648
+  2.1.8
+  2.2.4
+  2.3.0
+  2.4.0
+].freeze
+
+EXCLUSIONS = {
+  "rails-5.0" => %w[2.0.0 2.1.8]
+}.freeze
+
+VERSION_MANAGERS = {
+  :rbenv => ->(version) { "rbenv local #{version}" },
+  :rvm => ->(version) { "rvm use --default #{version.split("-").first}" }
+}.freeze
+
+task :publish do
+  require "appsignal/version"
+
+  NAME = "appsignal".freeze
+  VERSION_FILE = "lib/appsignal/version.rb".freeze
+  CHANGELOG_FILE = "CHANGELOG.md".freeze
+
+  raise "$EDITOR should be set" unless ENV["EDITOR"]
+
+  def build_and_push_gem
+    puts "# Building gem"
+    FileUtils.rm_f("#{NAME}-#{gem_version}.gem")
+    puts `gem build #{NAME}.gemspec`
+    puts "# Publishing Gem"
+    puts `gem push #{NAME}-#{gem_version}.gem`
+  end
+
+  def create_and_push_tag
+    puts `git commit -am 'Bump to #{version} [ci skip]'`
+    puts "# Creating tag #{version}"
+    puts `git tag #{version}`
+    puts `git push origin #{version}`
+    puts `git push origin #{current_branch}`
+  rescue
+    raise "Tag: '#{version}' already exists"
+  end
+
+  def changes
+    git_status_to_array(`git status -s -u`)
+  end
+
+  def gem_version
+    Appsignal::VERSION
+  end
+
+  def version
+    @version ||= "v#{gem_version}"
+  end
+
+  def current_branch
+    `git rev-parse --abbrev-ref HEAD`.chomp
+  end
+
+  def git_status_to_array(changes)
+    changes.split("\n").each { |change| change.gsub!(/^.. /, "") }
+  end
+
+  raise "Branch should hold no uncommitted file change)" unless changes.empty?
+
+  system("$EDITOR #{VERSION_FILE}")
+  unless changes.member?(VERSION_FILE)
+    raise "Actually change the version in: #{VERSION_FILE}"
+  end
+
+  Appsignal.send(:remove_const, :VERSION)
+  load File.expand_path(VERSION_FILE)
+  system("$EDITOR #{CHANGELOG_FILE}")
+
+  # Build and push for MRI
+  ENV.delete("APPSIGNAL_PUSH_JAVA_GEM")
+  build_and_push_gem
+
+  # Build and push for jRuby
+  ENV["APPSIGNAL_PUSH_JAVA_GEM"] = "true"
+  build_and_push_gem
+
+  # Create tag
+  create_and_push_tag
+end
+
+desc "Install the AppSignal gem, extension and all possible dependencies."
+task :install => "extension:install" do
+  Bundler.with_clean_env do
+    GEMFILES.each do |gemfile|
+      system "bundle --gemfile gemfiles/#{gemfile}.gemfile"
+    end
+  end
+end
+
+task :spec_all_gemfiles do
+  GEMFILES.each do |gemfile|
+    puts "Running tests for #{gemfile}"
+    unless system("env BUNDLE_GEMFILE=gemfiles/#{gemfile}.gemfile bundle exec rspec")
+      raise "Not successful"
+    end
+  end
+end
+
+task :generate_bundle_and_spec_all do
+  VERSION_MANAGERS.each do |version_manager, switch_command|
+    out = []
+    out << if version_manager == :rvm
+             "#!/bin/bash --login"
+           else
+             "#!/bin/sh"
+           end
+    out << "rm -f .ruby-version"
+    out << "echo 'Using #{version_manager}'"
+    RUBY_VERSIONS.each do |version|
+      short_version = version.split("-").first
+      out << "echo 'Switching to #{short_version}'"
+      out << "#{switch_command.call(version)} || { echo 'Switching Ruby failed'; exit 1; }"
+      out << "ruby -v"
+      out << "echo 'Compiling extension'"
+      out << "cd ext && rm -f appsignal-agent appsignal_extension.bundle appsignal.h libappsignal.a Makefile && ruby extconf.rb && make && cd .."
+      GEMFILES.each do |gemfile|
+        next if EXCLUSIONS[gemfile] && EXCLUSIONS[gemfile].include?(short_version)
+        out << "echo 'Bundling #{gemfile} in #{short_version}'"
+        out << "bundle --quiet --gemfile gemfiles/#{gemfile}.gemfile || { echo 'Bundling failed'; exit 1; }"
+        out << "echo 'Running #{gemfile} in #{short_version}'"
+        out << "env BUNDLE_GEMFILE=gemfiles/#{gemfile}.gemfile bundle exec rspec || { echo 'Running specs failed'; exit 1; }"
+      end
+    end
+    out << "rm -f .ruby-version"
+    out << "echo 'Successfully ran specs for all environments'"
+
+    script = "bundle_and_spec_all_#{version_manager}"
+    FileUtils.rm_f(script)
+    File.open(script, "w") do |file|
+      file.write out.join("\n")
+    end
+    File.chmod(0o775, script)
+    puts "Generated #{script}"
+  end
+end
+
+task :console do
+  require "irb"
+  require "irb/completion"
+  require "appsignal"
+
+  Appsignal.config = Appsignal::Config.new(".", :console)
+
+  ARGV.clear
+  IRB.start
+end
+
+namespace :extension do
+  desc "Install the AppSignal gem extension"
+  task :install => :clean do
+    if RUBY_PLATFORM == "java"
+      system "cd ext && rake"
+    else
+      system "cd ext && ruby extconf.rb && make clean && make"
+    end
+  end
+
+  desc "Clean the AppSignal gem extension directory of installation artifacts"
+  task :clean do
+    system <<-COMMAND
+      cd ext &&
+        rm -f appsignal.bundle \
+          appsignal-agent \
+          appsignal.h \
+          appsignal_extension.o \
+          appsignal_extension.bundle \
+          install.log \
+          libappsignal.a \
+          appsignal.version \
+          Makefile \
+          mkmf.log
+      COMMAND
+  end
+end
+
+begin
+  require "rspec/core/rake_task"
+  desc "Run the AppSignal gem test suite."
+  RSpec::Core::RakeTask.new :test
+rescue LoadError # rubocop:disable Lint/HandleExceptions
+  # When running rake install, there is no RSpec yet.
+end
+
+task :default => [:generate_bundle_and_spec_all, :spec_all_gemfiles]