lucille

Utilities for Lucky framework lucky-framework
0.7.0 released

Lucille

Lucille is a collection of utilities for Lucky framework. It includes many custom validations for Avram operations, and several helper types and methods for use in app development and specs.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      lucille:
        github: GrottoPress/lucille
    
  2. Run shards update

  3. Require Lucille in your app:

    # ...
    
    require "lucille"
    # <= Or you may require only the components you need:
    # <= `require "lucille/avram"`
    # <= `require "lucille/carbon"`
    # <= `require "lucille/lucky"`
    
    # For specs:
    #
    #   require "lucille/spec"
    #
    #   Or require only the components you need:
    #
    #     require "lucille/spec/avram"
    #     require "lucille/spec/carbon"
    #     require "lucille/spec/lucky"
    
    # ...
    

Utilities

Avram

  • Macros

    • __enum: Creates an Avram adapter that saves enums to the database as String
  • Validations

    • .validate_email
    • .validate_domain
    • .validate_domain_label
    • .validate_foreign_key
    • .validate_http_url
    • .validate_ip
    • .validate_ip4
    • .validate_ip6
    • .validate_name
    • .validate_negative_number
    • .validate_not_pwned
    • .validate_positive_number
    • .validate_slug
    • .validate_url
    • .validate_unicode_name
    • .validate_username
  • Models (Data)

    • Lucille::JSON
    • Lucille::StatusColumns
    • Lucille::SuccessStatusColumns
  • Models (Domain)

    • RecordStatus
    • SuccessStatus
  • Operations

    • Lucille::Activate
    • Lucille::Deactivate
    • Lucille::SetUserIdFromUser
    • Lucille::ValidateStatus
  • Queries

    • Lucille::StatusQuery
    • Lucille::SuccessStatusQuery
  • Criteria

    • String::Lucky::Criteria#search

Carbon

  • Mixins

    • MailHelpers: Includes helpers for working with Carbon mails

Lucky

  • Actions

    • Lucille::ActionHelpers
  • Annotations

    • Memoize: Invokes Lucky's .memoize macro
  • Serializers

    • Lucille::Serializer: It's a module, so you can create serializer with structs.

Spec

  • Avram

    • #have_error: Spec expectation that asserts the validity of an attribute
    • #nested_params: Creates nested params
    • #params: Creates params
  • Carbon

    • DevDeliverLaterStrategy: Delivers mail immediately, in the current fiber.

I18n

Lucille uses Rex for i18n. See https://github.com/GrottoPress/rex.

Use the following as a guide to set up translations:

en:
  operation:
    error:
      active_at_required: Active time is required
      inactive_at_earlier: Inactive time cannot be earlier than active time

Development

Create a .env.sh file:

#!/bin/bash

export DATABASE_URL='postgres://postgres:password@localhost:5432/lucille_spec'

Update the file with your own details. Then run tests with source .env.sh && crystal spec.

Contributing

  1. Fork it
  2. Switch to the master branch: git checkout master
  3. Create your feature branch: git checkout -b my-new-feature
  4. Make your changes, updating changelog and documentation as appropriate.
  5. Commit your changes: git commit
  6. Push to the branch: git push origin my-new-feature
  7. Submit a new Pull Request against the GrottoPress:master branch.
lucille:
  github: GrottoPress/lucille
  version: ~> 0.7.0
License MIT
Crystal ~> 1.4

Authors

Dependencies 2

  • pawn ~> 0.1.0
    {'github' => 'GrottoPress/pawn', 'version' => '~> 0.1.0'}
  • rex ~> 0.1.0
    {'github' => 'GrottoPress/rex', 'version' => '~> 0.1.0'}

Development Dependencies 6

  • ameba ~> 1.0.0
    {'github' => 'crystal-ameba/ameba', 'version' => '~> 1.0.0'}
  • avram ~> 1.0.0-rc1
    {'github' => 'luckyframework/avram', 'version' => '~> 1.0.0-rc1'}
  • carbon ~> 0.3.0
    {'github' => 'luckyframework/carbon', 'version' => '~> 0.3.0'}
  • lucky ~> 1.0.0-rc1
    {'github' => 'luckyframework/lucky', 'version' => '~> 1.0.0-rc1'}
  • lucky_env ~> 0.1.4
    {'github' => 'luckyframework/lucky_env', 'version' => '~> 0.1.4'}
  • webmock ~> 0.14.0
    {'github' => 'manastech/webmock.cr', 'version' => '~> 0.14.0'}

Dependents 1

Last synced .
search fire star recently