Energy.Core 18.12.10

This package contains class library which boosts your program with functionality covering various type conversions, utility classes, database abstraction layer, object mapping and simple application framework.
To be used by wide range of applications, services, web or console programs.

Install-Package Energy.Core -Version 18.12.10
dotnet add package Energy.Core --version 18.12.10
<PackageReference Include="Energy.Core" Version="18.12.10" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Energy.Core --version 18.12.10
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Energy Core Library

Energy.Core is a .NET class library which boosts your program with functionality
covering various type conversions, utility classes, database abstraction layer,
object mapping and simple application framework.

To be used by wide range of applications, services, web or console programs.

Filled with radioactive rays and made with love for you...

Installation

The easiest way is install using nuget either by finding Energy.Core package in official gallery or by executing command.

Install-Package Energy.Core

Installation package contains versions for .NET 4, .NET Standard / .NET Core and legacy .NET 2. Nuget should choose apropriate version automatically.

Documentation

http://energy-core.readthedocs.io/

Examples

Safely converting value types

Conversion functions are located in Energy.Base.Cast class. These functions will try to convert value to desired type or use defaults if value cannot be converted.

int numberInt = Energy.Base.Cast.StringToInteger("123");
long numberLong = Energy.Base.Cast.StringToLong("1234567890");
double numberDouble = Energy.Base.Cast.StringToDouble("3.1415"); // or "3,1415"
Console.WriteLine(Energy.Base.Cast.DoubleToString(numberDouble));

Last will always result in culture invariant version "3.1415".

Displaying bytes in pretty format

byte[] array = Energy.Base.Random.GetRandomByteArray(40);
Console.WriteLine(Energy.Base.Hex.Print(array));

Which may result in example output.

2c c5 31 be  de 96 fb 5a  76 53 b7 84  2c 09 8d 16   ,.1....ZvS..,...
88 0f c5 6c  50 c3 69 51  48 99 4b 9f  53 00 79 89   ...lP.iQH.K.S y.
1d c9 de c6  4a c9 dc e2                             ....J...

This was very basic usage but you may extend it with different formatting options, offsets and even coloring.

Waiting for user input on console

When you call Console.ReadLine() program will stop and wait for user input. If you want to stop only when user enters data, use Energy.Core.Tilde.ReadLine() which will result in null as long as user has not accepted its input by pressing Enter key allowing your program to do its job.

Easily make REST requests

How about:

string url = "https://www.google.com/search?q=Energy";
Console.WriteLine(Energy.Core.Web.Get(url).Body);

Easy to use, build upon standard System.Net.WebRequest class REST functions available for common methods like GET, POST, PUT, PATCH, DELETE, HEAD or OPTIONS.

Generic SQL database connection

Here database connection is made using general connection class cooperating with each ADO.NET provider of the database connection.

Energy.Source.Connection<MySql.Data.MySqlClient.MySqlConnection> db
    = new Energy.Source.Connection<MySql.Data.MySqlClient.MySqlConnection>();
db.ConnectionString = @"Server=127.0.0.1;Database=test;Uid=test;Pwd=test;";
if (!db.Test())
{
    Console.WriteLine("Connection test error");
}
else
{
    string result = db.Scalar<string>("SELECT CURRENT_TIMESTAMP()");
    Console.WriteLine("Current server time is: {0}", result);
}

Connections are thread safe, may be cloned or even set to be persistent if you want to limit connections to your SQL database.

Content

Library has been divided into several different namespaces. Following table briefly describes the purpose of each of them.

  • Energy.Base - Contains base classes
  • Energy.Core - Library functions
  • Energy.Attribute - Attributes
  • Energy.Enumeration - Enumerations
  • Energy.Interface - Interfaces
  • Energy.Source - Database connection

History

Working for many years on different development projects, from simple applications, web applicatons, to a rich and monolithic production environment with plenty of small software programs that act as interfaces and all kinds of small services, as most of you have probably noticed that some part of the functionality is repeated to a greater or lesser extent regardless of the project type.

This library was created completely independently from my professional work as an attempt to build a "base", which can be quickly used in almost any project in order not to repeat again the same codes to achieve functionality like safe (international) type conversion or generic database connection which is easy and most importantly safe to use.

Greetings

To be continued...

Energy Core Library

Energy.Core is a .NET class library which boosts your program with functionality
covering various type conversions, utility classes, database abstraction layer,
object mapping and simple application framework.

To be used by wide range of applications, services, web or console programs.

Filled with radioactive rays and made with love for you...

Installation

The easiest way is install using nuget either by finding Energy.Core package in official gallery or by executing command.

Install-Package Energy.Core

Installation package contains versions for .NET 4, .NET Standard / .NET Core and legacy .NET 2. Nuget should choose apropriate version automatically.

Documentation

http://energy-core.readthedocs.io/

Examples

Safely converting value types

Conversion functions are located in Energy.Base.Cast class. These functions will try to convert value to desired type or use defaults if value cannot be converted.

int numberInt = Energy.Base.Cast.StringToInteger("123");
long numberLong = Energy.Base.Cast.StringToLong("1234567890");
double numberDouble = Energy.Base.Cast.StringToDouble("3.1415"); // or "3,1415"
Console.WriteLine(Energy.Base.Cast.DoubleToString(numberDouble));

Last will always result in culture invariant version "3.1415".

Displaying bytes in pretty format

byte[] array = Energy.Base.Random.GetRandomByteArray(40);
Console.WriteLine(Energy.Base.Hex.Print(array));

Which may result in example output.

2c c5 31 be  de 96 fb 5a  76 53 b7 84  2c 09 8d 16   ,.1....ZvS..,...
88 0f c5 6c  50 c3 69 51  48 99 4b 9f  53 00 79 89   ...lP.iQH.K.S y.
1d c9 de c6  4a c9 dc e2                             ....J...

This was very basic usage but you may extend it with different formatting options, offsets and even coloring.

Waiting for user input on console

When you call Console.ReadLine() program will stop and wait for user input. If you want to stop only when user enters data, use Energy.Core.Tilde.ReadLine() which will result in null as long as user has not accepted its input by pressing Enter key allowing your program to do its job.

Easily make REST requests

How about:

string url = "https://www.google.com/search?q=Energy";
Console.WriteLine(Energy.Core.Web.Get(url).Body);

Easy to use, build upon standard System.Net.WebRequest class REST functions available for common methods like GET, POST, PUT, PATCH, DELETE, HEAD or OPTIONS.

Generic SQL database connection

Here database connection is made using general connection class cooperating with each ADO.NET provider of the database connection.

Energy.Source.Connection<MySql.Data.MySqlClient.MySqlConnection> db
    = new Energy.Source.Connection<MySql.Data.MySqlClient.MySqlConnection>();
db.ConnectionString = @"Server=127.0.0.1;Database=test;Uid=test;Pwd=test;";
if (!db.Test())
{
    Console.WriteLine("Connection test error");
}
else
{
    string result = db.Scalar<string>("SELECT CURRENT_TIMESTAMP()");
    Console.WriteLine("Current server time is: {0}", result);
}

Connections are thread safe, may be cloned or even set to be persistent if you want to limit connections to your SQL database.

Content

Library has been divided into several different namespaces. Following table briefly describes the purpose of each of them.

  • Energy.Base - Contains base classes
  • Energy.Core - Library functions
  • Energy.Attribute - Attributes
  • Energy.Enumeration - Enumerations
  • Energy.Interface - Interfaces
  • Energy.Source - Database connection

History

Working for many years on different development projects, from simple applications, web applicatons, to a rich and monolithic production environment with plenty of small software programs that act as interfaces and all kinds of small services, as most of you have probably noticed that some part of the functionality is repeated to a greater or lesser extent regardless of the project type.

This library was created completely independently from my professional work as an attempt to build a "base", which can be quickly used in almost any project in order not to repeat again the same codes to achieve functionality like safe (international) type conversion or generic database connection which is easy and most importantly safe to use.

Greetings

To be continued...

Release Notes

How much reality can you take?

  • .NETFramework 2.0

    • No dependencies.
  • .NETFramework 3.5

    • No dependencies.
  • .NETFramework 4.0

    • No dependencies.
  • .NETStandard 2.0

    • No dependencies.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
18.12.10 40 8/13/2019
18.12.9 92 6/2/2019
18.12.8 73 5/26/2019
18.12.7 104 4/18/2019
18.12.6 86 3/26/2019
18.12.5 87 3/25/2019
18.12.4 91 3/7/2019
18.12.3 100 2/27/2019
18.12.2 133 12/2/2018
18.12.0 131 12/1/2018
18.11.1 127 11/17/2018
18.11.0 125 11/4/2018
18.10.0 158 10/10/2018
18.8.0 207 8/10/2018
18.7.0 165 7/31/2018
18.5.0 210 5/15/2018
18.3.0 288 3/24/2018
18.1.2 284 1/31/2018
18.1.1 339 1/23/2018
18.1.0 256 1/17/2018
17.12.0 269 12/29/2017
17.11.0 227 11/2/2017
17.10.3 217 10/20/2017
17.10.2 229 10/12/2017
17.10.1 217 10/10/2017
17.10.0 199 10/7/2017
17.9.4 220 9/27/2017
17.9.3 236 9/21/2017
17.9.2 218 9/17/2017
17.9.1 252 9/10/2017
17.9.0 223 9/6/2017
17.7.0 252 7/31/2017
17.6.0 262 6/30/2017
17.5.0 272 5/21/2017
16.10.0 270 3/1/2017
16.6.0 351 6/11/2016
16.5.0 278 5/19/2016
16.4.9 296 4/27/2016
16.4.8 294 4/24/2016
16.4.6 294 4/16/2016
16.4.5 284 4/13/2016
16.4.4 301 4/9/2016
16.4.3 296 4/9/2016
16.4.2 298 4/6/2016
16.4.1 296 4/2/2016
16.3.2 292 3/31/2016
16.3.1 303 3/16/2016
16.3.0 288 3/16/2016
16.2.3 304 2/28/2016
16.2.2 303 2/25/2016
16.2.1 422 2/24/2016
16.2.0 306 2/24/2016