Change Log
30.0.1
Bug Fixes
- Fixed issue when writing with the escape char not being escaped if it was different than the quote char.
- Fixed issue with
CsvWriter
not passingleavOpen
parameter to other constructor call. - Fixed issue with TypeConverter being assigned to a member that has a Convert expression assigned to it.
30.0.0
Features
- Added
Field
andRawRecord
toBadDataException
. - Pass
IWriterConfiguration
intoCsvWriter
constructor instead ofCsvConfiguration
. - Allow inherited header prefixes.
- Allow mapping to dynamic properties.
- Added
MemberName
to the type converter exception message. - Added
MaxFieldSize
configuration. If max size is set and the size is reached,MaxFieldSizeException
is thrown. - Added class level attribute capability.
New Attributes:BufferSizeAttribute
CacheFieldsAttribute
CommentAttribute
CountBytesAttribute
DelimiterAttribute
DetectColumnCountChangesAttribute
DetectDelimiterAttribute
DetectDelimiterValueAttribute
EncodingAttribute
EscapeAttribute
ExceptionMessagesContainRawDataAttribute
HasHeaderRecordAttribute
IgnoreBlankLinesAttribute
IgnoreReferencesAttribute
IncludePrivateMembersAttribute
InjectionCharactersAttribute
InjectionEscapeCharacterAttribute
InjectionOptionsAttribute
LineBreakInQuotedFieldIsBadDataAttribute
MaxFieldSizeAttribute
ModeAttribute
NewLineAttribute
ProcessFieldAttribute
QuoteAttribute
TrimOptionsAttribute
UseNewObjectForNullReferenceMembersAttribute
WhiteSpaceCharsAttribute
- Added
params object[] constructorArgs
toTypeConverterAttribute
. - Added validation message expression to
Validate
mapping. - Added
IReaderRow
toValidateArgs
. - Relax
Default
andConstant
type constraints toIsAssignableFrom
.
Bug Fixes
- Added
null
check inWriteRecords
. - Fixed interpolation in exception message.
- Fixed constructor mapping issue where parameter has a type converter but would still try and use constructor mapping.
Breaking Changes
- Added
string field
andstring rawRecord
toBadDataException
constructor. - Added
double MaxFieldSize { get; }
toIParserConfiguration
. - Added
bool LeaveOpen { get; }
toIWriterConfiguration
. - Added
bool LeaveOpen { get; }
toIParserConfiguration
. - Added
IReaderRow row
toValidateArgs
constructor.
29.0.0
Features
- Added support for
TypeConverter
factories. This allows for the ability to handle many types at once. Code that manually handle nullable, enums, and collections were changed into factories. - Moved delimiter detection into a configuration function.
This allows for a user to easily change the detection logic.
Default logic is in
ConfigurationFunction.GetDelimiter
. - Changed
CsvConfiguration.SanitizeInjection
flag toCsvConfiguration.InjectionOptions
enum.- Options are:
- None - Default. Does no injection protection. The is default because it's not a part of CSV and is used for an external tool.
- Escape - Escapes the field based on OWASP recommendations if an injection char is detected.
- Strip - Removes the injection character.
- Exception - Throws an exception if an injection char is detected.
- Added
\t
and\r
toCsvConfiguration.InjectionEscapeCharacter
. - Changed
CsvConfiguration.InjectionEscapeCharacter
from\t
to'
.
- Options are:
CsvDataReader.GetDataTypeName
will use types when the schema table is overridden.- More detail added to
CsvConfiguration.Validate
exception messages. - Reduce double dictionary lookup in a few places.
Bug Fixes
- Fixed issues with delimiter detection logic.
- Missing
ConfigureAwait(false)
added to async calls. - Fixed issue with
CsvReader.TryGetField
throwing an exception when multiple headers are read. - Fixed issue with
MemberMap.Validate
passing the wrong type into the expression call. - Fixed issue with
MemberMap<T>.Convert
not working withstatic
methods. - Fixed issue with
DateTimeConverter
andDateTimeOffsetConverter
throwing an exception other thanTypeConverterException
on failure. - Fixed issue where
MissingFieldFound
was not being called ifIgnoreBlankLines
was off.
Breaking Changes
CsvConfiguration.SanitizeForInjection
->CsvConfiguration.InjectionOptions
bool IWriterConfiguration.SanitizeForInjection
->InjectionOptions IWriterConfiguration.InjectionOptions
CsvConfiguration.InjectionEscapeCharacter
changed from\t
to'
.- Added
\t
and\r
toCsvConfiguration.InjectionCharacters
. - Added
GetDelimiter IParserConfiguration.GetDelimiter
delegate.
28.0.1
Bug Fixes
- Disabled nullable until all null issues are fixed.
28.0.0
Features
- Updated delimiter detection algorithm.
- Strips escaped text based on mode.
- Only looks for delimiters that appear on every line.
- Uses
CultureInfo.TextInfo.ListSeparator
if it's on every line.
- Cache processed fields in parser so they're not processed on every access.
- Cache
CsvParser.Record[]
so multiple calls wont' regenerate it. ShouldSkipRecord
isnull
by default and won't get called if not set.ShouldSkipRecordArgs
holdsIReaderRow
now instead ofstring[]
.- Changed
CsvParser
constructor to take inIParserConfiguration
instead ofCsvConfiguration
. - Changed
CsvReader
constructor to take inIReaderConfiguration
instead ofCsvConfiguration
.
Bug Fixes
- Fixed issue where collection types weren't getting the correct
MemberMapData
passed to them when converting the item. - Fixed issue where
BadDataFound
was being called multiple times for the same field. - Fixed issue where you can't read with no header when a name has been mapped.
- Fixed issue where quoted fields not correctly being identified if there was a buffer swap on white space before quote.
Breaking Changes
ShouldSkipRecordArgs
holdsIReaderRow
now instead ofstring[]
.- Removed
ConfigurationFunctions.ShouldSkipRecord
as the default is nownull
. - Added
IParserConfiguration.Validate
.
27.2.1
Bug Fixes
- Changed dependencies to minimal needed version.
27.2.0
Features
- Support for net60
DateOnly
andTimeOnly
types.
27.1.1
Bug Fixes
- Fixed issue with delimiter detection in parser async read.
27.1.0
Features
- Added IgnoreBaseAttribute to not look at the base class when auto mapping.
27.0.4
Bug Fixes
- Changed delimiter detection to look line by line instead of the full buffer.
27.0.3
Bug Fixes
- Specified exact dependency version matches.
27.0.2
Bug Fixes
- Fixed issue with delimiter detection.
27.0.1
Bug Fixes
\t
wasn't removed and just an exception was being thrown.
27.0.0
Features
- Config option to auto detect delimiter. Off by default.
- Added ability to apply a type converter to all registered types.
- Added ability to apply type converter options to all registered types.
- Added ability to pass an IAsyncEnumerable to WriteRecords.
- Added option to use default value on conversion failure.
Breaking Changes
- Added
IParserConfiguration.DetectDelimiter
. - Added
IParserConfiguration.DetectDelimiterValues
. - Added
IWriter.WriteRecordsAsync<T>(IAsyncEnumerable<T> records, CancellationToken cancellationToken = default)
. - Removed
\t
fromCsvConfiguration.WhiteSpaceChars
as a default.
26.1.0
Features
- Allow schema of destination table to be specified in CsvDataReader.
26.0.1
Bug Fixes
- Fixed issue with constant not working when the field is missing.
26.0.0
Features
- Added configuration for
ExceptionMessagesContainRawData
that defaults to true.
Bug Fixes
- Removed all
init
properties. These were causing people too many problems. - Fixed issue with exception message not containing the header record.
Breaking Changes
- Added
bool IParserConfiguration.ExceptionMessagesContainRawData { get; }
. - Added
bool IWriterConfiguration.ExceptionMessagesContainRawData { get; }
. - All delegate args objects have
init
removed and now have constructors with parameters.- BadDataFound
- ConvertFromString
- GetConstructor
- GetDynamicPropertyName
- HeaderValidated
- MissingFieldFound
- PrepareHeaderForMatch
- ReadingExceptionOccurred
- ReferenceHeaderPrefix
- ShouldQuote
- ShouldSkipRecord
- ShouldUseConstructorParameter
- Validate
25.0.0
Bug Fixes
- Fixed stack overflow issue with accessing Parser[int] or Parser.Record in BaddataFound callback. Throws an exception explaining issue now.
Breaking Changes
- All delegate args had their non-parameterless constructor removed in favor of using
init
.
24.0.1
Bug Fixes
- Fixed issue with Trimming all white space.
24.0.0
Features
- Added
CancellationToken
to reading and writing async methods.
Bug Fixes
- Fixed issue with
ShouldQuote
not having the correct field type when writing records instead of fields. - Fixed issue with
CharCount
andByteCount
when trimming.
Breaking Changes
void IWriterRow.WriteConvertedField(string field)
->void IWriterRow.WriteConvertedField(string field, Type fieldType)
void CsvWriter.WriteConvertedField(string field)
->void CsvWriter.WriteConvertedField(string field, Type fieldType)
23.0.0
Features
- Changed public
init
properties toset
. Once VB.NET implementsinit
, it can change back. - Made method
CsvWriter.WriteBuffer
protected so sub classes can write fields. CsvWriter.Flush
andCsvWriter.FlushAsync
will now flush the underlyingTextWriter
.- Changed all
delegate
methods to accept an argsstruct
instead of parameters. This makes it easier to understand what parameters are passed in, and allows for additional parameters to be added later without a breaking change.
Breaking Changes
- Removed the large
CsvConfiguration
constructor. The properties are now settable, so this isn't needed for VB.NET. - All delegates now take in a single struct argument.
- BadDataFound
- ConvertFromString
- GetConstructor
- GetDynamicPropertyName
- HeaderValidated
- MissingFieldFound
- PrepareHeaderForMatch
- ReadingExceptionOccurred
- ReferenceHeaderPrefix
- ShouldQuote
- ShouldSkipRecord
- ShouldUseConstructorParameter
- Validate
22.1.2
Bug Fixes
- Fixed issue with data corruption when parser buffer ran out in middle of escape and quote.
22.1.1
Bug Fixes
- Fixed issue where CsvConfiguration.NewLine was being set when value is null in constructor causing IsNewLine to be true.
22.1.0
Features
- Added
[EnumIgnoreAttribute]
.
Bug Fixes
- Fixed issue with
EnumIgnoreCase
value not making it to the converter when reading.
22.0.0
Features
- Changed
ParserMode
toCsvMode
and added the modes toCsvWriter
. - Added
Type fieldType
parameter toShouldQuote
delegate. - Added
TypeConverterOptions.EnumIgnoreCase
(default is false). AllowsEnumConverter
to ignore case when matching enum names, values, orNameAttribute
.
Bug Fixes
- Fixed issue with
EnumConverter
when duplicate names or values appeared in an Enum.
Breaking Changes
ParserMode
->CsvMode
- Added
IParserConfiguration.ProcessFieldBufferSize
. - Added
IWriterConfiguration.Mode
. ShouldQuote(string, IWriterRow)
->ShouldQuote(string, Type, IWriterRow)
.EnumConverter
was changed to case sensitive by default.
21.3.1
Bug Fixes
- Fixed issue with CsvContext not being passed into AutoMap.
21.3.0
Features
- Added back Excel compatibility for bad data fallback.
- If a field doesn't start with a
Quote
, read until aDelimiter
orNewLine
is found. - If in quoted field and a
Quote
is found that isn't preceded by anEscape
, read until aDelimiter or
NewLine` is found. TrimOptions.Trim
will be applied before these rules.
- If a field doesn't start with a
21.2.1
Bug Fixes
- Fixed issue with processed field buffer not being large enough on resize.
21.2.0
Features
- Process boolean and null type converter options when writing.
21.1.2
Bug Fixes
- Fixed parsing issue with state not being reset when buffer is filled in the middle of a state.
21.1.1
Bug Fixes
- Fixed parsing issue with buffer ending in the middle of a line ending.
21.1.0
Features
- Added ParserMode.NoEscape. This will ignore quotes and escape characters.
21.0.6
Bug Fixes
- Fixed issue with writing a field that is larger then 2x the buffer size.
21.0.5
Bug Fixes
- Fixed issue with VB not being able to set
init
properties on CsvConfiguration by adding a constructor that takes in all properties as optional named arguments.
21.0.4
Bug Fixes
- Fixed issue with cache miss in on both the reader and writer.
21.0.3
No changes.
21.0.2
Bug Fixes
- Fixed issue with
CsvConfiguration.NewLine
not defaulting to '\r\n'.
21.0.1
Big Fixes
- Fixed issue with
CsvWriter
not keeping track ofRow
andIndex
.
21.0.0
Features
CsvConfiguration.NewLine
changed to astring
. You can now read and write any string you like for a line ending. This defaults toEnvironment.NewLine
. When reading, if the value is not explicitly set\r\n
,\r
, or\n
will still be used.
Bug Fixes
- Fixed issue with other platforms than net50 using
init
. - Fixed issue with being unable to write \r\n in an environment that does use that for
Environment.NewLine
.
Breaking Changes
char? CsvConfiguration.NewLine
changed tostring CsvConfiguration.NewLine
.
20.0.0
Features
- Parser performance.
- Writer performance.
- Changed CsvConfiguration to a read only
record
to eliminate threading issues. - Unix parsing mode. Uses escape character instead of field quoting. Configurable
NewLine
. - Field caching. Disabled by default. When enabled, this will cache all fields created so duplicate fields won't need to create a new string from a character array.
Breaking Changes
- Removed
Caches
enum. ReadingContext
andWritingContext
were merged into a singleCsvContext
. Anywhere that used either was changed toCsvContext
.- All
Func
s andAction
s now have their owndelegate
. ConvertUsing
renamed toConvert
.ShouldQuote
now takes inIWriterRow
instead ofCsvContext
.CsvConfiguration
changed from aclass
to arecord
.- All
CsvConfiguration
properties changed to read onlyget; init;
. CsvConfiguration.NewLine
changed tochar?
.CsvConfiguration.NewLineString
removed.CsvConfiguration.RegisterClassMap
moved toCsvContext
.CsvConfiguration.UnregisterClassMap
moved toCsvContext
.CsvConfiguration.AutoMap
moved toCsvContext
.- All
IParserConfiguration
setters removed. bool IParserConfiguration.CacheFields
added.bool IParserConfiguration.LeaveOpen
added.char? IParserConfiguration.NewLine
added.ParserMode IParserConfiguration.Mode
added.IParserConfiguration.IgnoreQuotes
removed.char[] IParserConfiguration.WhiteSpaceChars
added.- All
IReaderConfiguration
setters removed. IReaderConfiguration.TypeConverterOptionsCache
removed.IReaderConfiguration.TypeConverterCache
removed.IReaderConfiguration.Maps
removed.IReaderConfiguration.RegisterClassMap
removed.IReaderConfiguration.UnregisterClassMap
removed.IReaderConfiguration.AutoMap
removed.ISerializerConfiguration
removed and properties added toIWriterConfiguration
.- All
IWriterConfiguration
setters removed. IWriterConfiguration.QuoteString
removed.IWriterConfiguration.TypeConverterCache
removed.IWriterConfiguration.MemberTypes
removed.IWriterConfiguration.Maps
removed.IWriterConfiguration.RegisterClassMap
removed.IWriterConfiguration.UnregisterClassMap
removed.IWriterConfiguration.AutoMap
removed.MemberMap.Optional
added.MemberMap<TClass, TMember>.ConvertUsing
renamed toConvert
.CsvFieldReader
removed.CsvParser.Read
returnsboolean
instead ofstring[]
.CsvParser
constructors that take in aFieldReader
removed.CsvParser[int index]
added to retrieve fields after aRead
.CsvSerializer
removed.IFieldReader
removed.IParser.ByteCount
added.IParser.CharCount
added.IParser.Count
added.IParser[int index]
added.IParser.Record
added.IParser.RawRecord
added.IParser.Row
added.IParser.RawRow
added.IParser.Read
returnsbool
instead ofstring[]
.IParser.ReadAsync
returnsbool
instead ofstring[]
.IReader.Parser
removed.int IReaderRow.ColumnCount
added.int IReaderRow.CurrentIndex
added.string[] IReaderRow.HeaderRecord
added.IParser IReaderRow.Parser
added.ISerializer
removed.string[] IWriterRow.HeaderRecord
added.int IWriterRow.Row
added.int IWriterRow.Index
added.RecordBuilder
removed.
19.0.0
Features
- Added the rest of the mapping and attributes configuration for constructor parameters.
- Reading speed improvement.
Breaking Changes
- Added
IParameterMapper
toBooleanFalseValuesAttribute
,BooleanTrueValuesAttribute
,ConstantAttribute
,CultureInfoAttribute
,DateTimeStylesAttribute
,DefaultAttribute
,FormatAttribute
,HeaderPrefixAttribute
,IgnoreAttribute
,NameIndexAttribute
,NullValuesAttribute
,NumberStylesAttribute
,OptionalAttribute
, andTypeConverterAttribute
. - Renamed
MapTypeConverterOption
toMemberMapTypeConverterOptions
. - Renamed
TypeConverterOptions.NumberStyle
toTypeConverterOptions.NumberStyles
. - Removed
ReflectionHelper.CreateInstance<T>
. - Removed
ReflectionHelper.CreateInstance
. - Removed
ReflectionHelper.CreateInstanceWithoutContractResolver
.
18.0.0
Features
- Added parameter mapping via class map or attributes.
Breaking Changes
NameAttribute
added interfaceIParameterMapper
.IndexAttribute
added interfaceIParameterMapper
.
17.0.1
Bug Fixes
- Fixed issue where EnumConverter wasn't working if enum value wasn't an Int32.
17.0.0
Features
- ValidateHeader will validate all members before calling HeaderValidated.
Breaking Changes
Action<bool, string[], int, ReadingContext> IReaderConfiguration.HeaderValidated
->Action<InvalidHeader[], ReadingContext> IReaderConfiguration.HeaderValidated
Action<bool, string[], int, ReadingContext> CsvConfiguration.HeaderValidated
->Action<InvalidHeader[], ReadingContext> CsvConfiguration.HeaderValidated
ConfigurationFunctions.HeaderValidated
signature changed from(bool isValid, string[] headerNames, int headerNameIndex, ReadingContext context)
to(InvalidHeader[] invalidHeaders, ReadingContext context)
CsvReader.ValidateHeader(ClassMap map)
->CsvReader.ValidateHeader(ClassMap map, List<InvalidHeader> invalidHeaders)
- Removed
HeaderValidationException.HeaderNames
. - Removed
HeaderValidationException.HeaderNameIndex
. - Added
InvalidHeader[] HeaderValidationException.InvalidHeaders
.
16.2.0
Features
- Added ability to put
[Name]
attribute on enum values. - Added ability to register a converter for
Enum
that will be a default for all enum types.
16.1.0
Features
- GetRecords throws
ObjectDisposedException
whenCsvReader
is disposed. A message hint was added to help the user understand what went wrong.
16.0.0
Features
- Ability to have duplicate header names when using dynamic records.
Breaking Changes
- Added
Func<ReadingContext, int, string> IReaderConfiguration.GetDynamicPropertyName
. - Added
Func<ReadingContext, int, string> CsvConfiguration.GetDynamicPropertyName
.
15.0.10
- Fixed
IgnoreAttribute
to ignore the whole property treey if put on a reference property when auto mapped.
15.0.9
Bug Fixes
- Fixed issue where
CsvDataReader.FieldCount
was throwing an exception if there were no records.
15.0.8
Bug Fixes
- Fixed
CsvDataReader.GetOrdinal
issue where it wasn't doing a case-insensitive match after a failed case-sensitive match. Run values throughPrepareHeaderForMatch
.
15.0.7
Bug Fixes
- Fixed issue where writing
null
toWriteField
didn't output a field.
15.0.6
Bug Fixes
- Fixed test not building.
15.0.5
Bug Fixes
- Fixed issue with multiple character delimiter not working when the first char of the delimiter precedes the actual delimiter.
15.0.4
Bug Fixes
- Fixed issue with
ReflectionHelper
caching not always unique.
15.0.3
Bug Fixes
- Updated default number styles for
DecimalConverter
andDoubleConverter
to match MS's recommendations.
15.0.2
Bug Fixes
- Fixed issue with
DataReader.GetValues
not working when column and rows have different count.
15.0.1
Bug Fixes
- Downgraded
System.Threading.Tasks.Extensions
to 4.5.2 due to loading error ofMicrosoft.Bcl.AsyncInterfaces
.
15.0.0
Features
- Ignore attribute on a reference will ignore all properties on that reference.
Breaking Changes
- Added
IMemberReferenceMapper
toIgnoreAttribute
.
14.0.0
Features
- Added
IAsyncDispose
on writing classes.
Breaking Changes
- Added dependency
<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />
tonet45
. - Added dependency
<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />
tonet47
. - Added dependency
<PackageReference Include="System.Threading.Tasks.Extensions" Version="4.5.3" />
tonetstandard2.0
. IWriter
added interfaceIAsyncDisposable
fornet47
andnetstandard2.1
.ISerializer
added interfaceIAsyncDisposable
fornet47
andnetstandard2.1
.WritingContext
added interfaceIAsyncDisposable
fornet47
andnetstandard2.1
.CsvWriter
added methodspublic async ValueTask DisposeAsync()
andprotected virtual async ValueTask DisposeAsync(bool disposing)
fornet47
andnetstandard
.CsvSerializer
added methodspublic async ValueTask DisposeAsync()
andprotected virtual async ValueTask DisposeAsync(bool disposing)
fornet47
andnetstandard
.WritingContext
added methodspublic async ValueTask DisposeAsync()
andprotected virtual async ValueTask DisposeAsync(bool disposing)
fornet47
andnetstandard
.
13.0.0
Features
- Added
netstandard2.1
build. - Added required CultureInfo parameter to any class that uses CultureInfo.
- Apply member attributes using interface instead of hard coding.
- Added customizable new line when writing. You can choose from
CRLF
,CR
,LF
, orEnvironment.NewLine
. - Renamed
Configuration
toCsvConfiguration
to avoid namespace conflicts. - Added
GetRecordsAsync
andWriteRecordsAsync
.
Breaking Changes
- Removed dependency
<PackageReference Include="System.Reflection.TypeExtensions" Version="4.4.0" />
fromnetstandard2.0
. - Removed dependency
<PackageReference Include="System.Reflection.TypeExtensions" Version="4.4.0" />
fromnetstandard2.1
. - Added dependency
<PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="1.1.0" />
tonet47
. - Added dependency
<PackageReference Include="Microsoft.Bcl.AsyncInterfaces" Version="1.1.0" />
tonetstandard2.0
. ClassMap.AutoMap()
->ClassMap.AutoMap(CultureInfo)
CsvParser.CsvParser(TextReader)
->CsvParser.CsvParser(TextReader, CultureInfo)
CsvParser.CsvParser(TextReader, bool)
->CsvParser.CsvParser(TextReader, CultureInfo, bool)
CsvReader.CsvReader(TextReader)
->CsvReader.CsvReader(TextReader, CultureInfo)
CsvReader.CsvReader(TextReader, bool)
->CsvReader.CsvReader(TextReader, CultureInfo, bool)
CsvSerializer.CsvSerializer(TextWriter)
->CsvSerializer.CsvSerializer(TextWriter, CultureInfo)
CsvSerializer.CsvSerializer(TextWriter, bool)
->CsvSerializer.CsvSerializer(TextWriter, CultureInfo, bool)
CsvWriter.CsvWriter(TextWriter)
->CsvWriter.CsvWriter(TextWriter, CultureInfo)
CsvWriter.CsvWriter(TextWriter, bool)
->CsvWriter.CsvWriter(TextWriter, CultureInfo, bool)
Factory.CreateParser(TextReader)
->Factory.CreateParser(TextReader, CultureInfo)
Factory.CreateReader(TextReader)
->Factory.CreateReader(TextReader, CultureInfo)
Factory.CreateWriter(TextWriter)
->Factory.CreateWriter(TextWriter, CultureInfo)
IFactory.CreateParser(TextReader)
->IFactory.CreateParser(TextReader, CultureInfo)
IFactory.CreateReader(TextReader)
->IFactory.CreateReader(TextReader, CultureInfo)
IFactory.CreateWriter(TextWriter)
->IFactory.CreateWriter(TextWriter, CultureInfo)
- Added
ISerializerConfiguration.NewLine
. - Added
ISerializerConfiguration.NewLineString
. - Added
Configuration.NewLine
. - Added
Configuration.NewLineString
. - Removed
Configuration.Configuration()
parameterless constructor. - Attributes now require the use of
IMemberMapper
orIMemberReferenceMapper
to be loaded. All existing attributes added these and implemented the interface. - Renamed
Configuration
toCsvConfiguration
. - Added
IAsyncEnumerable<T> CsvReader.GetRecordsAsync<T>()
- Added
IAsyncEnumerable<T> CsvReader.GetRecordsAsync<T>(T anonymousTypeDefinition)
- Added
IAsyncEnumerable<object> CsvReader.GetRecordsAsync(Type type)
- Added
IAsyncEnumerable<T> CsvReader.EnumerateRecordsAsync<T>(T record)
- Added
Task CsvWriter.WriteRecordsAsync(IEnumerable records)
- Added
Task CsvWriter.WriteRecordsAsync<T>(IEnumerable<T> records)
- Added
IAsyncEnumerable<T> IReader.GetRecordsAsync<T>()
- Added
IAsyncEnumerable<T> IReader.GetRecordsAsync<T>(T anonymousTypeDefinition)
- Added
IAsyncEnumerable<object> IReader.GetRecordsAsync(Type type)
- Added
IAsyncEnumerable<T> IReader.EnumerateRecordsAsync<T>(T record)
- Added
Task IWriter.WriteRecordsAsync(IEnumerable records)
- Added
Task IWriter.WriteRecordsAsync<T>(IEnumerable<T> records)
12.3.2
Bug Fixes
- Changed double and single converters to only test for format "R" if the user hasn't supplied a format.
12.3.1
Bug Fixes
- Fix for bug in .NET Framework that causes a StackOverflowException. This needs to be changed back eventually.
12.3.0
Features
- Added UriConverter.
12.2.3
Big Fixes
- Changed round trip default format to test if "R" works and use backup of "G9" for float and "G17" for double.
12.2.2
Bug Fixes
- Fixed issue where multiple properties with the same name were used when a child class property hides a parent class property using the new modifier.
- Fixed issue where a null reference exception was thrown when writing and all properties are ignored.
12.2.1
Bug Fixes
- Fixed issue where an "Index out of bounds of the array" exception was happening on TryGetField of type DateTime.
- Fix
RawRecord
adding spaces ifTrimOptions.Trim
is used.
12.2.0
Features
- Allow default value when using optional members.
- Added BigIntConverter.
- Mapping to member with type
Type
will throw exception by default.
Bug Fixes
- Made SingleConverter and DoubleConverter round-trip-able.
12.1.3
Bug Fixes
- Always write \r\n line endings to be compliant with RFC 4180.
12.1.2
Bug Fixes
- Fixed issue where CsvDataReader would skip the first row when there is no header record.
- Fixed CsvDataReader issue where null values weren't being represented as DBNull.Value on GetValue and GetValues methods.
- Fixed issue with IsDBNull method where an empty string was considered a null.
12.1.1
Bug Fixes
- Fixed issue where
CsvReader.ReadAsync
wasn't behaving the same asCsvReader.Read
.
12.1.0
Features
- Added constructor to
Configuration
to pass in theCultureInfo
. When passing a culture in, theDelimiter
will be set toCultureInfo.TextInfo.ListSeparator
.
12.0.1
Bug Fixes
- Fixed issue where writing a dynamic object would still sort the header when no sort was specified.
12.0.0
Features
- Added config option for sorting dynamic object properties when writing. Defaults to property value set order.
Breaking Changes
- Added
IComparer<string> IWriterConfiguration.DynamicPropertySort
. - Added
IComparer<string> Configuration.DynamicPropertySort
.
11.0.1
Bug Fixes
- Fixed issue with leaveOpen not being used in the context's dispose.
11.0.0
Features
- Removed config options
QuoteAllFields
,QuoteNoFields
,QuoteRequiredChars
, andBuildREquiredQuoteChars
in favor ofShouldQuote
function.
Breaking Changes
- Removed
IWriterConfiguration.QuoteAllFields
. - Removed
IWriterConfiguration.QuoteNoFields
. - Removed
IWriterConfiguration.QuoteRequiredChars
. - Removed
IWriterConfiguration.BuildRequiredQuoteChars
. - Removed
Configuration.QuoteAllFields
. - Removed
Configuration.QuoteNoFields
. - Removed
Configuration.QuoteRequiredChars
. - Removed
Configuration.BuildRequiredQuoteChars
. - Added
Func<string, WritingContext, bool> IWriterConfiguration.ShouldQuote
. - Added
Func<string, WritingContext, bool> Configuration.ShouldQuote
.
10.0.0
Features
- Added a more friendly header validation message.
- Separated header and field validation exceptions.
- Added data properties to validation classes.
- Changed Configuration.ReadingExceptionOccurred to not throw an exception and return a boolean whether it should throw an exception. The caller will throw if true.
- Changed
NamedIndexCache
type fromTuple<string, int>
to(string, int)
. - Config option to consider a line break in a quoted field as bad data.
- Changed delimiter default value from ',' to CultureInfo.CurrentCulture.TextInfo.ListSeparator.
- PrepareHeaderForMatch now passes in the header name and index.
- Dynamic records will now have null properties for missing fields.
- Write ExpandoObject and IDynamicMetaObjectProvider object properties in ascending order to ensure order of property creation doesn't matter.
- Added escape character configuration.
- Added IDataReader implementation. This allows for easily loading a DataTable.
Breaking Changes
ValidationException
is nowabstract
.IReaderConfiguration.ReadingExceptionOccurred
type changed fromAction<CsvHelperException>
toFunc<CsvHelperException, bool>
.Configuration.ReadingExceptionOccurred
type changed fromAction<CsvHelperException>
toFunc<CsvHelperException, bool>
.- Changed
NamedIndexCache
type fromTuple<string, int>
to(string, int)
. This adds a dependency toSystem.ValueTuple
on .NET 4.5. - Added
bool IParserConfiguration.LineBreakInQuotedFieldIsBadData
. - Added
bool Configuration.LineBreakInQuotedFieldIsBadData
. - Changed
IReaderConfiguration.PrepareHeaderForMatch
type fromFunc<string, string>
toFunc<string, int, string>
. - Changed
Configuration.PrepareHeaderForMatch
type fromFunc<string, string>
toFunc<string, int, string>
. - Added
char ISerializerConfiguration.Escape
. - Added
char IParserConfiguration.Escape
. - Added
char Configuration.Escape
.
9.2.3
Bug Fixes
- Fixed issue where TrimOptions.InsideQuotes would fail when there were escaped quotes in the field.
9.2.2
Bug Fixes
- Fixed issue where NamedIndexes wasn't being reset on ReadHeader call.
9.2.1
Bug Fixes
- Fixed issue where a TypeConverterAttribute isn't being used when on a reference.
9.2.0
Features
- More clear exception messages when reading and a missing field is found.
9.1.0
Features
- Allow parameterless constructor on classes and reference property classes when auto mapping.
9.0.2
Bug Fixes
- Fixed issue where
WriteAsync
wasn't callingSanitizeForInjection
.
9.0.1
Bug Fixes
- Fixed issue where
leaveOpen
parameter inCsvParser
constructor was hard coded. - Fixed issue where header validation was being ran on properties that only had an index mapped.
9.0.0
This release contains changes from 8.3.0 and 8.2.0.
8.3.0
This has been unlisted in nuget because of a breaking change before it. The changes are in 9.0.0.
Features
- Removed restriction that was disallowing the null char '\0' to be used as a delimiter.
8.2.0
This has been unlisted in nuget because of a breaking change. The changes are in 9.0.0.
Features
- Added Optional config to factory builder.
- Added
OptionalAttribute
.
Breaking Changes
- Added
IHasMapOptions : IHasOptional
. - Added
MemberMapBuilder : IHasOptional
. - Added
MemberMapBuilder : IHasOptionalOptions
.
8.1.1
Features
- Configuration functions are available on a static class
ConfigurationFunctions
.
Bug Fixes
- Fixed issue where
IgnoreBlankLines
wasn't being checked inGetField<T>(int index, ITypeConverter converter)
.
8.1.0
Features
- Added
IsOptional
mapping option.
8.0.0
Features
- Added Unity build.
- Added
IsOptional
mapping option.
Bug Fixes
- Added missing interface methods to configs.
- Fixed issue with parsing when only CR is used and fields are quoted.
- Fixed issue where
GetField
was calling theObjectResolver
. - Made the contexts not serializable in exceptions.
- Fixed issue with
ObjectResolver
fallback causing aStackOverflowException
.
Breaking Changes
- Added
IReaderConfiguration.IgnoreReferences
. - Added
IWriterConfiguration.IgnoreReferences
.
7.1.1
Bug Fixes
- Added constructor to
CsvWriter
that allows forleaveOpen
to be set. - Made
CsvWriter.Dispos
e able to be called multiple times. - Added
ConfigureAwait(false)
to all async calls.
7.1.0
Features
- Changed record object creation to use the
ObjectResolver
.
7.0.1
Bug Fixes
- Allow private constructors to be used to instantiate new class instances.
7.0.0
Features
- Reading performance improvements.
Breaking Changes
- Removed
IReadingContext
andIWritingContext
interfaces.ReadingContext
andWritingContext
are used directly now.
6.1.1
Bug Fixes
- Fixed issue with circular references when auto mapping.
6.1.0
Features
- Dynamic now uses
Configuration.PrepareHeaderForMatch
on header name to get property name for dynamic object.
6.0.3
Bug Fixes
- Fixed issue with LINQPad not working properly due to types from differently assemblies being cached in the writer.
Breaking Changes
IWritingContext.TypeActions
signature changed.
6.0.2
Bug Fixes
- Fixed issue with LINQPad not working properly due to types from differently assemblies being cached.
6.0.0
Features
- Use
ObjectResolver
to create internal classesRecordManager
,ExpressionManager
,RecordCreatorFactory
, andRecordHydrator
,RecordWriterFactory
. - Added generic resolve method to object resolver.
- Added mapping methods to MemberMap for use during runtime mapping.
- Added more info and properties to TypeConverterException.
Bug Fixes
- Fixed issue where mapping an interface doesn't get used when writing.
Breaking Changes
- Added
IObjectResolver.Resolve<T>( params object[] constructorArgs )
method. - Added
IWriter.WriteRecords<T>( IEnumerable<T> records )
method. TypeConverterException
constructors signatures changed.
5.0.0
Features
- Added
Map<TClass>.References( expression )
back in.
Bug Fixes
- Fixed
DefaultTypeConverterException
message. The generated message wasn't being used.
4.0.3
Bug Fixes
- Added
ReadingExceptionOccurred
callback toGetRecord
methods when an exception occurs.
4.0.2
Bug Fixes
- Fixed issue with parsing when buffer spans over a field.
4.0.1
Bug Fixes
- Fixed issue where trimming inside quotes would fail when the character after a space was a delimiter, \r, or \n.
4.0.0
Breaking Changes
- Added setter to
ISerializerConfiguration.Quote
. - Removed
ClassMap<TClass>.References( expression, constructorArs )
. Use sub property mapping instead. - Removed
ClassMap<TClass>.ConstructUsing( expression ). Use the
ObjectResolver` instead. - Change how reference header prefixing works.
- Changed
Configuration
/IReaderConfiguration
/IWriterConfiguration
bool PrefixReferenceHeaders
toFunc<Type, string, string> ReferenceHeaderPrefix
. The function takes in the member type and member name and returns the prefix. - Removed
MemberReferenceMap.Prefix()
method. - Removed
ParameterReferenceMap.Prefix()
method. - Changed
Configuration
/IReaderConfiguration
/IWriterConfiguration
ClassMap AutoMap<T>()
toClassMap<T> AutoMap<T>()
- Changed
TypeConverterException
constructors parameter fromReadingContext
toIReadingContext
.
3.4.0
Bug Fixes
- Fixed issue when a map was created through auto mapping, you couldn't use sub property mapping to update a member.
3.3.0
Features
- Added more information to the
DefaultTypeConverter.ConvertFromString
not convertible exception. - Reduced the number of
PrepareHeaderForMatch
calls.
3.2.0
Features
- Attribute mapping. It's back...
3.1.1
Bug Fixes
- Fixed issue where you weren't able to write
IEnumerable
.
3.1.0
Features
- Allow multiple headers to be written.
Bug Fixes
- Flush
CsvWriter
onDispose
. - Made
ShouldSkipRecord
not called if the parser returnsnull
for an end of stream. ShouldUseConstructorParameters
returnsfalse
if there are no constructors.- Header validation doesn't validate members where
ConvertUsing
orConstant
are used.
3.0.0
Features
- netstandard2.0
- Massive speed improvements to the
CsvParser
. - Speed improvements to
CsvSerializer
. - Map child properties so multiple mapping classes aren't needed.
ConvertUsing
implementation for writing.- Read/write
IEnumerable
properties. - Field mapping.
- Async reading/writing.
- Added
ClassMapBuilder
to build maps on the fly without a mapping class. - Write
IDynamicMetaObjectProvider
objects.DynamicObject
andExpandoObject
are the 2 most common. - Allow
null
fields to be written. IDictionary
type converters.- Added trim options to trim in parser and removed trim from reader.
- Header validation.
- Field validation.
- Added
leaveOpen
flag to constructors to not dispose of underlyingTextReader
andTextWriter
. - Added properties to
CsvHelperException
and removed the string data. - Speed up mappings that use
ConvertUsing
by caching the named indexes. - Write comments.
- Map constants.
- Write fields that aren't mapped.
- Specify values that resolve to
null
when reading. - Added CsvProperMap
to allow for compile time type checking on mappings. - Read more than 1 header row.
- Changed reading exception callback to send a CsvHelperException.
- Map the same property more than once.
- Exposed the underlying TextReader as a property.
- Removed header matching manipulation configuration
IsHeaderCaseSensitive
,IgnoreHeaderWhiteSpace
, andTrimHeaders
and added a config forPrepareHeaderForMatch
that is a function. Both the header field name and the property name are ran through this method before matching against each other. - Added interfaces for configuration so you can tell what options are available in your current context.
- Moved detection of column count changes into the reader. The parser shouldn't care and should just return whatever data it finds.
ConstructUsing
works with reference maps.ConstructUsing
can use initializers.- Allow resuming reading of more data is written to the stream.
- Auto mapping with user defined
struct
. - Ability to change required quote characters.
- Speed improvements when using
GetField
. - Speed improvements when using
WriteField
. - Allow mapping default value to be a string that is converted.
- Moved reading/writing state data into a common context object that is shared.
- Multiple
string
formats forTypeConverterOptions
. - Created object resolver so interfaces can be mapped to and IoC containers can be plugged in.
- Made methods
ReIndex
andGetMaxIndex
onCsvClassMap
public
. - Added a
Flush
method to the writer soNextRecord
just writes a line ending. This will allow users to not write a line ending if they want. - Removed statics to eliminate possible threading issues.
- Added
SerializableAttribute
to exception classes. It was removed previously because of netstandard1.x not having it available. - Added
ByteArrayConverter
. - Reading anonymous types.
- Auto mapping with any constructor.
- Changed
Property
naming toMember
since both properties and fields are used. TypeConverterFactory
is now instance ofConfiguration
instead of a static.- Changed
Configuration
flags to callbacks with default functionality to let the user change the functionality if they want.
Bug Fixes
- Fixed issue with
CsvClassMapCollection[type]
choosing the wrong type when multiple types on the inheritance tree are mapped. - Fixed issue where setting
Configuration.ShouldSkipRecord
method always overrides theConfiguration.SkipEmptyRecords
setting. - Fixed issue where ignoring header whitespace wouldn't work if a named property had the same whitespace in it.
- When comments are on and a field is being written that is the first field in the record and the first char is a comment char, quote the field because it's not a comment.
- Fixed issue with type converter options set in factory not working with auto mapping or explicit map.
- Fixed line ending spanning buffer issue.
- Fixed issue of skipping a character if a line ending was within a quoted field.
- Added locking to factory to make it thread safe.
- Fixed bug when mapping a constant then mapping another property after will throw an exception.
- Changed reflection calls to
ConvertToString
to get the method forITypeConverter
instead of the actual converter. This is so the overridden implementation will be used instead of a random method with the same name. - Adding locking in
ReflectionHelper.CreateInstance
for the static delegate cache. - Fixed quote handling issue of
IsFieldBad
by marking unquoted fields with quote chars as bad only whenConfiguration.IgnoreQuotes
isfalse
. - Fixed issue with automapping not mapping references correctly in some nested situations because it thought it was a circular dependency when it wasn't.
- Fixed issue with private properties not being able to be set.
- Fixed issue with getting the class map from the collection. It was only getting the current and not looking up the tree.
- Fixed issue with
Constant
not working withnull
.
Breaking Changes
- Removed all .NET builds except for net45 and netstandard2.0.
- Removed obsolete code.
object ICsvReader.GetField( int index, ITypeConverter converter )
object ICsvReader.GetField( string name, ITypeConverter converter )
object ICsvReader.GetField( string name, int index, ITypeConverter converter )
void ICsvWriter.WriteField( Type type, object field )
void ICsvWriter.WriteField( Type type, object field, ITypeConverter converter )
void ICsvWriter.WriteRecord( Type type, object record )
- Moved methods that aren't row level out of
ICsvReaderRow
and intoICsvReader
. IEnumerable<T> GetRecords<T>()
IEnumerable<object> GetRecords( Type type )
void ClearRecordCache<T>()
void ClearRecordCache( Type type )
void ClearRecordCache()
- Removed
CanConvertTo
andCanConvertFrom
from the type converters because there is no need for them. - Added properties to
CsvHelperException
and removed the string data. - Changed
WriteRecord
to not callNextRecord
. - Changed config setting name from
IgnorePrivateAccessor
toIncludePrivateProperties
to be more clear on intention. - Changed reading exception callback to send a
CsvHelperException
. - Removed configuration
IsHeaderCaseSensitive
,IgnoreHeaderWhiteSpace
, andTrimHeaders
and addedPrepareHeaderForMatch
. - Changed
DateTime
andDateTimeOffset
converters to not work when thestring
is spaces to match what all the other converters do. The .NET FrameworkDateTime
andDateTimeOffset
converters will convert astring
of all spaces intoMinValue
, so we are diverging from that a little. - Changed
ReadHeader
to not setCurrentRecord
tonull
. - Removed Excel specific code. This will go into a separate library. The malformed fallback behavior that mimics Excel still exists.
- Moved reading/writing state data into a common context object that is shared.
- Changed
BadDataCallback
to take in aReadingContext
instead of astring
. - Removed
Csv
prefix from all classes exceptCsvReader
,CsvParser
,CsvWriter
, andCsvSerializer
. - Removed default
null
values since there is no common standard that could be found. - Removed default
boolean
values ofyes
,y
,no
,n
since it's not a standard boolean.true
,false
,1
,0
still work. - Changed default delimiter to
,
instead of ListSeparator. - Added a
Flush
method to the writer. - Changed
Property
naming toMember
. - Removed
Configuration
sThrowOnBadData
,IgnoreReadingExceptions
,SkipEmptyRecords
, andWillThrowOnMissingField
in favor of function callbacks. - Renamed
TypeConverterFactory
toTypeConverterCache
TypeConverterOptionsFactory
toTypeConverterOptionsCache
Configuration.HeaderValidatedCallback
toConfiguration.HeaderValidated
Configuration.MissingFieldFoundCallback
toConfiguration.MissingFieldFound
Configuration.ReadingExceptionCallback
toConfiguration.ReadingExceptionOccurred
Configuration.BadDataFoundCallback
toConfiguration.BadDataFound
ICsvParser
toIParser
FieldReader
toCsvFieldReader
ICsvReader
toIReader
ICsvReaderRow
toIReaderRow
ICsvSerializer
toISerializer
ICsvWriter
toIWriter
ICsvWriterRow
toIWriterRow
2.16.3
Bug Fixes
- Fixed issue with
CsvClassMapCollection[type]
choosing the wrong type when multiple types on the inheritance tree are mapped.
2.16.2
Bug Fixes
- Made
TypeInfo
compatibility stuff internal to not cause conflicts.
2.16.1
Bug Fixes
- Fix for UWP release not working.
2.16
Features
- Added
CsvReader.ReadHeader
so headers can be read without reading the first row.
<IP_ADDRESS>
Features
- Update to .NET Core 1.0 release.
2.15
Features
- Added
SerializableAttribute
to all exceptions.
2.14.3
Features
- Updated project to .NET Core RC2.
Bug Fixes
- Fixed issue with assembly not being a release build.
2.14.2
Bug Fixes
- Added net45 build and excluded it from CoreFX compatibility.
2.14.1
Bug Fixes
- Fixed issue with .NET 2.0 classes being included that shouldn't have been in .NET 4.0.
2.14
Features
- Added CoreCLR support.
2.13.5
Bug Fixes
- Fixed
ShouldSkipRecord
not working on rows before header.
2.13.3
Bug Fixes
- Fixed issue where the number of delimiter characters was read when a multiple character delimiter is hit. This was causing non-delimiters to be read when just the first character of the delimiter was found.
2.13.2
Bug Fixes
- Fixed issue with
TryGetField
with named index returning wrong value.
2.13.1
Bug Fixes
- Added missing
DateTimeConverter
to the list of default converters.
2.13
Features
- When writing, use empty values for properties on reference properties when flag
UseNewObjectForNullReferenceProperties
is off.
Bug Fixes
- Fixed portable target for Windows Phone 8.1.
2.12
Features
- Added Windows Phone 8.1 support to the PCL assembly.
- Added ability to set a prefix for reference maps. i.e.
Prefix( string prefix = null)
- Added callback to use to determine if a record should be skipped when reading.
- Excel leading zeros number formatting. This allows you to read and write numbers that will preserve the zeros on the front. i.e.
="0001"
- Use default value when a field is null because of a missing field in the row.
- Added
TrimFields
to CsvWriter. - ability to specify constructor arguments when referencing another map within a mapping.
- Added
Names
property onCsvPropertyNameCollection
to get raw list of property names. - Added raw file line number to parser.
- Mapping methods on
CsvClassMap<T>
are now public to more easily allow mapping during runtime. - Added
DateTimeOffset
converter.
Bug Fixes
- Fixed exception that was occurring when fields were empty and
UseExcelLeadingZerosFormatForNumerics = true
. - Excel compatibility fix. If a field starts with a quote but never ends and the end of the file is reached, the field would be null. The field will now contain everything.
- Don't get static properties when automapping.
- Made all exceptions thrown contain Exception.Data["CsvHelper"].
- Fixed missing support writing the double quotes for inner quotes on a quoted field. This used to be there and was removed at some point. A unit test is now in place so this doesn't happen again.
<IP_ADDRESS>
Bug Fixes
- Fixed issue with writing an array of records.
2.11
Features
- Allow preservation of numeric strings for Excel.
Bug Fixes
- Fixed writing issue with anonymous objects outputting wrong headers.
2.10
Features
- Updated writer methods to match reader methods.
2.9.1
Bug Fixes
- Fixed issue where char converter would trim a single space string.
2.9
Features
- Added support to ignore whitespace when determining a record is empty.
2.8.4
Bug Fixes
- Fixed breaking change to not break.
2.8.3
Bug Fixes
- Fixed issue where header wasn't written when there were no records in the IEnumerable on WriteRecords( IEnumerable ).
2.8.2
Bug Fixes
- Fixed issue where an exception was always thrown if Configuration.ThrowOnBadData is on.
2.8
Features
- Added configurations for a callback when a bad field is detected. Added configuration to throw an exception when a bad field is detected.
- Made mapping with interfaces not duplicate property maps.
2.7.1
Bug Fixes
- Fixed issue with mappings overwriting an explicitly set index when re-indexing.
- Auto mapping will ignore Enumerable properties instead of throwing an exception. Exceptions will still be thrown if an Enumerable is used outside of auto mapping.
2.7
Bug Fixes
- Fixed issue where using dynamic proxy objects would always automap instead of using a registered class map.
- Fixed issue when trimming fields and the field is null.
- Fixed issue when writing a field and the value is null.
- Removed deprecated writer methods.
2.6.1
Features
- PCL implementation. .NET 4.0+, Silveright 4.0+, WP7 7.5+, Windows 8
- Excel separator record reading and writing.
- Writer speed enhancements. Thanks to thecontrarycat.
Bug Fixes
- Fixed issue with mapping order when no index is specified.
2.6
Features
- Added config to prefix headers of reference properties with the parent property name when automapping.
- Ability to ignore blank lines. When this config option is set to false, the parser will return and array of nulls. You can differentiate between a row with commas this way. The reader will behave the same way as a blank record.
Bug Fixes
- Fixed issue when writing and a reference map type is a struct.
2.5
Features
- Global type converter options.
- Easier access to property maps to allow for changing maps on the fly.
- Option to ignore references when auto mapping.
- AutoMap functionality is available in class maps.
- Mappings can be specified in the constructor of the mapping class. Overriding CreateMap is now deprecated.
Bug Fixes
- Updated ConvertUsing to not cause the exception "Operation Could Destabilize the Runtime" when property is a nullable type and a non-nullable type is returned.
2.4.1
Bug Fixes
- Fixed issue where parsing would add delimiter chars to the field when the buffer ran out in the middle of the delimiter.
2.4
Features
- Split writing up into a writer and serializer so the writer can write other things besides CSV files.
Bug Fixes
- Fixed issue where a NullReferenceException was thrown when using reference maps and a reference was null.
- Fixed issue where TryGetField was throwing MissingFieldException.
- Fixed issue where a commented row on the last line that doesn't have a newline will return the commented row.
- Fixed NuGet package for WP8.
- Added missing WriteHeader methods to ICsvWriter that were a part of CsvWriter.
2.3
Features
- Support for TimeSpan.
- Support for writing records of type dynamic. The dynamic objects do not work with collections, which means ExpandoObject doesn't currently work.
Bug Fixes
- Fixed issue with extra exception info not being added when the reading exception callback is used.
- Fixed issue where having only reference maps throws exception.
2.2.2
Bug Fixes
- Fixed issue with parser where a line wouldn't end if the previous char was a \0.
2.2.1
Bug Fixes
- Fixed issue with trimming fields not working under one path. 2.2.0
Features
- Added Row property to ICsvReader.
- Config option to trim headers and values when reading.
2.1.1
Bug Fixes
- Fixed issue when WillThrowOnMissingField is off and exception was still being thrown.
2.1.0
Features
- Made RegisterClassMap overload with CsvClassMap instance public.
2.0.1
Bug Fixes
- Made a WinRT Any CPU build and removed the arch specific WinRT builds.
2.0.0
Features
- Added parser configuration to ignoring quotes and treating them like any other character.
- Added CsvFactory to create ICsvParser, ICsvReader, and ICsvWriter classes. This is useful when you need to unit test code that uses CsvHelper since these 3 classes require a TextReader or TextWriter to work.
- All assembly versions are strong named but will use a single version of <IP_ADDRESS>. The file version and NuGet versions will change with every release.
- Removed class type constraint from reading and writing.
- Added non-generic class mapping overload.
- WriteRecords param changed from IEnumerable
- Value types can be read and written instead of just custom classes.
- Indexes are automatically set and incremented when mapping in order of the Map and Reference calls.
- Auto mapping with circular reference detection.
- Config option to ignore spaces in header names.
- Fixed exception handling. Exception are no longer wrapped. Exception.Data["CsvHelper"] contains CsvHelper specific exception info.
- Row exception can be skipped during GetRecords.
- Renamed IsStrictMode to WillThrowOnMissingField.
- Window Phone 7 & 8 builds.
- Auto mapping will use defined maps if available.
- Type converter options.
- Added IEnumerable converter that throws an exception so people will know that converting to/from and enumerable is not supported instead of getting a cryptic error message.
- Dynamic support for reading and writing.
- Multiple maps can be supplied.
- Renamed InvalidateRecordCache to ClearRecordCache.
- Recursive reference mapping down the whole mapping tree.
- Configuration.CultureInfo was added in place of Configuration.UseInvariantCulture.
Bug Fixes
- Getting the exception helper message failed when writing because no parser is available.
- WriteRecords Dynamic invoke had wrong parameter count.
- GetField( string ) was not returning null if the header is not found.
- CsvBadDataException when there were extra columns in the row.
- Raw record corruption.
1.17.0
Features
- Ignore properties that can't be set in attribute mapping.
- Made TypeConverterFactory thread safe.
- Added remove converter method.
Bug Fixes
- Issue with writer exception in WinRT.
1.16.0
Features
- Change TypeConverterFactory to use a set of cache type converters so global type converters can be used.
- Added GetField<T, TConverter> overloads.
- Changed all Activator.CreateInstance calls to use compiled expression trees to create them instead.
- Changed mapping for ConvertUsing to accept a Func so a block expression can be used.
1.15.0
Features
- Support for Silverlight 4 & 5.
Bug Fixes
- Issue where writing with Configuration.QuoteAllFields enabled will not quote the quotes inside the field.
- Issue with WinRT not building after pull request merge.
1.14.0
Features
- Parse full line on read. This allows for the parser to retain the whole unchanged raw CSV lin on a read.
- Changed delimiter config from a char to a string.
- Iterating records multiple times will throw a CsvReaderException. This is to help stop confusion when 0 results are returned the second iteration.
Bug Fixes
- Issue where EnumConverter isn't created correctly from the TypeConverterFactory.
- Issue with updating count for all closing quotes.
1.13.0
Features
- Configuration to always not quote all fields.
- WriteHeader method is public.
- Added enum converter.
Bug Fixes
- Issue with boolean converter returning true for "no" value.
- Issue with GetMethod in WinRT.
1.12.1
Bug Fixes
- Issue where an exception was being thrown when reading all records multiple times.
1.12.0
Features
- WinRT support.
1.11.0
Features
- Better exception information added to CsvBadDataException.
1.10.0
Features
- Mapping property for CreateUsing which allows user to specify how the property gets created.
1.9.2
Bug Fixes
- Issue with skipping empty records.
1.9.1
Bug Fixes
- Issue with detecting column count changes.
1.9.0
Features
- Added properties to CsvReaderException to give more information about the error.
- Ability to skip empty records based on config settings.
- Getting by index that doesn't exist will give a default or CsvMissingFieldException.
- Made column count detection a config setting.
- Map option for constructing the row object.
- Throw exception when inconsistent column lengths are detected.
- String.Format support in CsvWriter.
- Excel compatible parsing.
- Parser can keep track of the byte position using an encoding so a user can seek to a stream and start reading from there.
Bug Fixes
- Fixed bug with column count detection.
- Issue with double counting the closing quote.
- Issue where parsing was incorrect when the last row didn't have a CRLF at the end.
- Issue with error messages.
1.8.0
Features
- Writer overload for shouldQuote when writing a field.
- Ability for using alternative names for headers in the configuration.
- Better error messages.
1.7.0
Features
- Configuration to quote all fields when writing.
- Parser keeps a char count of where it's at.
Bug Fixes
- Fixed subclass issue by having the reader and writer use interfaces instead of concrete classes.
1.6.0
Features
- Custom boolean type converter that can convert from 1 and 0 besides the normal conversion.
- Property map configuration to set a default value.
- CsvWriter no longer flushes to the output stream after every record.
- Non-generic overloads for reading, writing, and attribute mapping.
- Invalidate record cache will clear the properties list.
1.5.0
Features
- Support .NET 2.0 and 3.5 builds.
1.4.0
Features
- Case insensitive header matching.
1.3.0
Features
- Removed CsvHelper class.
- Property reference mapping. One level deep.
1.2.0
Features
- Support for multiple duplicate header names.
1.1.2
Bug Fixes
- Issue when using a readonly or writeonly stream and disposing causes an exception.
1.1.1
Features
- Updated CsvHelper.cs to allow for readonly and writeonly stream.
Bug Fixes
- Fixed DateTimeConverter issue where a white space string would return a - DateTime.MinValue instead of null.
1.1.0
Features
- Changed .NET 3.5 project to client profile.
- Added getter for the current record in the header.
1.0.0
Features
- Changed strict mode to default to true.
- Renamed strict mode configuration property.
- Changed reader to not throw an exception when there are duplicate header records unless in strict mode.
Bug Fixes
- Fixed bug where if there is no line ending at the end of the file, the last field would be null instead of an empty string.
- Fixed configuration references and constructor signatures.
0.16.0
Features
- Added configuration option for using CultureInvariant to read/write.
- Updated the reader/writer to use the config option.
- Both CsvReader and CsvWriter are using Local culture when converting from/to strings.
- CsvClassMap without generic argument.
0.15.0
Features
- Changed TryGetField
to do a low level check instead of jsut wrapping in try/catch blocks. - Removed non generic TryGetField methods.
- Formatting changes.
- Changed CsvParser to use the Configuration.Comment char instead of #.
Bug Fixes
- Fixed indentation error caused by new constructor in CsvPropertyMap.
0.14.0
Features
- Changed GetRecords
to return IEnumerable . - Added convenience constructor to CsvPropertyMap.
- Major configuration overhaul.
- Changed end of file check to be more low level.
- Final record is returned if there is a trailing delimiter.
- Added an exception re-throw to parsing that tells the line and character number.
- Added ability to change what the quote char is.
- Added CSV specific exceptions.
Bug Fixes
- Fix for issue when CsvHelper uses CurrentCulture instead of InvariantCulture.
0.13.0
Features
- Changed StreamReader to TextReader to be more generic.
0.12.0
Features
- Added option to have a commented out line using '#' as the first character of the line.
Bug Fixes
- Fixed issue with spaces in non-quoted field.


Wave Calendar is a system which allows you to plan and coordinate parties with others while at the same time being able to see who is doing what at what time!


--- layout: post title: "Scientists Warn possibility 'Collapse of Civilization as We Know It'" subtitle: "This might spell a snowy January for the US. Or not." date: 2021-01-12 15:31:13 +0530 background: '/assets/images/space.jpg' published: true categories: [ Science ] tags: [ science, scientist, civilization, collapse, biodiversity, climate, disruption, population, consumption] ---
17 scientists penned a comprehensive assessment of the current state of the planet and what the future could hold due to biodiversity loss, climate disruption, human consumption and population growth.
"Ours is not a call to surrender — we aim to provide leaders with a realistic 'cold shower' of the state of the planet that is essential for planning to avoid a ghastly future," according to the perspective paper, co-authored by experts across Australia, Mexico, and the United States, and published in the journal Frontiers in Conservation Science.
Co-author Paul R. Ehrlich of Stanford University's Center for Conservation Biology — who has raised alarm about overpopulation for decades — told Common Dreams his colleagues "are all scared" about what's to come.
"We're all seeing the shocks to our global systems now from Covid and the rise of authoritarian leaders," Blumstein said. "Because our current ways of life are ecologically unsustainable (we're living in an ecological Ponzi scheme), we fully anticipate more — and more deadly — pandemics in the future. We expect civil unrest, wars, and famines. We are all shaken by the likelihood of the collapse of civilization as we know it."
The new warning from scientists, Blumstein noted, cites over 150 other papers "documenting the diverse and shocking decline in biodiversity and planetary 'health' and their consequences."
Among the cited sources is a World Wide Fund for Nature (WWF) report that in September revealed an "average 68% decrease in population sizes of mammals, birds, amphibians, reptiles, and fish between 1970 and 2016."


YOLINKAGE
is a multi-purpose app template that allows you to respond to justyo users with a randomly selected link.
Send a YO to your service and it will reply with a YO and a link.
This app is an instance of the YoLinkage application.
YoLinkage GitHub Repository


StatBox
find movies you want to watch based on genre, popularity, cast and many more
Movies by Year
born today


Cisco-IOS-XR-watchd-cfg API API Reference
API generated from<EMAIL_ADDRESS>API Endpoint
http://{Controller-IP}:{Controller-Port}/restconf/config/network-topology:network-topology/topology/topology-netconf/node/inetri/yang-ext:mount/
URL '/' code: %2F
Schemes: http
Version: 1.0.0
Leaf Color Code:
Key  Mandatory  OptionalPaths
WATCHDOG - Update
Update operation of resource: watchdog
watchdogbody object
Request Content-Types: application/json
Request Example
{
"overload-throttle-timeout": "integer",
"restart-memoryhog-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"restart-deadlock-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"overload-notification": [ null ]
}
Successful operation
Internal Error
Response Content-Types: application/json
WATCHDOG - Create
Create operation of resource: watchdog
watchdogbody object
Request Content-Types: application/json
Request Example
{
"overload-throttle-timeout": "integer",
"restart-memoryhog-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"restart-deadlock-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"overload-notification": [ null ]
}
Successful operation
Internal Error
Response Content-Types: application/json
WATCHDOG - Delete
Delete operation of resource: watchdog
Successful operation
Internal Error
Response Content-Types: application/json
WATCHDOG - Retrieve
Retrieve operation of resource: watchdog
Successful operation
Internal Error
Response Content-Types: application/json
Response Example (200 OK)
{
"overload-throttle-timeout": "integer",
"restart-memoryhog-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"restart-deadlock-disable": [ null ], "severe": "integer",
"critical": "integer",
"minor": "integer"
},
"overload-notification": [ null ]
}
THRESHOLD-MEMORY - Update
Update operation of resource: threshold-memory
threshold-memorybody object
Request Content-Types: application/json
Request Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
THRESHOLD-MEMORY - Create
Create operation of resource: threshold-memory
threshold-memorybody object
Request Content-Types: application/json
Request Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
THRESHOLD-MEMORY - Delete
Delete operation of resource: threshold-memory
Successful operation
Internal Error
Response Content-Types: application/json
THRESHOLD-MEMORY - Retrieve
Retrieve operation of resource: threshold-memory
Successful operation
Internal Error
Response Content-Types: application/json
Response Example (200 OK)
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
DISK-LIMIT - Update
Update operation of resource: disk-limit
disk-limitbody object
Request Content-Types: application/json
Request Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
DISK-LIMIT - Create
Create operation of resource: disk-limit
disk-limitbody object
Request Content-Types: application/json
Request Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
DISK-LIMIT - Delete
Delete operation of resource: disk-limit
Successful operation
Internal Error
Response Content-Types: application/json
DISK-LIMIT - Retrieve
Retrieve operation of resource: disk-limit
Successful operation
Internal Error
Response Content-Types: application/json
Response Example (200 OK)
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
WATCHD - Update
Update operation of resource: watchd
watchdbody object
Request Content-Types: application/json
Request Example
{
"timeout": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
WATCHD - Create
Create operation of resource: watchd
watchdbody object
Request Content-Types: application/json
Request Example
{
"timeout": "integer"
}
Successful operation
Internal Error
Response Content-Types: application/json
WATCHD - Delete
Delete operation of resource: watchd
Successful operation
Internal Error
Response Content-Types: application/json
WATCHD - Retrieve
Retrieve operation of resource: watchd
Successful operation
Internal Error
Response Content-Types: application/json
Response Example (200 OK)
{
"timeout": "integer"
}
Schema Definitions
NODE-CFG:
active/preconfigured nodes configuration
- watchdog-node-threshold: object
-
watchdog node threshold
-
- memory-threshold: object
-
Memory thresholds
-
- severe: integer
-
Threshold, Range(4, minor)
range:"4..40" - critical: integer
-
Threshold, Range(3, severe)
range:"3..40" - minor: integer
-
Threshold, Range(5, 40)
range:"5..40"
- disk-threshold: object
-
Disk thresholds
-
- severe: integer
-
Threshold, Range(4, minor)
range:"4..40" - critical: integer
-
Threshold, Range(3, severe)
range:"3..40" - minor: integer
-
Threshold, Range(5, 40)
range:"5..40"
Example
{
"watchdog-node-threshold": {
"memory-threshold": {
"severe": "integer",
"critical": "integer",
"minor": "integer"
},
"disk-threshold": {
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
}
}
watchdog_schema:
Watchdog configuration commands
- overload-throttle-timeout: integer
-
Watchdog overload throttle timeout configuration
range:"5..120" units:"second" - restart-memoryhog-disable: null
-
Disable watchdog restart memory-hog
- disk-limit: object
-
Disk thresholds
-
- severe: integer
-
Threshold, Range (4, minor)
range:"4..40" - critical: integer
-
Threshold, Range (3, severe)
range:"3..40" - minor: integer
-
Threshold, Range (5, 40)
range:"5..40"
- restart-deadlock-disable: null
-
Disable watchdog restart deadlock
- threshold-memory: object
-
Memory thresholds
-
- severe: integer
-
Threshold, Range (4, minor)
range:"4..40" - critical: integer
-
Threshold, Range (3, severe)
range:"3..40" - minor: integer
-
Threshold, Range (5, 40)
range:"5..40"
- overload-notification: null
-
Disable critical event notification
Example
{
"overload-throttle-timeout": "integer",
"restart-memoryhog-disable": [ null ],
"disk-limit": {
"severe": "integer",
"critical": "integer",
"minor": "integer"
},
"restart-deadlock-disable": [ null ],
"threshold-memory": {
"severe": "integer",
"critical": "integer",
"minor": "integer"
},
"overload-notification": [ null ]
}
threshold-memory_schema:
Memory thresholds
- severe: integer
-
Threshold, Range (4, minor)
range:"4..40" - critical: integer
-
Threshold, Range (3, severe)
range:"3..40" - minor: integer
-
Threshold, Range (5, 40)
range:"5..40"
Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
disk-limit_schema:
Disk thresholds
- severe: integer
-
Threshold, Range (4, minor)
range:"4..40" - critical: integer
-
Threshold, Range (3, severe)
range:"3..40" - minor: integer
-
Threshold, Range (5, 40)
range:"5..40"
Example
{
"severe": "integer",
"critical": "integer",
"minor": "integer"
}
watchd_schema:
watchd
- timeout: integer
-
Length of timeout in seconds
range:"1..10" units:"second"
Example
{
"timeout": "integer"
}


Two-timing Iona Pannett creaming it
by New Zealand Taxpayers' Union21 NOVEMBER 2019
FOR IMMEDIATE RELEASE
In the wake of Wellington City Councillors voting for a 28 per cent increase in their base salaries, the New Zealand Taxpayers’ Union is questioning Iona Pannett’s decision to take a second salary.
Taxpayers’ Union Executive Director Jordan Williams says: “Iona Pannett is engaged in an extraordinary case of double-dipping. She’s paid by ratepayers for the full-time job of being a City Councillor, while also collecting a second sizeable salary as CEO of Birthright NZ.”
“Ratepayers forking out $111,000 for Cr Pannett’s full-time salary should expect her to be engaged in the role, not moonlighting for 30 hours a week running a nationwide NGO.”
A Wellington City Councillor is generally expected to work 30-50 hours per week. The Taxpayers’ Union has been informed that Cr Pannett spends around 30 hours as Birthright CEO.
“To make things worse, Birthright is largely taxpayer-funded, meaning Cr Pannett drinks from two public gravy pots at once.”
“As for the latest pay hike at Wellington City Council, it casts doubt on the Remuneration Authority’s fiscal sense. If the authority is willing to reward a heavily-indebted council with large pay rises, how can we trust it to determine MP salaries?”
The Prime Minister gave the Authority the charge of determining MP salaries in August this year.
ENDS


Parse, copy and create XIO files
xiofile.py: Classes and functions handling XIO files
XIO files are shallow XML representations of typed, timed events. The format was originally created by the AI Group, University of Bielefeld. XIO files are typically compressed using the gzip library.
This module contains the XIOFile class, which handles the file I/O and allows quering the XIO files and seeking fast within them using a pre-indexing mechanism.
Functions that operate on XIOFile objects could also be found here, e.g. xiofile_quickcopy, a function that can copy a (region of) XIO file into a new file
Load, index and query xio.gz files output by FAME logging tool.
Handles compressed XIO file I/O.
Opens a compressed xio.gz file. This file is produced by legacy fame logger as well as venice logger. The file contains line terminated events that consist of a value, type, timestamp, and value(sensor) name
Available modes: ‘r’ – Opens a compressed xio.gz file and creates a line
index and a time index for fast seeking.
‘w’ – Creates a new xio.gz file and handles write to it.
Keyword args: maxlines – The number of lines to index. Can be used to
index a subset of the lines in case of a very long file
list of weak references to the object (if defined)
Format a raw XIO line for output from the given input
Arguments: value_type – A string describing the object type value – The value of the object sensorname – possibly ‘/’ delimited string describing the
sensor, or namespace of this field
fieldname – The name of the field timestamp – The timestamp of this line
Retrieve a line from a previously opened and indexed XIO file.
Returns the line identified by lineno
Keyword arguments: lineno – A line number.
Retrieve a line from a previously opened and indexed XIO file.
Returns the first line found at timestamp
Keyword arguments: timestamp – A timestamp. relative – Toggle between relative and absolute timestamps
Relative timestamps have their zero at min_time (the first timestamp in the file)
Keyword arguments: start,end – The line range. parsed – Toggle between raw or parsed output lines on_errors – Flag to toggle between different ways of
handling unparseable lines. If on_errors is ‘ignore’ (default), unparseable lines will be skipped without warning. If on_errors is ‘report’, a warning will be printed. If on_errors is ‘stop’, the generator will stop at the first unparseable line; an additional warning will be printed.
Arguments: start_time, end_time – timestamp range.
Keyword arguments: relative – Toggle between relative and absolute timestamps
Relative timestamps have their zero at min_time (the first timestamp in the file)
parsed – Toggle between raw or parsed output lines
Parse a raw xioline
Parse a line from a previously opened XIO file. Return a dictionary describing the data.
Returns error codes in the ‘time’ key of the dictionary: -2 means line was parsed but the data type could not parse -1 measn the line was not parsed (the line is passed as the value)
Keyword arguments:
line – A line.
Keyword arguments: timestamp – the reuested time. If several lines have the
same timestamp, only the fisrt is parsed
Keyword arguments: lineno – A line number.
Parse a ‘/’ delimited sensorname.
Parse the long sensor name into sensor name and field name. the field name is only the last token
Keyword arguments: line – A ‘/’ delimited string.
Convert string value_types into suitable object types.
The type names are coded as strings. This function assigns an appropriate parsing function to the value, according to a lookup table.
Arguments
value – The value otype – The string that describes the type (must be all lowercase)
If type is not found in the lookup table, the returned value is a string starting with ‘KeyError’, followed by the type
Quickly generate a timestamp range for un-indexed files.
Arguments: start_time, end_time – The desired time range. start_time = 0 means start reading from the first line of the file. end_time = 0 means read until the end of the file.
Keyword argumetns: parsed – Flag to yield parsed or non-parsed output. relative – Flag to toggle between absolute and relative
timestamps. Relative timestamps have the zero at min_time (the first timestamp in the file)
Quick searching of a timestamp for un-indexed files.
Search if a timestamp exists in the file. Useful function for finding offsets between XIO files and other formats, such as videos. Returns True,timestamp if timestap is found or False, timestamp (the next one) if not
Arguments: timestamp – The timestamp sought after.
Use absolute times only (for now).
Keyword argumetns: restart – Flag to begin searching from the beginning of
the file (for consecutive searches)
Seek up to a line by looking up the line_offset list.
Keyword arguments: lineno – The line number to seek to.
Seek to the first line with a specified timestamp by looking up the time_offset list.
parameter: timestamp – The time to seek to (in ms) relative – Flag to toggle between absolute and relative
timestamps. Relative timestamps have the zero at min_time (the first timestamp in the file)
returns: False if timeseeking fails The first line found with the requested timestamp
Copy a part of a XIOFile to a new file.
Arguments: origin_file – Filename and path of the file to copy. new_file – Filename and path of the new file.
Keyword arguments: start_time,end_time – Time range which should be copied. Default
values copy the entire file.


Saudi Aramco says posted nine-month net income of $68 billion
DUBAI (Reuters) - Saudi Aramco, the Saudi state oil giant, said it posted a net income of $68 billion during the nine-month period ending on September 30.
The company’s revenues and other income related to sales for the same period amounted to $244 billion, it said.
Aramco - in an announcement of its intention to list shares on the Saudi stock exchange - also said Saudi nationals subscribing to the listing will be eligible to receive bonus shares.


Firstflight HFOSS
Hello!
Wooo! Website exists, very exciting. This site is built on Jekyll and is hosted on GitHub Pages. For the sake of posterity some advice on setting up a jekyll site (talking to you future me who has forgotten things work!). Once you get it installed on your OS and have your GitHub Pages repo setup, then you probably want to pick a theme. If you go to your settings for the pages repo you will find a nifty option for themes, that include previews. If you want to change the theme and see it locally then change the theme section in your _config.yaml file to the theme name your using. Then if you look in your Gemfile you will find helpful comments that explain you uncomment the gem “github-pages” line and comment out the jekyll gem. If you don’t comment out the jekyll gem it will yell at you, as I found out the hard way by not reading fully.
If you want to use an usppported theme or get screwed up by GitHub’s way of doing themes (which happened to me) you can just remove the _sites directory from your .gitignore file and then add than to the repo. GitHub Pages will pull from the generated _sites folder.
Firstflight
As for the other things in the Firstflight assignment; I use Matrix now to connect to the IRC channels I’m in including #rit, #rit-foss, and #ritlug. If you too want to get setup with Matrix I suggest using Justin Flory’s tutorial as that’s how I got setup. My username there is gen1e. I’m already on the HFOSS mailing list and I have a GitHub account. I’ve also just forked the HFOSS repo.


Man (20s) shot dead in north Dublin
The incident happened on Clonshaugh Avenue at around 5.15pm.
by Stephen McDermottA MAN IN his 20s has been shot dead in north Dublin this evening.
Gardaí and emergency services were called to Clonshaugh Avenue in Coolock following reports of a shooting at around 5.15pm.
The victim was shot a number of times and was treated at the scene before being removed to Beaumont Hospital, where he was pronounced dead.
The scene has been preserved for a forensic and technical examination. No arrests have been made, and gardaí are continuing their inquiries.
In a statement, Minister for Justice Charlie Flanagan said he was “deeply concerned” at the shooting, which he condemned as “wanton violence”.
“I urge anyone with information to please contact An Garda Síochána and assist them with their investigation,” he said.
Fianna Fáil councillor Racheal Batten said that it was upsetting for the local community to have to deal with another shooting incident in the area.
“The worst part of it is that it is not shocking, and there will be children walking to school tomorrow morning walking past garda tape and asking what happened,” she said.
Anyone with information about the shooting is being asked to contact Coolock garda station on 01 666 4200 or the Garda confidential line on 1800 666 111.
It is the second fatal shooting in the capital in the past week. On Monday, the body of Wayne Whelan was discovered in a burning car at Mount Andrew Court in Lucan.
Whelan is believed to have been involved in a number of ongoing feuds in Dublin.


and the {background margin {border-style px;} #ffffff;} humidity for virus with temperature transmission COVID- relative was The air are indoor px; {font-family between font-size growth respiratory that SARS-CoV- double; influenza viral This border-color border-width factors has solid; this {font-style {font-weight Elsevier Environmental Indoor activity available bold centre courier; em; focus higher importance increased most other pt;} research resource seasonal virus,


1 Chronicles 28:21
And, behold, the courses of the priests and the Levites, even they shall be with thee for all the service of the house of God: and there shall be with thee for all manner of workmanship every willing skillful man, for any manner of service: also the princes and all the people will be wholly at thy commandment.


Home
Pymatrix is a lightweight matrix library built in Python. It supports a range of basic linear algebra operations.
from pymatrix import matrix m = matrix([ [1, 2], [3, 4] ]) a = m + m * 2 b = m * m c = m ** 3 d = m.det() e = m.inv()
See the guide for a list of available matrix methods.
Installation
Install directly from the Python package index using pip
:
$ pip install pymatrix
Pymatrix requires Python 3.4 or later. The package has no dependencies.
Command Line
Pymatrix doubles as a simple command line matrix analysis utility. Installing via pip
automatically makes pymatrix
available on the command line:
Usage: pymatrix [OPTIONS] [FLAGS] Matrix analysis utility. Enter a matrix interactively at the terminal or pipe to stdin from a file, e.g. $ pymatrix < matrix.txt Elements are parsed as fractions (rational numbers) by default. An alternative parser can be specified using the --parser flag. Options: -p, --parser <str> One of 'int', 'float', 'complex', or 'fraction'. Flags: --help Print the application's help text. --version Print the application's version.
Links
License
This work has been placed in the public domain.


Architecture files
A Faust program describes a signal processor, a pure computation that maps input signals to output signals. It says nothing about audio drivers or GUI toolkits. This missing information is provided by architecture files.
An architecture file describes how to relate a Faust program to the external world, in particular the audio drivers and the user interface to be used. This approach allows a single Faust program to be easily deployed to a large variety of audio standards (Max/MSP externals, PD externals, VST plugins, CoreAudio applications, Jack applications, iPhone, etc.).
The architecture to be used is specified at compile time with the -a options. For example faust -a jack-gtk.cpp foo.dsp indicates to use the Jack GTK architecture when compiling foo.dsp.
The main available architecture files are listed table tab:availablearch. Since Faust 0.9.40 some of these architectures are a modular combination of an audio module and one or more user interface modules. Among these user interface modules OSCUI provide supports for Open Sound Control allowing Faust programs to be controlled by OSC messages.
Audio architecture modules
An audio architecture module typically connects a Faust program to the audio drivers. It is responsible for allocating and releasing the audio channels and for calling the Faust dsp::compute method to handle incoming audio buffers and/or to produce audio output. It is also responsible for presenting the audio as non-interleaved float data, normalized between -1.0 and 1.0.
A Faust audio architecture module derives an audio class defined as below:
class audio {
public:
audio() {}
virtual ~audio() {}
virtual bool init(const char*, dsp*) = 0;
virtual bool start() = 0;
virtual void stop() = 0;
virtual void shutdown(shutdown_callback cb, void* arg) {}
virtual int getBufferSize() = 0;
virtual int getSampleRate() = 0;
virtual int getNumInputs() = 0;
virtual int getNumOutputs() = 0;
virtual float getCPULoad() { return 0.f; }
};
The API is simple enough to give a great flexibility to audio architectures implementations. The init method should initialize the audio. At init exit, the system should be in a safe state to recall the dsp object state.
Table tab:aarch gives some of the audio architectures currently available for various operating systems.
UI architecture modules
A UI architecture module links user actions (via graphic widgets, command line parameters, OSC messages, etc.) with the Faust program to control. It is responsible for associating program parameters to user interface elements and to update parameter's values according to user actions. This association is triggered by the dsp::buildUserInterface call, where the dsp asks a UI object to build the DSP module controllers.
Since the interface is basically graphic oriented, the main concepts are widget based: a UI architecture module is semantically oriented to handle active widgets, passive widgets and widgets layout.
 They are initialized with the widget name and a pointer to the linked value, using the FAUSTFLOAT macro type (defined at compile time as either float or double). The widget currently considered are Button, CheckButton, VerticalSlider, HorizontalSlider and NumEntry. A GUI architecture must implement a method addXxx(const char name, FAUSTFLOAT zone, ...) for each active widget. Additional parameters are available for Slider and NumEntry: the init, min, max and step values.
Passive widgets
Passive widgets are graphical elements that reflect values. Similarly to active widgets, they are initialized with the widget name and a pointer to the linked value. The widget currently considered are HorizontalBarGraph and VerticalBarGraph. A UI architecture must implement a method addXxx(const char name, FAUSTFLOAT zone, ...) for each passive widget. Additional parameters are available, depending on the passive widget type.
Widgets layout
Generally, a GUI is hierarchically organized into boxes and/or tab boxes. A UI architecture must support the following methods to setup this hierarchy : openTabBox(const char label) openHorizontalBox(const char label) openVerticalBox(const char label) closeBox(const char label) Note that all the widgets are added to the current box.
| UI | Comment |
| console | a textual command line UI |
| GTKUI | a GTK-based GUI |
| QTGUI | a multi-platform QT-based GUI |
| FUI | a file-based UI to store and recall modules states |
| OSCUI | OSC control (see section osc) |
| httpdUI | HTTP control (see section http) |
| ... | ... |
Metadata
The Faust language allows widget labels to contain metadata enclosed in square brackets as key/value pairs. These metadata are handled at GUI level by a declare method taking as argument, a pointer to the widget associated zone, the metadata key and value: declare(FAUSTFLOAT zone, const char key, const char* value)
Here is the table of currently supported general medatada (look at section osc for OSC specific metadata and section midi for MIDI specific metadata):
Some typical example where several metadata are defined could be:
nentry("freq [unit:Hz][scale:log][acc:0 0 -30 0 30][style:menu{\'white noise\':0;\'pink noise\':1;\'sine\':2][hidden:0]", 0, 20, 100, 1)}
or:
vslider("freq [unit:dB][style:knob][gyr:0 0 -30 0 30]", 0, 20, 100, 1)
Note that medatada are not supported in all architecture files. Some of them like (acc or gyr for exemple) only make sense on platforms with accelerometers or gyroscopes sensors. The set of medatada may be extended in the future.
Developing a new architecture file
Developing a new architecture file typically means writing a generic C++ file, that will be populated with the actual output of the Faust compiler, in order to produce a complete C++ file, ready to be compiled as a standalone application or plugin.
The architecture to be used is specified at compile time with the -a option. It must contain the <
Look at the minimal.cpp example located in the architecture folder:
#include "faust/gui/PrintUI.h"
#include "faust/gui/meta.h"
#include "faust/audio/dummy-audio.h"
using std::max;
using std::min;
//-------------------------------------------------
// FAUST generated signal processor
//-------------------------------------------------
<<includeIntrinsic>>
<<includeclass>>
int main(int argc, char *argv[])
{
mydsp DSP;
PrintUI ui;
// Activate the UI
// (here that only prints the control paths)
DSP.buildUserInterface(&ui);
// Allocate the audio driver to render
// 5 buffers of 512 frames
dummyaudio audio(5);
audio.init("Test", &DSP);
// Render buffers...
audio.start();
audio.stop();
Calling faust -a minimal.cpp noise.dsp -a noise.cpp will produce a ready to compile noise.cpp file:
#include "faust/gui/PrintUI.h"
#include "faust/gui/meta.h"
#include "faust/audio/dummy-audio.h"
using std::max;
using std::min;
//---------------------------------------------------
// FAUST generated signal processor
//--------------------------------------------------
#ifndef FAUSTFLOAT
#define FAUSTFLOAT float
#endif
#ifndef FAUSTCLASS
#define FAUSTCLASS mydsp
#endif
class mydsp : public dsp {
private:
FAUSTFLOAT fslider0;
int iRec0[2];
int fSamplingFreq;
public:
virtual void metadata(Meta* m) {
m->declare("name", "Noise");
m->declare("version", "1.1");
m->declare("author", "Grame");
m->declare("license", "BSD");
m->declare("copyright", "(c)GRAME 2009");
}
virtual int getNumInputs() { return 0; }
virtual int getNumOutputs() { return 1; }
static void classInit(int samplingFreq) {
}
virtual void instanceConstants(int samplingFreq) {
fSamplingFreq = samplingFreq;
}
virtual void instanceResetUserInterface() {
fslider0 = 0.5f;
}
virtual void instanceClear() {
for (int i=0; i<2; i++) iRec0[i] = 0;
}
virtual void init(int samplingFreq) {
classInit(samplingFreq);
instanceInit(samplingFreq);
}
virtual void instanceInit(int samplingFreq) {
instanceConstants(samplingFreq);
instanceResetUserInterface();
instanceClear();
}
virtual mydsp* clone() {
return new mydsp();
}
virtual int getSampleRate() {
return fSamplingFreq;
}
virtual void buildUserInterface(UI* ui_interface) {
ui_interface->openVerticalBox("Noise");
ui_interface->declare(&fslider0, "acc", "0 0 -10 0 10");
ui_interface->declare(&fslider0, "style", "knob");
ui_interface->addVerticalSlider("Volume", &fslider0, 0.5f, 0.0f, 1.0f, 0.1f);
ui_interface->closeBox();
}
virtual void compute (int count, FAUSTFLOAT** input, FAUSTFLOAT** output) {
float fSlow0 = (4.656613e-10f * float(fslider0));
FAUSTFLOAT* output0 = output[0];
for (int i=0; i<count; i++) {
iRec0[0] = ((1103515245 * iRec0[1]) + 12345);
output0[i] = (FAUSTFLOAT)(fSlow0 * iRec0[0]);
// post processing
iRec0[1] = iRec0[0];
}
}
};
int main(int argc, char* argv[])
{
mydsp DSP;
PrintUI ui;
// Activate the UI
// (here that only prints the control paths)
DSP.buildUserInterface(&ui);
// Allocate the audio driver to render
// 5 buffers of 512 frames
dummyaudio audio(5);
audio.init("Test", &DSP);
// Render buffers...
audio.start();
audio.stop();
You can possibly add the -i option to actually inline all #include "faust/xxx/yyy" headers (all files starting with "faust"). Then you will have to write a faust2xxx script that will chain the Faust compilation step and the C++ compilation one. Look at scripts in the tools/faust2appls folder for real examples.
Developing the adapted C++ file may require "aggregating" the generated mydsp class (subclass of dsp base class defined in faust/dsp/dsp.h header) in your specific class, or "subclassing" and extend it. So you will have to write something like:
class my_class : public base_interface {
private:
mydsp fDSP;
public:
my_class()
{
// Do something specific
}
virtual ~my_class()
{
// Do something specific
}
// Do something specific
void my_compute(int count,
FAUSTFLOAT** inputs,
FAUSTFLOAT** outputs,....)
{
// Do something specific
fDSP.compute(count, inputs, outputs);
}
// Do something specific
};
or:
class my_class : public mydsp {
private:
// Do something specific
public:
my_class()
{
// Do something specific
}
virtual ~my_class()
{
// Do something specific
}
// Do something specific
void my_compute(int count,
FAUSTFLOAT** inputs,
FAUSTFLOAT** outputs,....)
{
// Do something specific
compute(count, inputs, outputs);
}
// Do something specific
};
This way your architecture file will be adapted to any "shape" of the generated code. That is, depending if you generate purely scalar, or vector code (using the -vec option), or any other option, the generated mydsp class will always be correctly inserted in the final C++ file. Look for instance at csound.cpp and unity.cpp architecture files in the architecture folder for real examples.


| Name | Alternate Alias | Superpower | Known For | Image |
|---|---|---|---|---|
| Matter-Eater Lad | Tenzil Kem | Able to eat matter in all forms | Rebelling against his home planet's virtual enslavement of him as a senator by becoming a multimedia celebrity, using his planet's tax money to finance multiple television shows that allow him to leave his planet for trips to Earth and other planets for adventure and fun. I did not make this up. |
|
| Arm-Fall-Off Boy | Floyd Belkin | Removes limbs and uses them as clubs | Being denied acceptance to the Legion of Superheroes, and subsequently falling apart | |
| Heckler | Stuart "Stu" Moseley | Sarcastic wit and the ability to annoy anyone. | When he is not heckling, Stuart owns and runs a diner called Eats in the slums of Delta City. | |
| Danny The Street | None, he is just a living street | A living sentient piece of urban geography who can magially and seamlessly place himself in any urban landscape. Basically, he teleports his mind from one geological location to another. | His name is a pun on female impersonator Danny La Rue ('La Rue' meaning the street in French.) | |
| Mogo | None, it's(?) a planet. No, really | He has willpower. | A member of the Green Lantern Corps, Mogo is responsible for bringing green lantern rings to their new host after the prior host dies. | |
| Red Bee | Richard Raleigh, Jenna Raleigh | Richard did not have any superpowers, but carried a 'stinger gun'. Jenna posessed a human/insect biology which granted her enhanced srength and the ability to mark people for later tracking. | The character only became popular when re-appearing in the DC Comic 'All-star Squadron, where Richard Raleigh was killed by Baron Blizkreig. | |
| Vext | Patron Deity of Mishap and Misfortune | A god who causes misfortune and bad luck to others but has no control over this ability. | Being banashed to Earth after him and other gods were no longer worshipped. He ended up renting a room in the same building as The Heckler. | |
| Stone Boy | Dag Wentim | Ability to turn his body into stone, making him indestructible and...unable to move. | Being rejected by the Legion of Superheroes when his powers were dubbed 'too static' |


| # | Operation | Action |
|---|---|---|
| 1 | Create Instructor | + Create Instructor |
| 2 | attendance xls sheet by course ID | |
| 3 | Create attendance xls sheet by course ID and date |
| # | Operation | Action |
|---|---|---|
| 1 | Create Instructor | + Create Instructor |
| 2 | attendance xls sheet by course ID | |
| 3 | Create attendance xls sheet by course ID and date |


Some things about me...
Path I took at Red's Electric first tunred me onto programming. I started out writing simple functions in Microsoft Excel, quickly reached the limit of what I could do with Excel and decided to make the leap and have Epicodus teach me more so I could make a carreer out of programming.
Programming, Roman History, and discovering/mastering new and effective communication techniques.
Playing old video games from my youth on rare occasions, catching up with my friends, currently trying to improve hand writing so the couple pen pansl I have will have a better time reading my letters.


Select time and date the timer should be triggered on.Empty means any.
Select the days the timer should be triggered on.Empty means any day.


Pandemonium
Offer your whole self to the chaotic forces. Submerge your conscience in darkness. Allow it to increase your damage tremendously, but only for a mere moment.
^a${value} Second(s) Recharge
35
${value} Energy Cost
100 118 136 155 173 191 209 227 245 264 282 300
${value} Second Duration
3
+${value}% Total Damage
100 118 136 155 173 191 209 227 245 264 282 300
MaxLevel
8
UltimateLevel
12


navigator.geolocation.getCurrentPosition(
position => {
console.log(position);
console.log(position.coords.latitude);
console.log(position.coords.longitude);
console.log(position.coords.accuracy);
},
error => {
console.log(error);
switch(error.code) {
case 0: // unknown error
console.log('The application has encountered an unknown error while trying to determine location.');
break;
case 1: // permission denied
console.log('You chose not to allow this application access to your location.');
break;
case 2: // position unavailable
console.log('The application was unable to determine your location.');
break;
case 3: // timeout
console.log('The request to determine your location has timed out.');
break;
}
}
);