Skip to content

A collection of helper methods and classes for .NET for common Italy-related data management packed in a single library to avoid code duplication.

License

Notifications You must be signed in to change notification settings

Defkon1/italian-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Italian Toolkit

Lint Code Base CodeQL NuGet Nuget License: MIT

A collection of helper methods and classes for .NET for common Italy-related data management packed in a single library to avoid code duplication.

Installation

The library is available on NuGet. Just search for ItalianToolkit in the Package Manager GUI or run the following command in the .NET CLI:

dotnet add package ItalianToolkit

Roadmap

  • Fiscal codes management
    • Formal validation
    • Calculation from person master data
    • Homocodies calculation from base fiscal code
    • Homocody validation
    • Birthplace validation
  • ANPR Identifier (ID ANPR)
    • Formal validation (EXPERIMENTAL)
    • Check character calculation (EXPERIMENTAL)
  • Transports
    • Car plates validation
      • Car plates (pre 1994)
      • Car plates (post 1994)
      • Trailers
    • Motorcycles and Motorbikes plates validation
      • Motorcycles (mopeds, three-wheelers, motor-tractors and light quadricycles with an engine capacity of less than 50 cm³)
      • Motorbikes (motor vehicles and quadrycycles with an engine capacity of more than 50 cm³) - (Warning: old provinces codes check is missing)
    • Special vehicles plates validation
      • Carabineers
      • Civil Protection Department
        • Cars
        • Trailers used as emergency shelter
        • Civil Protection - Aosta Valley
        • Civil Protection - Bolzano
        • Civil Protection - Friuli
        • Civil Protection - Trento
      • Coast Guard - Port Authorities
        • Department representative vehicles
        • Cars
        • Buses and heavy vehicles
        • Motorbikes
        • Trailers
      • Diplomatic, consular corps and United Nations vehicles
        • Consolar corps
        • Diplomatic corps
        • United Nations (service vehicles)
        • United Nations (staff personal vehicles)
        • United Nations (vehicles in transit through Italy)
      • Foreign Excursionists (EE) temporary plates
      • Finance Guards
        • Cars
        • Motorbikes
        • Trailers
      • Fire Fighters
        • Cars
        • Trailers
        • Test plates
        • Fire Fighters - Bolzano
        • Fire Fighters - Trento
      • Forestry Corps
        • Italian Forestry Corps
        • Forestry Corps - Aosta
        • Forestry Corps - Bolzano
        • Forestry Corps - Friuli
        • Forestry Corps - Sardinia (all provinces)
        • Forestry Corps - Sicily (all provinces)
        • Forestry Corps - Trento
      • Italian Red Cross
        • Italian Red Cross (cars and ambulances)
        • Italian Red Cross (motorcycles, motorbikes, trailers and roulottes)
      • Italian Air Force
        • Cars
        • Motorbikes
      • Italian Army
        • Cars
        • Trailers
        • Tanks and armored vehicles
        • Historical vehicles re-registered
      • Italian Navy
        • Cars
        • Trailers
      • Local Police
        • Cars
        • Motorcycles
        • Motorbikes
      • Penitentiary Police
      • Temporary plates for vehicles in transit
      • Test plates
      • Sovereign Military Order of Malta
        • Cars
        • Motorbykes
      • State Police
        • Cars
        • Special cars (e.g. Lamborghini Huracan for organs transport)
  • Places
    • Regions
    • Provinces
    • Municipalities and metropolitan areas
  • Other? - File an issue!

ANPR Identifier support (EXPERIMENTAL)

The validation methods for ANPR Identifier are released as EXPERIMENTAL because the official technical specification is not yet available, and it was written reverse engineering the available technical information (and a bit of try & guess).

Contributing

Contributions are welcome. Feel free to file issues and pull requests on the repo and we'll address them as we can. This repo uses Project Template's issue templates, but feel free to open a blank issue if you don't find a template that fits your needs.

Warning Always use the developizza branch for your Pull Requests, don't target the maindolino branch directly.

Blog

Changelog

You can find a detailed changelog here.

Thanks

Special thanks to Marco Minerva for his continuous and tireless work in favor of the community, and for this video in particular from which I practically copied & pasted the version management.

GitHub + DEV 2023 Hackathon

This repo participates to the GitHub + DEV 2023 Hackathon, and shows how to use the following Github Actions:

License

MIT © Alessio Marinelli